Match Colors Controls

NI Vision Builder

Check for Presence

Match Colors Controls

Main Tab

The following controls are available on the Main tab.

Control Name Description
Step Name Name to give the step.
Region of Interest The region of interest you want to use for the step.
Reposition Region of Interest When enabled, the step dynamically repositions the region of interest based on a coordinate system you built in a previous step.
Reference Coordinate System Coordinate system to which you want to link the region of interest.

Template Tab

The following controls are available on the Template tab.

Control Name Description
Template Displays a region of an image containing the reference color set.
Create Template When clicked, this button launches a dialog box that contains the current image in which you can draw a region of interest. The color contents of this region become the template image.
Template Size Displays the width and height, in pixels, of the selected template.
Color Sensitivity Level of sensitivity used to describe the color features in the image. The higher the value, the more detailed the color representation. Refer to Chapter 14, Color Inspection, of the NI Vision Concepts Manual for detailed information about choosing a color sensitivity. The following options are available:
  • Low
  • Medium
  • High
Saturation Threshold Threshold value that distinguishes two colors that have the same hue value but different saturation values. For example, use this control to distinguish between red, which has a high saturation, and pink, which has a low saturation.
Color Spectrum Displays a graphical representation of the color information in the template.
Ignore White When enabled, the white content of the color template is ignored.
Ignore Black When enabled, the black content of the color template is ignored.

Settings Tab

The following controls are available on the Settings tab.

Control Name Description
Minimum Score Minimum score a color match can have to be considered a valid match. This value can vary between 0 and 1000. A score of 1000 indicates a perfect match.
Number of Matches Number of regions that match the color template.
Matches Displays information about the individual regions of interest.
  • Score—Number ranging from 0 to 1000 that indicates how similar a potential match is to the template image. A score of 1000 indicates a perfect match. A score of 0 indicates no match.
  • Status—Indicates whether there is a match between the color template and the color in each specified region of the image. For each specified region of the image, Status is PASS if its color information has a score greater than or equal to Minimum Score.

Limits Tab

The following controls are available on the Limits tab.

Control Name Description
Minimum Number of Matches Minimum number of matches you expect the step to find.
Maximum Number of Matches Maximum number of matches you expect the step to find.
Number of Matches Number of regions that match the color template.
Matches Displays information about the individual regions of interest.
  • Score—Number ranging from 0 to 1000 that indicates how similar a potential match is to the template image. A score of 1000 indicates a perfect match. A score of 0 indicates no match.
  • Status—Indicates whether there is a match between the color template and the color in each specified region of the image. For each specified region of the image, Status is PASS if its color information matches the input color information.