| MIL 10 Reference
| Customize Help
| Save Settings

MpatSetDontCare



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
None.
Synopsis
Set the "don't care" pixels in a model.
Syntax
void MpatSetDontCare(
MIL_ID ModelId, //in
MIL_ID ImageBufId, //in
MIL_INT OffX, //in
MIL_INT OffY, //in
MIL_INT Value //in
)
Description

This function sets pixels in the specified model to a "don't care" state. The "don't care" pixels of the model will not be considered when searching for occurrences of the model in the target image (MpatFindModel() or MpatFindMultipleModel()). To determine which model pixels to set, a region of the specified image buffer, starting at the specified offset and equal in size to the model, is compared with the specified "don't care" value. If an image pixel is equal to this value, the corresponding pixel in the model is set to "don't care".

Note, each time this function is called, a new set of "don't care" pixels is assigned to the specified model, superceding any existing set. Therefore, multiple calls to this function do not have a cumulative effect. Also, whenever the "don't care" pixels in a model change, the effect of any preprocessing of the model is undone. Therefore, if the "don't care" pixels are changed, call MpatPreprocModel() before searching for the model.

This function does not support a M_NORMALIZED + M_CIRCULAR_OVERSCAN type of model, except if M_SEARCH_ANGLE_MODE is set to M_DISABLE.

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 in which to set "don't care" pixels.

ImageBufId

Specifies the identifier of the image buffer used to identify which pixels in the model will be set to "don't care". This buffer must be at least as large as the model.

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.

OffX

Specifies the X-offset from the upper-left corner of the specified image buffer to the upper-left corner of the pixel-value comparison area. The size of the comparison area is determined by the size of the model.

OffY

Specifies the Y-offset from the upper-left corner of the specified image buffer to the upper-left corner of the pixel-value comparison area. The size of the comparison area is determined by the size of the model.

Value

Specifies the pixel value in the image buffer that determine the corresponding "don't care" pixels.

Compilation information
Header Include mil.h.
Library Use mil.lib; milpat.lib.
DLL Requires mil.dll; milpat.dll.
PROC NONE SIZE X SIZE Y