MpatAllocAutoModel

Specifies the system on which to allocate the models.

This parameter should be set to one of the following values:

For specifying the system identifier
Value	Description
M_DEFAULT_HOST	Specifies the default Host system of the current MIL application.
MIL system identifier	Specifies a valid system identifier, which you have allocated using the MsysAlloc() function.

Specifies the identifier of the image buffer from which to extract the models. This image should be representative of the target images. This function currently supports only 8-bit unsigned grayscale images.

This image buffer must not have a region of interest (ROI) associated with it. Using an image buffer with an ROI will cause an error.

Specifies the width of the required models.

Specifies the height of the required models.

Specifies the maximum displacement (shift) expected between the reference position of the models in the source image and their position when found in the target images in the horizontal direction. This information is used to select models that are far enough from the image borders to be present in the target images.

This parameter must be set to one of the values below.

For specifying the maximum displacement in the X-direction
Value	Description
M_DEFAULT	Selects models from anywhere in the whole width of the image. The default search region of each model is automatically set using the original position of the model, plus or minus the specified positional uncertainty. (summarize) Selects models from anywhere in the whole width of the image. (more details...)
Value	Sets PosUncertaintyX to the expected maximum pixel displacement in the horizontal direction. This value will select models that are far enough from the image borders to be present in the target images. (summarize) Sets PosUncertaintyX to the expected maximum pixel displacement in the horizontal direction. (more details...)

Specifies the maximum displacement (shift) expected between the reference position of the models in the source image and their position when found in the target images in the vertical direction. This information is used to select models that are far enough from the image borders to be present in the target images.

This parameter must be set to one of the values below.

For specifying the maximum displacement in the Y-direction
Value	Description
M_DEFAULT	Selects models from anywhere in the whole height of the image. The default search region of each model is automatically set using the original position of the model, plus or minus the specified positional uncertainty. (summarize) Selects models from anywhere in the whole height of the image. (more details...)
Value	Sets PosUncertaintyY to the expected maximum pixel displacement in the vertical direction. This value will select models that are far enough from the image borders to be present in the target images. (summarize) Sets PosUncertaintyY to the expected maximum pixel displacement in the vertical direction. (more details...)

Specifies the type of the model. The parameter must be set to the following:

For specifying the type of model
Value	Description
M_NORMALIZED +	Specifies a model used to search for the position, match score, and angle (if angular search is enabled) of a model occurrence in a target image, using MpatFindModel() and MpatFindMultipleModel().

Combination constant for any of the possible values of the ModelType parameter.

You can add the following value to the above-mentioned value to extract the model, as well as circular overscan data.

For the ModelType parameter
Combination value	Description
M_CIRCULAR_OVERSCAN	Extracts the model, as well as circular overscan data from the source image. The overscan data is determined by rotating the area from which to extract the model, about its center. The overscan data of an M_CIRCULAR_OVERSCAN type model is used if you search for an occurrence of the model at an angle. For this model, you cannot define "don't care" pixels (MpatSetDontCare()). (summarize) Extracts the model, as well as circular overscan data from the source image. (more details...)

Specifies the speed of the allocation process. This parameter must be set to one of the values below.

For specifying the speed of the allocation
Value	Description
M_DEFAULT	Same as M_FAST.
M_BEST +	Allocates the models with high precision.
M_FAST +	Allocates the models at high-speed.

Combination constant for any of the possible values of the Mode parameter.

You can add the following value to the above-mentioned values to set the number of models to allocate from the same image.

For the Mode parameter
Combination value	Description
M_MULTIPLE + n	Allocates several models from the same image. Set n to the number of models to allocate. For example, set Mode to M_BEST + M_MULTIPLE + 4 to find and allocate the four most unique models available in your image. Models can overlap within the image by half the size of the model (in X and Y). (summarize) Allocates several models from the same image. (more details...)

Specifies the address of the array in which to write the model identifiers. The identifier is required to use a model with other pattern matching functions. Since MpatAllocAutoModel() also returns the model identifier, you can set this parameter to M_NULL when allocating a single model. If allocation fails, M_NULL is written as the identifier.