MpatSetNumber()函数

Synopsis

Set the expected number of occurrences of a model.

Format

void MpatSetNumber(ModelId, NbOccurences)

MIL_ID ModelId;

Identifier of model to be affected

long NbOccurences;

Maximum number of occurrences to find

Description

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

You can modify the number of occurrences before performing each search.

The ModelId parameter specifies the identifier of the model for which to set the expected number of occurrences.

The NbOccurences parameter 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 may be lost. To return all matches that attain/exceed the acceptance level, set this parameter to M_ALL.

See also

MpatSetAcceptance, MpatSetCertainty, MpatFindModel, MpatFindMultipleModel, MpatGetNumber, MpatGetResult

相关文章:

  1. MpatAllocAutoModel()函数
    Synopsis Automatically allocate a unique pattern matching model from a source image. Format MIL_ID MpatAllocAutoModel(SystemId, SrcImageBufId, SizeX, SizeY, PosUncertaintyX, PosUncertaintyY,...
  2. MpatFindModel()函数
    Synopsis Find a pattern matching model in the target image buffer. Format void MpatFindModel(ImageBufId, ModelId, PatResultId)...
  3. MpatFindMultipleModel()函数
    Synopsis Find multiple pattern matching models in the target image buffer. Format void MpatFindMultipleModel(ImageBufId, ModelIdLst, PatResultIdLst, NumModels, ExpFlag)...
  4. MpatFindOrientation()函数
    Synopsis Find the orientation of an image or of an object in an image. Format void MpatFindOrientation(ImageBufId, ModelId, FindResultId, ResultRange)...
  5. MpatRead()函数
    Synopsis Read a pattern matching model from an open file. Format MIL_ID MpatRead(SystemId, FileHandle, ModelIdPtr)...
  6. MpatRestore()函数
    Synopsis Restore a pattern matching model from disk. Format MIL_ID MpatRestore(SystemId, FileName, ModelIdPtr)...
  7. MpatSave()函数
    Synopsis Save a pattern matching model to disk. Format void MpatSave(FileName, ModelId)...
  8. MpatSetDontCare()函数
    Synopsis Set the pattern matching model's "don't care" pixels. Format void MpatSetDontCare(ModelId, ImageBufId, OffX, OffY, Value)...
  9. MpatSetPosition()函数
    Synopsis Set the pattern matching search position. Format void MpatSetPosition(ModelId, OffX, OffY, SizeX, SizeY)...
  10. MpatSetSearchParameter()函数
    Synopsis Set a pattern matching internal search parameter. Format void MpatSetSearchParameter(ModelId, Parameter, Value)...