imaqSetMultipleGeometricPatternsOptions
Usage
int imaqSetMultipleGeometricPatternsOptions(MultipleGeometricPattern* multiplePattern, const char* label, const CurveOptions* curveOptions, const MatchGeometricPatternOptions* matchOptions, const MatchGeometricPatternAdvancedOptions2* advancedMatchOptions);
Purpose
Sets the options used by imaqMatchMultipleGeometricPatterns() to match the template image corresponding to the specified label in multiplePattern.
Parameters
|
Name
|
Type
|
Description
|
|---|---|---|
| multiplePattern | MultipleGeometricPattern* | The multiple geometric pattern that the template image is part of. This parameter is required and cannot be NULL. |
| label | const char* | The label identifying the template image for which you are setting the options. This parameter is required and cannot be NULL. |
| curveOptions | const CurveOptions* | Describes how the function identifies the curves in the image the function will use to match the template image. This function does not support identifying curves with subpixel accuracy and therefore ignores the subpixelAccuracy element of this parameter. Set this parameter to NULL to use the same curve options to match the template image as you used to learn the template image. |
| matchOptions | const MatchGeometricPatternOptions* | Describes how to search for the template image. |
| advancedMatchOptions | const MatchGeometricPatternAdvancedOptions2* | Specifies advanced behaviors of the function, which can be used to optimize the performance of the function or to fine-tune the matches located by the function. |
Return Value
| Type |
Description |
|---|---|
| int | On success, this function returns a non-zero value. On failure, this function returns 0. To get extended error information, call imaqGetLastError(). |
Parameter Discussion
matchOptions—Set matchOptions to NULL to use the default match options, as follows:
| mode | IMAQ_GEOMETRIC_MATCH_ROTATION_INVARIANT |
| subpixelAccuracy | FALSE |
| angleRanges | NULL (all angles allowed) |
| numRanges | 0 |
| scaleRange | {75, 125} |
| occlusionRange | {0, 25} |
| numMatchesRequested | 1 |
| minMatchScore | 800 |
advancedMatchOptions—Set advancedMatchOptions to NULL to use the default advanced match options, as follows:
| minFeaturesUsed | 5 |
| maxFeaturesUsed | 5 |
| subpixelIterations | 20 |
| subpixelTolerance | 0 |
| initialMatchListLength | 200 |
| matchTemplateCurveScore | FALSE |
| correlationScore | TRUE |
| minMatchSeparationDistance | 20 |
| minMatchSeparationAngle | 10 |
| minMatchSeparationScale | 10 |
| maxMatchOverlap | 80 |
| coarseResult | FALSE |
| smoothContours | FALSE |
| enableCalibrationSupport | TRUE |