| MIL 10 Reference
| Customize Help
| Save Settings

MpatSetNumber


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
MpatSetDontCare
MpatSetPosition
Synopsis
Set the expected number of occurrences of a model.
Syntax
void MpatSetNumber(
MIL_ID ModelId, //in
MIL_INT NbOccurrences //in
)
Description

This function sets the number of occurrences of a model for which to search when using MpatFindModel() or MpatFindMultipleModel(). Occurrences with match scores that are greater than or equal to the certainty level (set with MpatSetCertainty()) are returned, up to the number specified in NbOccurrences. If such occurrences are fewer than the specified number, the remaining occurrences returned are the best of those that are greater than or equal to the acceptance level (set with MpatSetAcceptance()). The default is 1 (that is, find only the first occurrence with a match score that is greater than or equal to the certainty level).

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 set the expected number of occurrences.

NbOccurrences INQ

Specifies the maximum number of occurrences for which to look in the target image. The number of occurrences should be less than or equal to the number of result buffer entries or some results might be lost.

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

function map For specifying the maximim number of occurrences
CollapseValue Description
Collapse M_ALL

Specifies to look for all matches that are greater than or equal to the acceptance level.
Collapse 1 <= Value <= 1000

Specifies the maximum number of occurrences for which to look in the target image.

The default value is 1.

(summarize)
Compilation information
Header Include mil.h.
Library Use mil.lib; milpat.lib.
DLL Requires mil.dll; milpat.dll.
ALL