Configuring Color Signatures in VEXcode IQ

Put the solid-colored object you want the AI Vision Sensor to be able to recognize in front of it.

Position your cursor over the solid-colored object, then select and drag across the desired color to configure it. A red box will appear across the edge of the area that was selected.

Note: Make sure to stay within the confines of the color you want to select. Otherwise, you may accidentally grab colors from the background that can throw off the AI Vision Sensor’s detection.

The Set Color button will become available. Select it to save the color.

Once a color is set, the AI Vision Sensor will save it as a Color Signature.

Rename the color signature by selecting into the Name textbox and typing.

Select Add Color to configure additional color signatures for other objects.

The AI Vision Sensor can track up to 7 color signatures at a time.

Once all desired colors have been set, select Close.

All configured color signatures will now appear in the Configured Colors section of the Devices Window for the AI Vision Sensor.

Select Done to save your changes to the AI Vision Sensor's configuration.

When configuring a color signature, options appear for both Hue and Saturation Ranges. These allow you to tune the color signature to be more resilient. A color signature is considered resilient when the object can be moved around and still be tracked by the AI Vision Utility.

The first slider is the Hue Range. Hue is the color perceived, as defined by its position on the color wheel. This color wheel has a range of 0 to 359.9 degrees and each color on the wheel has a defined degree value. 

The Hue Range allows you to choose the degrees above and below the configured color that will report as that color. For example, a dark blue may have the hue value of 240 degrees. With a Hue Range of 20 degrees, anything from 220 degrees to 260 degrees will report as that dark blue configured color.

To tune your color configuration, slowly move the Hue Range slider until the target box is stable around the object. Do not move it any further than it needs to.

The second slider is the Saturation Range. Saturation is the intensity or purity of the color. The brighter the color, the more saturated it is. Saturation is a relative scale measured with percentages from 0%, being a muted grey tone, and 100% being a intense version of that hue. 

The saturation range allows you to choose the percent of saturation above and below the configured color that will report as that color. For example, a yellow ball in dimmer lighting may appear as 50% saturation. With a saturation range of .25 (the decimal equivalent of 25%), anything from 25% to 75% saturation will report as that yellow configured color.

Move the slider for the Saturation Range until the object you want to track is fully surrounded by the target box.

Now you can test the resiliency of your Color Signature. Put the object in different lighting conditions or move it around to see if the AI Vision Sensor can continue to track it in different settings and conditions.