imaqLearnMultipleGeometricPatterns

NI Vision for LabWindows/CVI Function

imaqLearnMultipleGeometricPatterns

Usage

MultipleGeometricPattern* imaqLearnMultipleGeometricPatterns(const Image** patterns, unsigned int numberOfPatterns, const String255* labels);

Purpose

Combines the descriptions of the patterns you want to search for during the matching phase into a multiple geometric template. Use the multiple geometric template to search for these templates images in the target image.

Image Types Supported

IMAQ_IMAGE_U8

Parameters

Name

Type

Description

patterns const Image** The array of patterns you want to search for in the target image. NI Vision must learn each of the template images in the array using imaqLearnGeometricPattern() before using it in this function.
numberOfPatterns unsigned int The number of patterns in patterns.
labels const String255* The array of labels that identify the patterns. The size of this array must be equal to numberOfPatterns.

Return Value

Type

Description

MultipleGeometricPattern* On success, this function returns a multiple geometric template. 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().