| MIL 10 Reference
| Customize Help
| Save Settings

MpatSetSpeed



See also
Availability
Not available in MIL-Lite
Available in MIL

Available on Windows
Available on Linux

Available on Non-Matrox computer
Available on Matrox 4Sight-X
Available on Matrox 4Sight GP
Available on Matrox Supersight
function map Function map
Examples
Synopsis
Set search speed of a model.
Syntax
void MpatSetSpeed(
MIL_ID ModelId, //in
MIL_INT64 SpeedFactor //in
)
Description

This function specifies the required search speed when using MpatFindModel() or MpatFindMultipleModel(). At a higher speed, the search takes all reasonable short cuts; therefore, the search should be performed faster than at lower settings. Generally, the high speed setting should be used for better quality images or when using a simple model. Note, the high speed setting reduces positional accuracy very slightly. Try the low speed settings only if your image quality is particularly poor and you have encountered problems at higher speeds. Also, whenever the search speed parameter setting of a model changes, the effect of any preprocessing of the model is undone. Therefore, if the search speed is changed, call MpatPreprocModel() before searching for the model.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see if there is complementary information.
Parameters
This function is not supported on the selected boards.
Parameters
ModelId

Specifies the identifier of the model for which to change the speed parameter.

SpeedFactor INQ

Specifies the search speed. Set this parameter to one of the values below.

function map For specifying the search speed
CollapseValue Description
Collapse M_HIGH

Specifies a high search speed.

Collapse M_LOW

Specifies a low search speed.

Collapse M_MEDIUM

Specifies a medium search speed.

This is the default value.

(summarize)
Collapse M_VERY_HIGH

Specifies a very high search speed.

Collapse M_VERY_LOW

Specifies a very low search speed.

Compilation information
Header Include mil.h.
Library Use mil.lib; milpat.lib.
DLL Requires mil.dll; milpat.dll.
HIGH LOW MEDIUM VERY HIGH VERY LOW