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().