imaqMatchMultipleGeometricPatterns
Usage
GeometricPatternMatch2* imaqMatchMultipleGeometricPatterns(const Image* image, const MultipleGeometricPattern* multiplePattern, const ROI* roi, int* numMatches);
Purpose
Searches for the areas in the image that match the template images in the given multiple geometric template.
Image Types Supported
IMAQ_IMAGE_U8
Parameters
|
Name
|
Type
|
Description
|
|---|---|---|
| image | const Image* | The image in which the function finds matches to the template images. |
| multiplePattern | const MultipleGeometricPattern* | The patterns to find in the image. You must learn this multiple geometric template using imaqLearnMultipleGeometricPatterns() before using it in this function. This parameter is required and cannot be NULL. |
| roi | const ROI* | Specifies where, in image, the function searches for the template images. The first and only 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 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(). |