imaqRefineMatches
Usage
PatternMatch* imaqRefineMatches(const Image* image, const Image* pattern, const PatternMatch* candidatesIn, int numCandidatesIn, MatchPatternOptions* options, MatchPatternAdvancedOptions* advancedOptions, int* numCandidatesOut);
Purpose
Refines matches returned from imaqMatchPattern2() using subpixel information learned with imaqLearnPattern().
Image Types Supported
IMAQ_IMAGE_U8
Parameters
|
Name
|
Type
|
Description
|
|---|---|---|
| image | const Image* | The inspection image in which you originally located the matches you want to refine. |
| pattern | const Image* | The template for which you want to search during the refinement phase. The template image is an output of imaqLearnPattern2(). |
| candidatesIn | const PatternMatch* | The candidate matches to refine. |
| numCandidatesIn | int | The number of candidates being passed in. |
| options | MatchPatternOptions* | The options passed in to imaqMatchPattern2(). |
| advancedOptions | MatchPatternAdvancedOptions* | The options passed in to imaqMatchPattern2(). |
| numCandidatesOut | int* | On return, the number of candidates returned. 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(). |