imaqMatchGeometricPattern2
Usage
GeometricPatternMatch2* imaqMatchGeometricPattern2(const Image* image, const Image* pattern, const CurveOptions* curveOptions, const MatchGeometricPatternOptions* matchOptions, const MatchGeometricPatternAdvancedOptions2* advancedMatchOptions, const ROI* roi, int* numMatches);
Purpose
Searches for areas in an image that match a given geometric template image.
Image Types Supported
IMAQ_IMAGE_U8
Parameters
|
Name
|
Type
|
Description
|
|---|---|---|
| image | const Image* | The image in which the function finds matches to the template image. |
| pattern | const Image* | The pattern to find in the image. |
| 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. |
| roi | const ROI* | Specifies where, in image, the function searches for the template image. The first contour of roi must be a rectangle or a rotated rectangle. Set this parameter to NULL to specify that the function searches in the entire image. |
| numMatches | int* | On return, the number of matches to the template image that the function found. Set this parameter to NULL if you do not need this information. |
Return Value
| Type |
Description |
|---|---|
| GeometricPatternMatch2* | On success, this function returns an array of information about each match found. On failure, this function returns NULL. To get extended error information, call imaqGetLastError(). When you are finished with the return value, dispose of the pointer by calling imaqDispose(). |
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 |