MatchGeometricPatternOptions

NI Vision for LabWindows/CVI Function

MatchGeometricPatternOptions

Describes how to match a pattern geometrically.

Elements

Name

Type

Description

mode unsigned int Specifies the method imaqMatchGeometricPattern() uses when looking for the pattern in the image. Combine values from the GeometricMatchingMode enumeration to specify the value of this element.
subpixelAccuracy int Set this element to TRUE to specify that the function should calculate match locations with subpixel accuracy. Set this element to FALSE to specify that the function should calculate match locations with pixel accuracy.
angleRanges RangeFloat* An array of angle ranges, in degrees, where each range specifies how much you expect the template to be rotated in the image. To decrease the search time, limit the degrees of rotation in which you expect to find the template image. Set this element to NULL to allow all angles. This function ignores these ranges if mode does not include IMAQ_GEOMETRIC_MATCH_ROTATION_INVARIANT.
numAngleRanges int Number of angle ranges in the angleRanges array.
scaleRange RangeFloat A range that specifies the sizes of the pattern you expect to be in the image, expressed as a ratio percentage representing the size of the pattern in the image divided by size of the original pattern multiplied by 100. This function ignores this range if mode does not include IMAQ_GEOMETRIC_MATCH_SCALE_INVARIANT.
occlusionRange RangeFloat A range that specifies the percentage of the pattern you expect to be occluded in the image. This function ignores this range if mode does not include IMAQ_GEOMETRIC_MATCH_OCCLUSION_INVARIANT.
numMatchesRequested int Number of valid matches expected.
minMatchScore float The minimum score a match can have for the function to consider the match valid. Acceptable values range from 0 to 1,000.