imaqMatchPattern

NI Vision for LabWindows/CVI Function

imaqMatchPattern

Usage

PatternMatch* imaqMatchPattern(const Image* image, Image* pattern, const MatchPatternOptions* options, Rect searchRect, int* numMatches);

Purpose

Searches for areas in an image that match a given template image.

Note  This function is obsolete. The replacement function is imaqMatchPattern2().

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 Image* The pattern image to find in the image. NI Vision must learn this template image in imaqLearnPattern() before using it in this function.
options const MatchPatternOptions* Describes how to search for the template image.
searchRect Rect Specifies a rectangle in the image in which to search for the template image. Set this parameter to IMAQ_NO_RECT to search for the template image 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

PatternMatch* 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

options—,Set the options parameter to NULL to use the default options, as follows:

mode IMAQ_MATCH_SHIFT_INVARIANT
minContrast 10
subpixelAccuracy FALSE
angleRanges NULL (all angles allowed)
numRanges 0
numMatchesRequested 1
matchFactor 0
minMatchScore 800