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