GeometricPatternMatch2

NI Vision for LabWindows/CVI Function

GeometricPatternMatch2

Information describing a matched geometric pattern.

Elements

Name

Type

Description

position PointFloat The location of the origin of the template in the match.
rotation float The rotation of the match relative to the template image, in degrees.
scale float The size of the match relative to the size of the template image, expressed as a percentage.
score float The accuracy of the match. A score of 1,000 indicates a perfect match, and a score of 0 indicates no match.
corner[4] PointFloat An array of four points describing the rectangle surrounding the template image.
inverse int This element is TRUE if the match is an inverse of the template image. For example, the match is a white object on a black background but the template image is a black object on a white background. This element is FALSE if the match and the template image have the same contrast with the image background.
occlusion float The percentage of the match that is occluded.
templateMatchCurveScore float The accuracy of the match obtained by comparing the template curves to the curves in the match region. A score of 1,000 indicates a perfect match, and a score of 0 indicates no match.
matchTemplateCurveScore float The accuracy of the match obtained by comparing the curves in the match region to the template curves. A score of 1,000 indicates a perfect match, and a score of 0 indicates no match. This element is calculated only if the matchTemplateCurveScore element of the advancedMatchOptions parameter to imaqMatchGeometricPattern2() is TRUE.
correlationScore float The accuracy of the match obtained by comparing the template image to the match region using a correlation metric that compares the two regions as a function of their pixel values. A score of 1,000 indicates a perfect match, and a score of 0 indicates no match. This element is calculated only if the correlationScore element of the advancedMatchOptions parameter to imaqMatchGeometricPattern2() is TRUE.
label String255 The label corresponding to this match when the match is returned by imaqMatchMultipleGeometricPatterns(). label is an empty string when the match is returned by imaqMatchGeometricPattern2().
featureData FeatureData* The features used in this match.
numFeatureData int The size of the featureData array.
calibratedPosition PointFloat The location of the origin of the template in the match. If the image where the match is found is a calibrated image, then this value is in real-world units. Otherwise, this value is the same as position.
calibratedRotation float The rotation of the match relative to the template image, in degrees. If the image where the match is found is a calibrated image, then this value is in real-world units. Otherwise, this value is the same as rotation.
calibratedCorner[4] PointFloat An array of four points describing the rectangle surrounding the template image. If the image where the match is found is a calibrated image, then this value describes the calibrated rectangle. Otherwise, this value is the same as corner[4].