MmodControl

Filters
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/GPm

Available on Matrox Supersight

Function map

Examples

Function Map

- Index

Table:

For specifying a context, model, or result buffer

- ControlType

- ControlValue

Parameter Associations

Table:	For the context and models
Table:	For the context
Table:	For one or all models
Table:	For a result buffer

Type specific versions of the function when using a C compiler under 64-bit

Compilation information

Synopsis

Control a Model Finder context, individual model setting, or Model Finder result buffer setting.

Syntax

void MmodControl(

MIL_ID ContextOrResultId,	//in
MIL_INT Index,	//in
MIL_INT64 ControlType,	//in
MIL_DOUBLE ControlValue	//in

)

Description

This function allows you to control a setting of a Model Finder context, one (or all) of the models contained therein, or a Model Finder result buffer. These settings control the execution of MmodFind() operations. Most of the control type settings can be inquired using MmodInquire().

In general, any value that you provide to the MIL Model Finder module (for example, position and width) must be specified in the pixel coordinate system, even if the target is calibrated. The only exception is when specifying angles (for example, M_REFERENCE_ANGLE); in these cases, you must specify the angles in the relative coordinate system if the target is calibrated.

Changing certain control type settings might require preprocessing of the Model Finder context again, using MmodPreprocess(). To know if the Model Finder context needs to be preprocessed, call MmodInquire() with the M_PREPROCESSED inquire type.

You can automatically define an image-type model that is based on specified control settings using this function with M_AUTO_DEFINE. To have specified settings taken into account during model definition, you must allocate an empty image-type model using MmodDefine() with M_AUTO_DEFINE, set the appropriate control types using MmodControl(), and then call MmodControl() with M_AUTO_DEFINE. M_AUTO_DEFINE defines a unique model by searching the model source image for unique geometric features that match the settings specified using MmodControl(). When the most suitable geometric features are found, the function automatically defines a model from those features. If none are found, no model is allocated and an error is reported. It can take several seconds to find the best model (or more for large or small images). To be useful, the model source image should be a typical target image; otherwise, the selected area for the model might never be present in the target image. For more information on defining an image-type model automatically, see the Image-type models subsection of the Defining and adding models to your Model Finder context section of Chapter 8: Geometric Model Finder.

Note that when using a C compiler (not a C++ or other compiler) in 64-bit mode, MmodControl() internally calls the MIL_DOUBLE version of this function (MmodControlDouble()). If you need to pass integer values, call the MIL_INT64 version of this function (MmodControlInt64()).

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

ContextOrResultId

Specifies the Model Finder context or Model Finder result buffer whose settings you want to modify. The Model Finder context or result buffer must have been previously allocated on the system using MmodAlloc() or MmodAllocResult(), respectively.

Index

Specifies that the Model Finder context, an individual model, or a Model Finder result buffer is controlled. Set this parameter to one of the following values:

For specifying a context, model, or result buffer
Value	Description
M_DEFAULT	Specifies the default. If a Model Finder context is specified, same as M_ALL. If a Model Finder result buffer is specified, same as M_GENERAL. (summarize) Specifies the default. (more details...)
M_ALL	Applies the specified control setting to all models, if a Model Finder context is specified. All the models in the Model Finder context must support the specified control type, otherwise, an error is returned. (summarize) Applies the specified control setting to all models, if a Model Finder context is specified. (more details...)
M_CONTEXT	Controls a general setting of a specified Model Finder context, if one is specified.
M_GENERAL	Controls a general setting of a Model Finder result buffer when ContextOrResultId is a result buffer.
0 <= Value < M_NUMBER_MODELS	Specifies the index of the individual model to control, if a Model Finder context is specified. User labels cannot be used as indices; to retrieve the index of a model from its user label, use MmodInquire() with M_INDEX_FROM_LABEL. (summarize) Specifies the index of the individual model to control, if a Model Finder context is specified. (more details...)

ControlType

Specifies the setting to change.

See the Parameter associations section for possible values that can be specified.

ControlValue

Specifies the setting's new value.

All values are set in pixels, regardless of whether the model is calibrated.

See the Parameter associations section for possible values that can be specified.

Parameter associations

The tables below list possible values for the ControlType and ControlValue parameters.

For the context and models
For the context
For one or all models
For a result buffer

The following ControlType and corresponding ControlValue settings can be specified for both the Model Finder context (M_CONTEXT) and each individual model (or all models) in the Model Finder context:

For the context and models
ControlType		Description
	ControlValue	Description
M_NUMBER		Sets the number of occurrences for which to search. For M_CONTEXT, this control type sets the maximum number of all model occurrences for which to search in the target. For a model, this control type sets the maximum number of occurrences of the specified model, for which to search in the target. Once the number of occurrences for the context, with scores and target scores greater than or equal to their certainty levels, has been reached, the search will stop, regardless of whether the actual number set for any individual model has been found. To further illustrate the relationship between the M_NUMBER setting for the context and that of the individual models, see the Expected number of occurrences subsection of the Customizing search settings section of Chapter 8: Geometric Model Finder. INQ (summarize) Sets the number of occurrences for which to search. INQ (more details...)
	M_DEFAULT	Specifies the default value. For M_CONTEXT, the default is M_ALL. For a model, the default value is 1. (summarize) Specifies the default value. (more details...)
	M_ALL	Specifies to find all occurrences. For M_CONTEXT, M_ALL finds all the occurrences specified for each model in the context. For a model, M_ALL finds all the occurrences of the specified model. Note that this setting can increase the search time; always set M_NUMBER to a specific number whenever possible. (summarize) Specifies to find all occurrences. (more details...)
	Value > 0	Specifies the number of occurrences. For M_CONTEXT, this value specifies the number of occurrences, for all models within the context, to find in the target. For a model, this value specifies the maximum number of occurrences of the specified model to find in the target. (summarize) Specifies the number of occurrences. (more details...)

The following ControlType and corresponding ControlValue settings can be specified for the Model Finder context (M_CONTEXT):

For the context
ControlType		Description
	ControlValue	Description
M_ACCURACY		Sets the accuracy with which to find occurrences. The precision achieved is dependent on the quality of the model and the target. In addition, positional accuracy is slightly affected by the setting of the M_SPEED. Note that lower accuracy can speed up the MmodFind() operation. This control type is not supported for an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets the accuracy with which to find occurrences. INQ (more details...)
	M_DEFAULT	Same as M_MEDIUM.
	M_HIGH	Specifies high accuracy.
	M_LOW	Specifies low accuracy.
	M_MEDIUM	Specifies medium accuracy.
M_ACTIVE_EDGELS		Sets the degree to which MIL processes edgels in the target (MmodFind()) The target edgels that MIL processes are considered active. By limiting the active edgels in the target, you can speed up the search. To draw the active edgels in the target, use MmodDraw() with M_DRAW_ACTIVE_EDGELS. This control type is only supported for a geometric Model Finder context (MmodAlloc() with M_GEOMETRIC). INQ (summarize) Sets the degree to which MIL processes edgels in the target (MmodFind()) The target edgels that MIL processes are considered active. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 100.0%.
	0.0 <= Value <= 100.0	Specifies the degree to which MIL processes target edgels, in percent. Lower settings typically result in fewer active edgels in the target and faster searches, although accuracy can be compromised. Conversely, higher settings result in more active edgels in the target and higher accuracy, although searches can take longer. (summarize) Specifies the degree to which MIL processes target edgels, in percent. (more details...)
M_ASPECT_RATIO		Sets the aspect ratio to apply to the target before starting the search. When the target is not calibrated, this control type allows you to quickly compensate for aspect ratio distortion in the target, typically a side effect of the sampling rate used by the frame grabber. When the target is calibrated, this control type is ignored. This control type is mainly useful when dealing with synthetic models since it does not compensate for aspect ratio distortion in the model. When performing the search, the nominal search aspect ratio is taken into account horizontally, adjusting the target pixel width to equal the pixel height. As such, results will be returned for this corrected target coordinate system. However, the results are converted to the original target coordinate system if you draw them using MmodDraw(). This control type is not supported for an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets the aspect ratio to apply to the target before starting the search. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 1.0.
	0.5 <= Value <= 2.0	Specifies the pixel width/pixel height of the target.
M_DETAIL_LEVEL		Sets the level of details to extract from model images and target images during edge extraction. The detail level determines what is considered an edge/background. A higher detail level will include more edges than a lower detail level. This setting is only used when dealing with image-type models and image-type targets. INQ (summarize) Sets the level of details to extract from model images and target images during edge extraction. INQ (more details...)
	M_DEFAULT	Same as M_MEDIUM.
	M_HIGH	Specifies a high level of detail.
	M_MEDIUM	Specifies a medium level of detail.
	M_VERY_HIGH	Specifies a very high level of detail.
M_FIRST_LEVEL		Sets the resolution level for the initial stage (lowest resolution) of the search. Level 0 is the original target and each higher level is half the size (and resolution) of the previous one. If the specified level is not supported by the search algorithm, the highest possible level will be used. A higher first level speeds up the initial search but might make it less reliable because the model might not retain enough distinctive features at a lower resolution. M_FIRST_LEVEL is for advanced users of the Model Finder module. The default setting usually provides the best results for the search operation. Note that if you set a lower value for M_FIRST_LEVEL than the one assigned to M_LAST_LEVEL, MmodControl() will override your settings and automatically assign M_FIRST_LEVEL the same value as M_LAST_LEVEL. This implies that only one resolution level will be used for the search. This control type is not supported for an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets the resolution level for the initial stage (lowest resolution) of the search. INQ (more details...)
	M_DEFAULT	Same as M_AUTO.
	M_AUTO	Specifies that the first resolution is determined automatically.
	0 <= Value <= 7	Specifies the resolution level. Only integer values are accepted. (summarize) Specifies the resolution level. (more details...)
M_LAST_LEVEL		Sets the resolution level for the final stage (the highest resolution) of the search. Level 0 is the original target and each higher level is half the size (and resolution) of the previous one. If the specified level is not supported by the search algorithm, the highest possible level will be used. A higher last level speeds up the initial search but might make it less reliable and less accurate because the model might not retain enough distinctive features at a low resolution. M_LAST_LEVEL is for advanced users of the Model Finder module. The default setting usually provides the best results for the search operation. Note that if you set a higher value for M_LAST_LEVEL than the one assigned to M_FIRST_LEVEL, MmodControl() will override your settings and automatically assign M_LAST_LEVEL the same value as M_FIRST_LEVEL. This implies that only one resolution level will be used for the search. This control type is not supported for an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets the resolution level for the final stage (the highest resolution) of the search. INQ (more details...)
	M_DEFAULT	Same as M_AUTO.
	M_AUTO	Specifies that the last resolution is determined automatically.
	0 <= Value <= 7	Specifies the resolution level. Only integer values are accepted. (summarize) Specifies the resolution level. (more details...)
M_SAVE_TARGET_EDGES		Sets whether to save the target edges in the result buffer. INQ (summarize) Sets whether to save the target edges in the result buffer. INQ (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that target edges cannot be saved.
	M_ENABLE	Specifies that target edges can be saved. By enabling this value, you can retrieve target chain information with MmodGetResult() and you can draw target edges with MmodDraw(). (summarize) Specifies that target edges can be saved. (more details...)
M_SEARCH_ANGLE_RANGE		Sets whether to perform calculations specific to angular-range search strategies. Typically, to search for models within their specified angular range (M_ANGLE- M_ANGLE_DELTA_NEG to M_ANGLE + M_ANGLE_DELTA_POS) in the target, calculations specific to angular-range search strategies should be enabled for the context. These calculations are not required to search for models at their nominal angle (M_ANGLE). In addition, if you expect that the occurrences sought are close to their model's nominal angle, you can try disabling these calculations to see if Model Finder can still find the required occurrences. Disabling these calculations might speed up the search depending on the model and the target. Note that M_SEARCH_ANGLE_RANGE must be enabled to search for rotation-invariant non-synthetic models (for example, an image-type model of a circle). Also note that candidates can only be returned as occurrences if found within the angular range specified for their model. Therefore, whether you enable or disable the calculation, you can restrict which candidates are returned as occurrences by narrowing the angular range. This control type is not supported for an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets whether to perform calculations specific to angular-range search strategies. INQ (more details...)
	M_DEFAULT	Specifies the default value. The default is the same as M_ENABLE if the Model Finder context uses a general geometric search algorithm. The default is the same as M_DISABLE if the Model Finder context uses a controlled geometric search algorithm. (summarize) Specifies the default value. (more details...)
	M_DISABLE	Specifies that calculations specific to angular-range search strategies are disabled.
	M_ENABLE	Specifies that calculations specific to angular-range search strategies are enabled.
M_SEARCH_POSITION_RANGE		Sets whether to perform calculations specific to position-range search strategies. Typically, to search for models within their specified position range (M_POSITION_X, M_POSITION_Y, M_POSITION_DELTA_NEG_X, M_POSITION_DELTA_POS_X, M_POSITION_DELTA_NEG_Y, M_POSITION_DELTA_POS_Y) in the target, calculations specific to position-range search strategies should be enabled for the context. These calculations are not required to search for models at their nominal position (M_POSITION_X and M_POSITION_Y). In addition, if you expect that the occurrences sought are close to their model's nominal position, you can try disabling these calculations to see if Model Finder can still find the required occurrences. Disabling these calculations might speed up the search depending on the model and the target. Note that candidates can only be returned as occurrences if found within the position range specified for their model. Therefore, whether you enable or disable the calculations, you can restrict which candidates are returned as occurrences by narrowing the position range. Finally, if these calculations are disabled and no nominal position is specified (M_POSITION_X and M_POSITION_Y set to M_ALL), no occurrences will be found and no errors will be returned. This control type is not supported for an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets whether to perform calculations specific to position-range search strategies. INQ (more details...)
	M_DEFAULT	Same as M_ENABLE.
	M_DISABLE	Specifies that calculations specific to position-range search strategies are disabled.
	M_ENABLE	Specifies that calculations specific to position-range search strategies are enabled.
M_SEARCH_SCALE_RANGE		Sets whether to perform calculations specific to scale-range search strategies. Typically, to search for models within their specified scale range (M_SCALE x M_SCALE_MIN_FACTOR) to (M_SCALE x M_SCALE_MAX_FACTOR) in the target, calculations specific to scale-range search strategies should be enabled for the context. These calculations are not required to search for models at their nominal scale (M_SCALE). In addition, if you expect that the occurrences sought are close to their model's nominal scale, you can try disabling these calculations to see if Model Finder can still find the required occurrences. Disabling these calculations might speed up the search depending on the model and the target. Note that candidates can only be returned as occurrences if found within the scale range specified for their model. Therefore, whether you enable or disable the calculation, you can restrict which candidates are returned as occurrences by narrowing the scale range. You can only use M_SEARCH_SCALE_RANGE with a geometric Model Finder context (MmodAlloc() with M_GEOMETRIC). This control type is not supported for an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets whether to perform calculations specific to scale-range search strategies. INQ (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that calculations specific to scale-range search strategies are disabled.
	M_ENABLE	Specifies that calculations specific to scale-range search strategies are enabled. Note that when these calculations are enabled, limiting the scale range to the minimum required generally decreases the search time. (summarize) Specifies that calculations specific to scale-range search strategies are enabled. (more details...)
M_SHARED_EDGES		Sets whether to enable sharing of edges between occurrences. This control type is not supported for an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets whether to enable sharing of edges between occurrences. INQ (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies to disable the sharing of edges. When disabled, edges that are part of more than one occurrence are considered as part of the occurrence with the greatest score only. (summarize) Specifies to disable the sharing of edges. (more details...)
	M_ENABLE	Specifies to enable the sharing of edges.
M_SMOOTHNESS		Sets the degree of smoothness (noise reduction) applied to the model images and target images during the edge extraction. This setting is only used when dealing with image-type models or using image-type targets. INQ (summarize) Sets the degree of smoothness (noise reduction) applied to the model images and target images during the edge extraction. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 50.0.
	0.0 <= Value <= 100.0	Specifies the smoothness value applied to the images. A setting of 0.0 indicates almost no noise reduction effect, while a setting of 100.0 indicates a very strong noise reduction effect. (summarize) Specifies the smoothness value applied to the images. (more details...)
M_SPEED		Sets the algorithm's search speed. Note that increasing the search speed can decrease the robustness and subpixel accuracy of the MmodFind() operation. This control type is not supported for an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets the algorithm's search speed. INQ (more details...)
	M_DEFAULT	Same as M_MEDIUM.
	M_HIGH	Specifies a high speed.
	M_LOW	Specifies a low speed.
	M_MEDIUM	Specifies a medium speed.
	M_VERY_HIGH	Specifies a very high speed.
M_STOP_FIND		Stops the current MmodFind() operation. You must call MmodControl() with M_STOP_FIND from another thread (typically of higher priority). The number of occurrences found at that point will be returned. (summarize) Stops the current MmodFind() operation. (more details...)
	M_DEFAULT	Implements the default behavior.
M_TARGET_CACHING		Sets whether target caching is enabled. When target caching is enabled, the geometric representation of the target, generated by MmodFind(), is kept in the result. Subsequent calls to MmodFind() can reuse the representation, if they use the same result buffer and target. This increases the speed of the searches. Note that the geometric representation generated with a given Model Finder context might not be compatible with another context. In such a case, the cache will not be used. Also note that this constant cannot be set to M_ENABLE if the Model Finder context is set to M_GEOMETRIC_CONTROLLED. This control type is not supported for an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets whether target caching is enabled. INQ (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies to disable target caching. Each call to MmodFind() will generate the geometric representation of the target. (summarize) Specifies to disable target caching. (more details...)
	M_ENABLE	Specifies to enable target caching in the result.
M_TIMEOUT		Sets the maximum search time for MmodFind(), in msec. If a search times out, the number of occurrences found at that point will be returned. INQ (summarize) Sets the maximum search time for MmodFind(), in msec. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 2000.0 msec.
	M_DISABLE	Specifies an infinite amount of search time.
	Value >= 0	Specifies the maximum search time, in msecs.

The following ControlType and corresponding ControlValue settings can be specified for each individual model or all models in the Model Finder context:

For one or all models
ControlType		Description
	ControlValue	Description
M_ACCEPTANCE		Sets the acceptance level for the score. An occurrence will be returned only if the match score between the target and the model is greater than or equal to this level. The score is a measure, as a percentage, of the presence and fit of the model's active edges in the occurrence. Using M_FIT_ERROR_WEIGHTING_FACTOR, you can specify how much the fit influences the score. INQ (summarize) Sets the acceptance level for the score. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 60.0%.
	0.0 <= Value <= 100.0	Specifies an acceptable score, in percent. 100% indicates that for every active edge in the model, a corresponding edge must be found in the occurrence with a perfect fit (generally hard to obtain). (summarize) Specifies an acceptable score, in percent. (more details...)
M_ACCEPTANCE_TARGET		Sets the acceptance level for the target score. An occurrence will be returned only if the target score between the target and the model is greater than or equal to this level. The target score is a measure, as a percentage, of edges found in the occurrence that are not found in the original model, weighted by the deviation in position of the common edges. Using M_FIT_ERROR_WEIGHTING_FACTOR, you can specify how much the fit influences the target score. This control type is not supported for a model defined with an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets the acceptance level for the target score. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.0%.
	0.0 <= Value <= 100.0	Specifies an acceptable target score, in percent. At 0.0%, any number of extra edges is tolerated (100% allows for no extra edges in the occurrence and the occurrence must have a perfect fit). (summarize) Specifies an acceptable target score, in percent. (more details...)
M_ANGLE		Sets the nominal search angle; this is the angle at which you expect to find the model's reference axis (specified using M_REFERENCE_ANGLE) in the target. For an ellipse model defined in an M_SHAPE_ELLIPSE type of Model Finder context, the model's reference axis is, by default, aligned with its principle axis (its width). This control type is not supported for a model defined in an M_SHAPE_CIRCLE type of Model Finder context. INQ (summarize) Sets the nominal search angle; this is the angle at which you expect to find the model's reference axis (specified using M_REFERENCE_ANGLE) in the target. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.0°.
	0.0 <= Value <= 360.0	Specifies the nominal search angle, in degrees. If the Model Finder operation is performed on a calibrated target, you must specify the angle with respect to the relative coordinate system of the target. (summarize) Specifies the nominal search angle, in degrees. (more details...)
M_ANGLE_DELTA_NEG		Sets the lower limit of the angular range, relative to the nominal search angle (M_ANGLE). Occurrences with angles outside the angular-range cannot be returned as results. Note that typically, to search for model occurrences within the angular range, calculations specific to angular-range search strategies should be enabled (M_SEARCH_ANGLE_RANGE) for the context. When enabled, the angular range should be used to cover an expected variance in angle. Note that the actual angle of the occurrence does not affect search speed. If you need to search for a model at discrete angles only (for example, at intervals of 90 degrees), it is typically more efficient to define several models with different expected angles, than to search through the full angular range. This control type is not supported for a model defined in an M_SHAPE_CIRCLE type of Model Finder context. INQ (summarize) Sets the lower limit of the angular range, relative to the nominal search angle (M_ANGLE). INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 180.0°.
	0.0 <= Value <= 180.0	Specifies the lower limit of the angular range, in degrees. If the Model Finder operation is performed on a calibrated target, you must specify the angle in the relative coordinate system of the target. (summarize) Specifies the lower limit of the angular range, in degrees. (more details...)
M_ANGLE_DELTA_POS		Sets the upper limit of the angular range, relative to the nominal search angle (M_ANGLE). Occurrences with angles outside the angular-range cannot be returned as results. Note that typically, to search for model occurrences within the angular range, calculations specific to angular-range search strategies should be enabled (M_SEARCH_ANGLE_RANGE) for the context. When enabled, the angular range should be used to cover an expected variance in angle. Note that the actual angle of the occurrence does not affect search speed. If you need to search for a model at discrete angles only (for example, at intervals of 90 degrees), it is typically more efficient to define several models with different expected angles, than to search through the full angular range. This control type is not supported for a model defined in an M_SHAPE_CIRCLE type of Model Finder context. INQ (summarize) Sets the upper limit of the angular range, relative to the nominal search angle (M_ANGLE). INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 180.0°.
	0.0 <= Value <= 180.0	Specifies the upper limit of the angular range, in degrees. If the Model Finder operation is performed on a calibrated target, you must specify the angle in the relative coordinate system of the target. (summarize) Specifies the upper limit of the angular range, in degrees. (more details...)
M_ASSOCIATED_CALIBRATION		Associates the specified camera calibration context with the specified model. Note that if you do not save, with the Model Finder context, the camera calibration contexts associated with the models (MmodSave() or MmodStream() with M_WITH_CALIBRATION), you must re-associate each model with its camera calibration context after restoring the context (MmodRestore(), or MmodStream()). In addition, for a synthetic model, you should use M_ASSOCIATED_CALIBRATION to associate the camera calibration context of a calibrated target with the model. Note that the camera calibration contexts associated with synthetic models are not saved or restored by MmodSave(), MmodRestore() or MmodStream(). This control type is not supported for a model defined with an M_SHAPE_... type of Model Finder context. INQ (summarize) Associates the specified camera calibration context with the specified model. INQ (more details...)
	M_DEFAULT	Same as M_NULL.
	M_NULL	Removes the association between the model and a camera calibration context.
	MIL Calibration context identifier	Specifies the camera calibration context to associate with the model.
M_AUTO_DEFINE		Defines a unique model from a source image, automatically. This control type is only supported for models of type M_AUTO_DEFINE. (summarize) Defines a unique model from a source image, automatically. (more details...)
	Source image identifier	Specifies the identifier of the image buffer (model source image) from which to extract the model. The image buffer must be a 1-band 8-bit unsigned buffer. (summarize) Specifies the identifier of the image buffer (model source image) from which to extract the model. (more details...)
M_BOX_MARGIN_BOTTOM		Sets a margin at the bottom of the bounding box of the model's active edges. The bounding box of the model's active edges plus the specified margins define the size of the model box. The model box is used to compute the target score and to set the different masks of the model. If you change this value, all of this model's previous masks are discarded, since their size is no longer valid. M_BOX_MARGIN_BOTTOM is only available for synthetic models. This control type is not supported for a model defined with an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets a margin at the bottom of the bounding box of the model's active edges. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 10.0% of the height of the bounding box of the model's active edges.
	Value >= 0.0	Specifies the margin, in the user-defined units for the model.
M_BOX_MARGIN_LEFT		Sets a margin at the left side of the bounding box of the model's active edges. The bounding box of the model's active edges plus the specified margins define the size of the model box. The model box is used to compute the target score and to set the different masks of the model. If you change this value, all of this model's previous masks are discarded, since their size is no longer valid. M_BOX_MARGIN_LEFT is only available for synthetic models. This control type is not supported for a model defined with an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets a margin at the left side of the bounding box of the model's active edges. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 10.0% of the width of the bounding box of the model's active edges.
	Value >= 0.0	Specifies the margin, in the user-defined units for the model.
M_BOX_MARGIN_RIGHT		Sets a margin at the right side of the bounding box of the model's active edges. The bounding box of the model's active edges plus the specified margins define the size of the model box. The model box is used to compute the target score and to set the different masks of the model. If you change this value, all of this model's previous masks are discarded, since their size is no longer valid. M_BOX_MARGIN_RIGHT is only available for synthetic models. This control type is not supported for a model defined with an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets a margin at the right side of the bounding box of the model's active edges. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 10.0% of the width of the bounding box of the model's active edges.
	Value >= 0.0	Specifies the margin, in the user-defined units for the model.
M_BOX_MARGIN_TOP		Sets a margin at the top of the bounding box of the model's active edges. The bounding box of the model's active edges plus the specified margins define the size of the model box. The model box is used to compute the target score and to set the different masks of the model. If you change this value, all of this model's previous masks are discarded, since their size is no longer valid. M_BOX_MARGIN_TOP is only available for synthetic models. This control type is not supported for a model defined with an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets a margin at the top of the bounding box of the model's active edges. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 10.0% of the height of the bounding box of the model's active edges.
	Value >= 0.0	Specifies the margin, in the user-defined units for the model.
M_CAD_Y_AXIS		Sets the direction of the Y-axis for a model of type M_DXF_FILE. When the model is added to the Model Finder context from a CAD DXF file, the model will retain its coordinate system (the origin and the axis). Most CAD DXF files are oriented so that the Y-axis is positive going up, whereas the coordinate system MIL uses is oriented with the Y-axis positive going down. So if you take the edge coordinates of an object from a CAD DXF file and put them in an image, the imaged object will look flipped when compared to the original object. This is also the case for a model defined from a CAD DXF file. This means that, unless the object is symmetrical, the match will not be made. This control type is not supported for a model defined with an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets the direction of the Y-axis for a model of type M_DXF_FILE. INQ (more details...)
	M_DEFAULT	Specifies the default value. The default value is M_FLIP for a model of type M_DXF_FILE. If the model is not of type M_DXF_FILE, this control type must remain set to M_DEFAULT, otherwise an error is generated. (summarize) Specifies the default value. (more details...)
	M_FLIP	Specifies to flip the Y-axis for the model so that the Y-axis is positive going down.
	M_NO_FLIP	Specifies not to flip the Y-axis for the model.
M_CERTAINTY		Sets the certainty level for the score, as a percentage. If both the score and target scores are greater than or equal to their respective certainty levels, the occurrence is considered a match, without searching the rest of the target for better matches (provided the specified number of occurrences has been found). INQ (summarize) Sets the certainty level for the score, as a percentage. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 90.0%.
	0.0 <= Value <= 100.0	Specifies the certainty level for the score, in percent. If you set the certainty level too high (close to 100.0%), you slow down the search because you force the search algorithm to check the whole position range for the best possible match(es). A good certainty level is slightly lower than the expected score, so that the search can finish as soon as a match is found. However, if you set the certainty level too low, false matches might be found. (summarize) Specifies the certainty level for the score, in percent. (more details...)
M_CERTAINTY_TARGET		Sets the certainty level for the target score. If both the score and target scores are greater than or equal to their respective certainty levels, the occurrence is considered a match, without searching the rest of the target for better matches (provided the specified number of occurrences has been found). This control type is not supported for a model defined with an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets the certainty level for the target score. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.0%.
	0.0 <= Value <= 100.0	Specifies the certainty level for the target score, in percent. See the possible values of M_CERTAINTY for more details. (summarize) Specifies the certainty level for the target score, in percent. (more details...)
M_CORNER_RADIUS		Sets the radius used to round all the corners of predefined-shaped models that have corners. This control type is only valid for models of type M_RECTANGLE, M_SQUARE, M_DIAMOND, M_TRIANGLE, and M_CROSS. Attempting to use this value for any other model type will generate an error. INQ (summarize) Sets the radius used to round all the corners of predefined-shaped models that have corners. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.0.
	Value >= 0.0	Specifies the radius, in the user-defined units for the model. If you set the radius to 0.0, there will be no rounding. (summarize) Specifies the radius, in the user-defined units for the model. (more details...)
M_COVERAGE_MAX		Specifies the maximum expected model coverage. This control type is only supported for a model defined in an M_SHAPE_... type of Model Finder context. INQ (summarize) Specifies the maximum expected model coverage. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 100.0.
	0.0 <= Value <= 100.0	Specifies the maximum expected model coverage.
M_FIT_ERROR_WEIGHTING_FACTOR		Sets the fit error weighting factor. This factor determines the contribution of the fit error in the score and target score calculation. INQ (summarize) Sets the fit error weighting factor. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 25.0%.
	0.0 <= Value <= 100.0	Specifies the fit error weighting factor, in percent. The higher the percentage, the greater the contribution of the fit error in determining the score and target score. (summarize) Specifies the fit error weighting factor, in percent. (more details...)
M_FIT_SCORE_MIN		Sets the minimum expected occurrence fit score. This control type is only supported for a model defined in an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets the minimum expected occurrence fit score. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.0.
	0.0 <= Value <= 100.0	Specifies the minimum expected occurrence fit score.
M_MIN_SEPARATION_ANGLE		Sets the minimum angular separation required for two occurrences to be considered two distinct matches (two separate occurrences). Note, only one of the separation criteria needs to be met for occurrences to be considered distinct. DISTINCT OCCURRENCE = (Separation in X) OR (Separation in Y) OR (Separation in Angle) OR (Separation in Scale) OR (Separation in Aspect Ratio). This control type is not supported for a model defined in an M_SHAPE_CIRCLE type of Model Finder context. INQ (summarize) Sets the minimum angular separation required for two occurrences to be considered two distinct matches (two separate occurrences). INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 10.0 degrees.
	M_DISABLE	Disables the minimum angle separation criteria. When disabled (M_DISABLE), the angle is not a factor when determining if occurrences are distinct. (summarize) Disables the minimum angle separation criteria. (more details...)
	0.0 < Value <= 180.0	Specifies the minimum angular separation required, in degrees. This value is specified as an absolute angle value. If the Model Finder operation is performed on a calibrated target, you must specify the angle in the relative coordinate system of the target. (summarize) Specifies the minimum angular separation required, in degrees. (more details...)
M_MIN_SEPARATION_ASPECT_RATIO		Specifies the minimum separation required in aspect ratios for two occurrences to be considered distinct matches. This value is specified as an aspect ratio factor. Note, only one of the separation criteria needs to be met for occurrences to be considered distinct. DISTINCT OCCURRENCE = (Separation in X) OR (Separation in Y) OR (Separation in Angle) OR (Separation in Scale) OR (Separation in Aspect Ratio). This control type is only supported for a model in an M_SHAPE_ELLIPSE type of Model Finder context. INQ (summarize) Specifies the minimum separation required in aspect ratios for two occurrences to be considered distinct matches. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 1.1.
	M_DISABLE	Specifies to disable the minimum aspect ratio separation criteria. When disabled, the aspect ratio is not a factor when determining if occurrences are distinct. (summarize) Specifies to disable the minimum aspect ratio separation criteria. (more details...)
	1.0 < Value <= 4.0	Specifies the criteria for minimum separation of aspect ratios.
M_MIN_SEPARATION_SCALE		Sets the minimum separation required in scale for two occurrences to be considered distinct matches (two separate occurrences). This value is specified as a scale factor. Note, only one of the separation criteria needs to be met for occurrences to be considered distinct. DISTINCT OCCURRENCE = (Separation in X) OR (Separation in Y) OR (Separation in Angle) OR (Separation in Scale) OR (Separation in Aspect Ratio). INQ (summarize) Sets the minimum separation required in scale for two occurrences to be considered distinct matches (two separate occurrences). INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 1.1.
	M_DISABLE	Specifies to disable the minimum scale separation criteria. When disabled, the scale is not a factor when determining if occurrences are distinct. (summarize) Specifies to disable the minimum scale separation criteria. (more details...)
	1.0 < Value <= 4.0	Specifies the criteria for minimum separation in scale.
M_MIN_SEPARATION_X		Sets the minimum separation required along the X-axis for two occurrences to be considered distinct matches (two separate occurrences). Note, only one of the separation criteria needs to be met for occurrences to be considered distinct. DISTINCT OCCURRENCE = (Separation in X) OR (Separation in Y) OR (Separation in Angle) OR (Separation in Scale) OR (Separation in Aspect Ratio). INQ (summarize) Sets the minimum separation required along the X-axis for two occurrences to be considered distinct matches (two separate occurrences). INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 10.0%.
	M_DISABLE	Specifies to disable the minimum separation in X criteria. When disabled, separation along the X-axis is not a factor when determining if occurrences are distinct. (summarize) Specifies to disable the minimum separation in X criteria. (more details...)
	Value	Specifies the minimum separation as a percentage of the model's width at M_SCALE. This value can be greater than 100%. (summarize) Specifies the minimum separation as a percentage of the model's width at M_SCALE. (more details...)
M_MIN_SEPARATION_Y		Sets the minimum separation required along the Y-axis for two occurrences to be considered distinct matches (two separate occurrences). Note, only one of the separation criteria needs to be met for occurrences to be considered distinct. DISTINCT OCCURRENCE = (Separation in X) OR (Separation in Y) OR (Separation in Angle) OR (Separation in Scale) OR (Separation in Aspect Ratio). INQ (summarize) Sets the minimum separation required along the Y-axis for two occurrences to be considered distinct matches (two separate occurrences). INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 10.0%.
	M_DISABLE	Specifies to disable the minimum separation in Y criteria. When disabled, separation along the Y-axis is not a factor when determining if occurrences are distinct. (summarize) Specifies to disable the minimum separation in Y criteria. (more details...)
	Value	Specifies the minimum separation as a percentage of the model's height at M_SCALE. This value can be greater than 100%. (summarize) Specifies the minimum separation as a percentage of the model's height at M_SCALE. (more details...)
M_MODEL_ASPECT_RATIO		Sets the nominal aspect ratio factor for the model. The nominal aspect ratio factor is inversely applied to the height of the model, leaving the model's width constant. This control type is only supported for a model in an M_SHAPE_ELLIPSE type of Model Finder context. For other types of Model Finder contexts, see M_ASPECT_RATIO. INQ (summarize) Sets the nominal aspect ratio factor for the model. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 1.
	M_CIRCLE_ASPECT_RATIO	Specifies the minimum possible value for this control type.
	Value > 0	Specifies the value of the nominal aspect ratio for the model. Note that the final aspect ratio must be greater than or equal to 1. That is to say that the width of the model divided by the height of the model, multiplied by the value set for this control type must be greater than or equal to 1. (summarize) Specifies the value of the nominal aspect ratio for the model. (more details...)
M_MODEL_ASPECT_RATIO_MAX_FACTOR		Sets the factor used to determine the upper limit (maximum permitted aspect ratio) of the model's aspect ratio. M_MODEL_ASPECT_RATIO is multiplied by this factor. Occurrences with aspect ratios outside of this range cannot be returned as results. This control type is only supported for a model in an M_SHAPE_ELLIPSE type of Model Finder context. INQ (summarize) Sets the factor used to determine the upper limit (maximum permitted aspect ratio) of the model's aspect ratio. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 1.2.
	M_INFINITE	Specifies that the maximum factor for the aspect ratio of a model is infinite.
	Value >= 1	Specifies the factor that determines the maximum aspect ratio for a model.
M_MODEL_ASPECT_RATIO_MIN_FACTOR		Sets the factor used to determine the lower limit (minimum permitted aspect ratio) of the model's aspect ratio. M_MODEL_ASPECT_RATIO is multiplied by this factor. Occurrences with aspect ratios outside of this range cannot be returned as results. This control type is only supported for a model in an M_SHAPE_ELLIPSE type of Model Finder context. INQ (summarize) Sets the factor used to determine the lower limit (minimum permitted aspect ratio) of the model's aspect ratio. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.8.
	M_CIRCLE_ASPECT_RATIO	Specifies the minimum factor for the aspect ratio of a model.
	0 < Value <= 1	Specifies the factor that determines the minimum aspect ratio for a model.
M_PIXEL_SCALE		Sets the pixel scale of the model, if it is a synthetic model. This value is the scale to apply to the model to go from model units to pixel units. M_PIXEL_SCALE is used for the match if the target is not calibrated. If the target is calibrated, this value is not used for the match nor for the returned results. However, this value will be used for draw operations. This control type is not supported for models defined with an M_SHAPE_... type of Model Finder context. For these types of contexts, the model units are interpreted to be in the units of the target. If the target is calibrated, the units are interpreted to be in calibrated units. If the target is not, the units are interpreted to be in pixel units. INQ (summarize) Sets the pixel scale of the model, if it is a synthetic model. INQ (more details...)
	M_DEFAULT	Specifies the default value of the pixel scale. If it is a calibrated model, the default is 1/(pixel size in X of the associated camera calibration). If it is not a calibrated model, the default is 1.0. (summarize) Specifies the default value of the pixel scale. (more details...)
	Value > 0.0	Specifies the pixel scale. Note that if the model is not a synthetic model, the only valid value is 1.0. Any other value will generate an error. (summarize) Specifies the pixel scale. (more details...)
M_POLARITY		Sets the expected polarity of occurrences, compared to that of the model. INQ (summarize) Sets the expected polarity of occurrences, compared to that of the model. INQ (more details...)
	M_DEFAULT	Specifies the default value. For a model defined in an M_GEOMETRIC or M_GEOMETRIC_CONTROLLED type of Model Finder context, the default value is M_SAME. For a model defined in an M_SHAPE_... type of Model Finder context, the default value is M_SAME_OR_REVERSE. (summarize) Specifies the default value. (more details...)
	M_ANY	Specifies that the occurrences can be a mixture of polarities.
	M_REVERSE	Specifies that the polarity of occurrences is the reverse of that of the model.
	M_SAME	Specifies that the polarity of occurrences is the same as that of the model.
	M_SAME_OR_REVERSE	Specifies that the polarity of occurrences can be either the same or the reverse of that of the model.
M_POSITION_DELTA_NEG_X		Sets the valid position range in the negative X-direction, relative to the nominal position (M_POSITION_X and M_POSITION_Y). The position range limits the region in which the position of a model occurrence can be found; position coordinates which fall outside this region cannot be returned as results (MmodGetResult() with M_POSITION_X and M_POSITION_Y). Note that the position returned for an occurrence is determined by the model's reference axis position. The region defined by the position range can lie partially, or totally, outside the target. Note that typically, to search for model occurrences within the position range, calculations specific to position-range search strategies should be enabled (M_SEARCH_POSITION_RANGE) for the context. When enabled, using a small position range generally decreases the search time, depending on the number of details present in the target. Always set the position range to the minimum required when speed is a consideration. When M_POSITION_X is set to M_ALL, M_POSITION_DELTA_NEG_X will be treated as if set to M_INFINITE regardless of its actual setting. INQ (summarize) Sets the valid position range in the negative X-direction, relative to the nominal position (M_POSITION_X and M_POSITION_Y). INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.0.
	M_INFINITE	Specifies the position range as the entire image plane in the negative X-direction. This means that any X-coordinate in the negative X-direction from the nominal position (even outside the target) can be returned as a result. (summarize) Specifies the position range as the entire image plane in the negative X-direction. (more details...)
	Value >= 0.0	Specifies the position range's negative X-offset, in pixels, and can be specified with subpixel accuracy; for an M_SHAPE_... type of Model Finder context, specify the offset in the units of the target's coordinate system.
M_POSITION_DELTA_NEG_Y		Sets the valid position range in the negative Y-direction, relative to the nominal position (M_POSITION_X and M_POSITION_Y). The position range limits the region in which the position of a model occurrence can be found; position coordinates which fall outside this region cannot be returned as results (MmodGetResult() with M_POSITION_X and M_POSITION_Y). Note that the position returned for an occurrence is determined by the model's reference axis position. The region defined by the position range can lie partially, or totally, outside the target. Note that typically, to search for model occurrences within the position range, calculations specific to position-range search strategies should be enabled (M_SEARCH_POSITION_RANGE) for the context. When enabled, using a small position range generally decreases the search time, depending on the number of details present in the target. Always set the position range to the minimum required when speed is a consideration. When M_POSITION_Y is set to M_ALL, M_POSITION_DELTA_NEG_Y will be treated as if set to M_INFINITE regardless of its actual setting. INQ (summarize) Sets the valid position range in the negative Y-direction, relative to the nominal position (M_POSITION_X and M_POSITION_Y). INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.0.
	M_INFINITE	Specifies the position range as the entire image plane in the negative Y-direction. This means that any Y-coordinate in the negative Y-direction from the nominal position (even outside the target) can be returned as a result. (summarize) Specifies the position range as the entire image plane in the negative Y-direction. (more details...)
	Value >= 0.0	Specifies the position range's negative Y-offset, in pixels, and can be specified with subpixel accuracy; for an M_SHAPE_... type of Model Finder context, specify the offset in the units of the target's coordinate system.
M_POSITION_DELTA_POS_X		Sets the valid position range in the positive X-direction, relative to the nominal position (M_POSITION_X and M_POSITION_Y). The position range limits the region in which the position of a model occurrence can be found; position coordinates which fall outside this region cannot be returned as results (MmodGetResult() with M_POSITION_X and M_POSITION_Y). Note that the position returned for an occurrence is determined by the model's reference axis position. The region defined by the position range can lie partially, or totally, outside the target. Note that typically, to search for model occurrences within the position range, calculations specific to position-range search strategies should be enabled (M_SEARCH_POSITION_RANGE) for the context. When enabled, using a small position range generally decreases the search time, depending on the number of details present in the target. Always set the position range to the minimum required when speed is a consideration. When M_POSITION_X is set to M_ALL, M_POSITION_DELTA_POS_X will be treated as if set to M_INFINITE regardless of its actual setting. INQ (summarize) Sets the valid position range in the positive X-direction, relative to the nominal position (M_POSITION_X and M_POSITION_Y). INQ (more details...)
	M_DEFAULT	Same as M_INFINITE.
	M_INFINITE	Specifies the position range as the entire image plane in the positive X-direction. This means that any X-coordinate in the positive X-direction from the nominal position (even outside the target) can be returned as a result. (summarize) Specifies the position range as the entire image plane in the positive X-direction. (more details...)
	Value >= 0.0	Specifies the position range's positive X-offset, in pixels, and can be specified with subpixel accuracy; for an M_SHAPE_... type of Model Finder context, specify the offset in the units of the target's coordinate system.
M_POSITION_DELTA_POS_Y		Sets the valid position range in the positive Y-direction, relative to the nominal position (M_POSITION_X and M_POSITION_Y). The position range limits the region in which the position of a model occurrence can be found; position coordinates which fall outside this region cannot be returned as results (MmodGetResult() with M_POSITION_X and M_POSITION_Y). Note that the position returned for an occurrence is determined by the model's reference axis position. The region defined by the position range can lie partially, or totally, outside the target. Note that typically, to search for model occurrences within the position range, calculations specific to position-range search strategies should be enabled (M_SEARCH_POSITION_RANGE) for the context. When enabled, using a small position range generally decreases the search time, depending on the number of details present in the target. Always set the position range to the minimum required when speed is a consideration. When M_POSITION_Y is set to M_ALL, M_POSITION_DELTA_POS_Y will be treated as if set to M_INFINITE regardless of its actual setting. INQ (summarize) Sets the valid position range in the positive Y-direction, relative to the nominal position (M_POSITION_X and M_POSITION_Y). INQ (more details...)
	M_DEFAULT	Same as M_INFINITE.
	M_INFINITE	Specifies the position range as the entire image plane in the positive Y-direction. This means that any Y-coordinate in the positive Y-axis from the nominal position (even outside the target) can be returned as a result. (summarize) Specifies the position range as the entire image plane in the positive Y-direction. (more details...)
	Value >= 0.0	Specifies the position range's positive Y-offset, in pixels, and can be specified with subpixel accuracy; for an M_SHAPE_... type of Model Finder context, specify the offset in the units of the target's coordinate system.
M_POSITION_X		Sets the nominal search position for the X-coordinate. INQ (summarize) Sets the nominal search position for the X-coordinate. INQ (more details...)
	M_DEFAULT	Same as M_ALL.
	M_ALL	Specifies all X-coordinates.
	Value	Specifies the nominal search position, in pixels, and can be specified with subpixel accuracy; for an M_SHAPE_... type of Model Finder context, specify the position in the units of the target's coordinate system.
M_POSITION_Y		Sets the nominal search position for the Y-coordinate. INQ (summarize) Sets the nominal search position for the Y-coordinate. INQ (more details...)
	M_DEFAULT	Same as M_ALL.
	M_ALL	Specifies all Y-coordinates.
	Value	Specifies the nominal search position, in pixels, and can be specified with subpixel accuracy; for an M_SHAPE_... type of Model Finder context, specify the position in the units of the target's coordinate system.
M_REFERENCE_ANGLE		Sets the angle of the reference axis for the model. Angle results are returned relative to this axis, rather than the model source image axis. By default, for an ellipse model defined in an M_SHAPE_ELLIPSE type of Model Finder context, the reference axis is aligned with the principal axis of the model (the width). INQ (summarize) Sets the angle of the reference axis for the model. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.0 degrees.
	0.0 <= Value <= 360.0	Specifies the angle, in degrees. If the Model Finder operation is performed on a calibrated target, you must specify the angle with respect to the relative coordinate system of the target. (summarize) Specifies the angle, in degrees. (more details...)
M_REFERENCE_X		Sets the X-offset of the origin of the model's reference axis, relative to the model origin. Position results return the X-coordinate of the model's reference axis origin transformed at the model occurrence. Position results are relative to the target origin. Note that the reference axis origin need not be in the model. INQ (summarize) Sets the X-offset of the origin of the model's reference axis, relative to the model origin. INQ (more details...)
	M_DEFAULT	Specifies that the default X-offset will be used. For a synthetic model, the default value is 0.0. For other types of models, the default value is the center of the model. (summarize) Specifies that the default X-offset will be used. (more details...)
	Value	Specifies the X-offset value. The value is in pixels, and can be specified with subpixel accuracy. (summarize) Specifies the X-offset value. (more details...)
M_REFERENCE_Y		Sets the Y-offset of the origin of the model's reference axis, relative to the model origin. Position results return the Y-coordinate of the model's reference axis origin transformed at the model occurrence. Position results are relative to the target origin. Note that the reference axis origin need not be in the model. INQ (summarize) Sets the Y-offset of the origin of the model's reference axis, relative to the model origin. INQ (more details...)
	M_DEFAULT	Specifies that the default Y-offset will be used. For a synthetic model, the default value is 0.0. For other types of models, the default value is the center of the model. (summarize) Specifies that the default Y-offset will be used. (more details...)
	Value	Specifies the Y-offset value. The value is in pixels, and can be specified with subpixel accuracy. (summarize) Specifies the Y-offset value. (more details...)
M_SAGITTA_TOLERANCE		Sets the tolerance for finding deformed circles (allowable radii variation) for a model defined in an M_SHAPE_... type of Model Finder context, given the other specified Model Finder constraints. This control type is only supported for a model in an M_SHAPE_... type of Model Finder context. INQ (summarize) Sets the tolerance for finding deformed circles (allowable radii variation) for a model defined in an M_SHAPE_... type of Model Finder context, given the other specified Model Finder constraints. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 25.0%.
	0.0 <= Value <= 100.0	Specifies the tolerance as a percentage of the allowable radii variation given the other Model Finder constraints. A value of 0.0% means that the circular shape being sought needs to be as close as possible to a perfect circle. A value of 100.0% means that the algorithm has the maximum tolerance for finding deformed circles. This could lead to finding elliptical shapes or circular type shapes with noise around the edges. (summarize) Specifies the tolerance as a percentage of the allowable radii variation given the other Model Finder constraints. (more details...)
M_SCALE		Sets the nominal search scale. For a model defined in an M_SHAPE_ELLIPSE type of Model Finder context, scale calculations are taken with respect to the model's width. The model's height is not taken into account. Use M_MODEL_ASPECT_RATIO to account for height differences. For example, if the model has a width of 4 and a height of 2 and the occurrence is expected to have a height of 2 and a width of 8, set M_SCALE to 2 and M_MODEL_ASPECT_RATIO to 2. Recall that the width of a model in an M_SHAPE_ELLIPSE type of Model Finder context, or the width of an occurrence of this type of model, is always measured along its principal axis. INQ (summarize) Sets the nominal search scale. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 1.0.
	Value	Specifies the value of the nominal search scale. For a synthetic model, the nominal scale can be any positive value. For all other models, the nominal scale must be from 0.5 to 2.0. (summarize) Specifies the value of the nominal search scale. (more details...)
M_SCALE_MAX_FACTOR		Sets the factor used to determine the upper limit (maximum permitted scale) of the scale range. M_SCALE is multiplied by this factor. Occurrences with scales outside the scale-range cannot be returned as results. Note that typically, to search for model occurrences within the scale range, calculations specific to scale-range search strategies should be enabled (M_SEARCH_SCALE_RANGE) for the context. When enabled, the scale range should only cover the expected variance in scale to avoid slowing down the search and avoid finding unwanted occurrences. A search through a range of scales is performed in parallel, meaning that the actual scale of an occurrence has no bearing on which occurrence will be found first. INQ (summarize) Sets the factor used to determine the upper limit (maximum permitted scale) of the scale range. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 2.0.
	M_INFINITE	Specifies that the upper limit of the scale range is infinite. This control value is only supported for a model defined in an M_SHAPE_... type of Model Finder context. (summarize) Specifies that the upper limit of the scale range is infinite. (more details...)
	1.0 <= Value <= 2.0	Specifies the factor that determines the maximum scale of the occurrence for a model in an M_GEOMETRIC or M_GEOMETRIC_CONTROLLED type of Model Finder context.
	Value >= 1.0	Specifies the factor that determines the maximum scale of the occurrence for a model in an M_SHAPE_... type of Model Finder context.
M_SCALE_MIN_FACTOR		Sets the factor used to determine the lower limit (minimum permitted scale) of the scale range. M_SCALE is multiplied by this factor. Occurrences with scales outside the scale-range cannot be returned as results. Note that typically, to search for model occurrences within the scale range, calculations specific to scale-range search strategies should be enabled (M_SEARCH_SCALE_RANGE) for the context. When enabled, the scale range should only cover the expected variance in scale to avoid slowing down the search and avoid finding unwanted occurrences. A search through a range of scales is performed in parallel, meaning that the actual scale of an occurrence has no bearing on which occurrence will be found first. INQ (summarize) Sets the factor used to determine the lower limit (minimum permitted scale) of the scale range. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.5.
	0.0 < Value <= 1.0	Specifies the factor that determines the minimum scale of the occurrence for a model in an M_SHAPE_... type of Model Finder context.
	0.5 <= Value <= 1.0	Specifies the factor that determines the minimum scale of the occurrence for a model in an M_GEOMETRIC or M_GEOMETRIC_CONTROLLED type of Model Finder context.
M_SEARCH_ASPECT_RATIO_CONSTRAINT		Sets whether to constrain candidates to the nearest bound of the aspect ratio range if the candidate is outside of the range. For example, if the maximum effective aspect ratio being sought is 2.0, and a candidate's aspect ratio is 2.3, and M_SEARCH_ASPECT_RATIO_CONSTRAINT is set to M_ENABLE, the candidate can be identified as an occurrence, with a reduced score, while if M_SEARCH_ASPECT_RATIO_CONSTRAINT is set to M_DISABLE, it is not. This control type is only supported for a model in an M_SHAPE_ELLIPSE type of Model Finder context. INQ (summarize) Sets whether to constrain candidates to the nearest bound of the aspect ratio range if the candidate is outside of the range. INQ (more details...)
	M_DEFAULT	Same as M_ENABLE.
	M_DISABLE	Specifies that for a candidate to be considered an occurrence, it must have an aspect ratio within the defined aspect ratio range. Using this control value will limit the number of occurrences returned, but they will all conform to the defined aspect ratio range. (summarize) Specifies that for a candidate to be considered an occurrence, it must have an aspect ratio within the defined aspect ratio range. (more details...)
	M_ENABLE	Specifies to consider candidates with an aspect ratio that falls outside of the specified aspect ratio range, but constrain their fit to the closest bound of the aspect ratio range, and reduce their score accordingly. This allows for more potential occurrences to be returned. (summarize) Specifies to consider candidates with an aspect ratio that falls outside of the specified aspect ratio range, but constrain their fit to the closest bound of the aspect ratio range, and reduce their score accordingly. (more details...)
M_SEARCH_POSITION_FROM_GRAPHIC_LIST		Specifies to use a search region defined from a graphics list. To be a valid graphics list, the graphics list must contain a maximum of one graphic of type rectangle (MgraRect(), MgraRectAngle(), MgraInteractive() with M_GRAPHIC_TYPE_RECT, or MgraRectFill()), have its input units set to pixels (MgraControlList() with M_INPUT_UNITS set to M_PIXEL), and be defined at and angular offset of 0 degrees. Using this value is effectively equivalent to making multiple calls to MmodControl() with M_POSITION_X, M_POSITION_Y, M_POSITION_DELTA_NEG_X, M_POSITION_DELTA_NEG_Y, M_POSITION_DELTA_POS_X, and M_POSITION_DELTA_POS_Y. INQ (summarize) Specifies to use a search region defined from a graphics list. INQ (more details...)
	MIL graphics list identifier	Specifies the identifier of the graphics list containing the rectangular region that will be used as the model search region.
M_USER_LABEL		Sets a unique user-defined label for the specified model. This label can be used as a means of identifying your model, independently from its index, in the Model Finder context. INQ (summarize) Sets a unique user-defined label for the specified model. INQ (more details...)
	M_DEFAULT	Same as M_NO_LABEL.
	M_NO_LABEL	Specifies that no user label is associated with the model.
	Value	Specifies the user label of the model. The value must be an integer value that is not associated as a label with any other model in the Model Finder context. Since the same label cannot be associated with multiple models, you cannot pass a user label if the Index parameter of this function is set to M_ALL. (summarize) Specifies the user label of the model. (more details...)

The following ControlType and corresponding ControlValue settings can be specified for a Model Finder result buffer:

For a result buffer
ControlType		Description
	ControlValue	Description
M_MOD_DEFINE_COMPATIBLE		Saves all the necessary information in the result buffer to be able to define a model from a result occurrence (MmodDefine() with M_MOD_RESULT). This control type is not supported for an M_SHAPE_... type of Model Finder result buffer. INQ (summarize) Saves all the necessary information in the result buffer to be able to define a model from a result occurrence (MmodDefine() with M_MOD_RESULT). INQ (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies not to save any information.
	M_ENABLE	Specifies to save all the necessary information.
M_RESULT_OUTPUT_UNITS		Sets whether to return results in pixels or world units. This essentially sets the output coordinate system to use. The setting of this control type will only affect functions within this module which return positional results. This control type can be changed at any time to return results in the required output units. INQ (summarize) Sets whether to return results in pixels or world units. INQ (more details...)
	M_DEFAULT	Same as M_ACCORDING_TO_CALIBRATION.
	M_ACCORDING_TO_CALIBRATION	Specifies that results are returned in world units if the result was calculated on an image associated with a camera calibration context; otherwise, specifies that results are returned in pixel units.
	M_PIXEL	Specifies that results are returned in pixel units, with respect to the pixel coordinate system.
	M_WORLD	Specifies that results are returned in world units, with respect to the relative coordinate system. If world units are specifed, calling MmodGetResult() generates an error if the result was not calculated on a calibrated image. (summarize) Specifies that results are returned in world units, with respect to the relative coordinate system. (more details...)

Type specific versions of the function when using a C compiler under 64-bit

void MmodControlInt64 (MIL_ID ContextOrResultId, MIL_INT Index, MIL_INT64 ControlType, MIL_INT64 ControlValue)

Details

Parameters

ContextOrResultId

See ContextOrResultId of the main function for a description.

Index

See Index of the main function for a description.

ControlType

See ControlType of the main function for a description.

ControlValue

See ControlValue of the main function for a description.

void MmodControlDouble (MIL_ID ContextOrResultId, MIL_INT Index, MIL_INT64 ControlType, MIL_DOUBLE ControlValue)

Details

Parameters

ContextOrResultId

See ContextOrResultId of the main function for a description.

Index

See Index of the main function for a description.

ControlType

See ControlType of the main function for a description.

ControlValue

See ControlValue of the main function for a description.

Compilation information

Header	Include mil.h.
Library	Use mil.lib; milmod.lib.
DLL	Requires mil.dll; milmod.dll.