| MIL 10 Reference
| Customize Help
| Save Settings

MpatPreprocModel



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
Preprocess a pattern matching model.
Syntax
void MpatPreprocModel(
MIL_ID TypicalImageBufId, //in
MIL_ID ModelId, //in
MIL_INT64 Mode //in
)
Description

This function preprocesses the specified model. It trains the system to search for the model in the most efficient manner (optionally within a specified typical image). The procedure is potentially quite lengthy (up to several seconds).

Call this function after all search parameters have been set. When you save, the model's preprocessing changes are stored with the model. Upon restoration, the model need not be preprocessed.

Note that if some of the model's search parameters are changed after a call to MpatPreprocModel(), the model must be preprocessed again. To inquire if your model is in a preprocessed state, use MpatInquire() with M_PREPROCESSED.

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
TypicalImageBufId

Specifies the identifier of a typical target image. The specified typical image will be used to refine and adapt the model to search on this typical background. You should only specify an image buffer if the model will always appear on such a background; otherwise, set this parameter to M_NULL.

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.

ModelId

Specifies the identifier of the model to preprocess.

Mode

Specifies the preprocessing mode. Set this parameter to M_DEFAULT.

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