MatchColorPatternOptions

NI Vision for LabWindows/CVI Function

MatchColorPatternOptions

Describes how you want the function to search for the color template image.

Elements

Name

Type

Description

matchMode MatchingMode Specifies the method to use when looking for the color pattern in the image.
featureMode ImageFeatureMode Specifies the features to use when looking for the color pattern in the image.
minContrast int Specifies the minimum contrast expected in the image.
subpixelAccuracy int Set this parameter to TRUE to return areas in the image that match the pattern area with subpixel accuracy.
angleRanges RotationAngleRange* An array of angle ranges, in degrees, where each range specifies how much you expect the pattern 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.
numRanges int Number of angle ranges in the angleRanges array.
colorWeight double Determines the percent contribution of the color score to the final color pattern matching score. Acceptable values range from 0 to 1,000. The algorithm uses the color weight for the final match ranking. For example, if you use a weight of 1,000, the algorithm finds each match by using both color and shape information and then ranks the matches based on their color scores. If the weight is 0, the matches are ranked based on their shape scores. The default is 500, indicating that the match score uses an equal combination of the color and shape scores.
sensitivity ColorSensitivity Specifies the sensitivity of the color information in the image.
strategy SearchStrategy Specifies how the color features of the image are used during the search phase.
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.