A Color Signature is one of the two types of Visual Signatures utilized by the AI Vision Sensor for color identification. To enable the AI Vision Sensor to recognize Color Signatures, they need to be configured initially. Follow the steps outlined in this article to properly configure Color Signatures.
Ensure your AI Vision Sensor is connected to VEXcode EXP. For information on how to setup and connect your AI Vision Sensor, read Connect the AI Vision Sensor to App-based VEXcode EXP or Web-based VEXcode EXP.
Configure a Color Signature
1. Put what solid-colored object you want the AI Vision Sensor to be able to recognize in front of it.
2. Position your mouse cursor over the solid-colored object, then select and drag across the desired color to configure it.
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.
3. 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.
4. Rename the color signature by selecting into the Name textbox and typing.
5. Select Add Color to configure any further Color Signatures for other objects.
The AI Vision Sensor can track up to 7 Color Signatures at a time.
6. Once all desired colors have been set, select Close.
7. Once the AI Vision Sensor window is gone, select Done to exit the Devices menu and save your configuration changes.
Tune a Color Signature
Color Signatures can have their Hue Range and Saturation Range tweaked so the sensor can detect the color easier.
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 red 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 red 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.
Once two or more Color Signatures have been set, you can begin to configure Color Codes.