Back to Adaptive Vision Studio website
You are here: Start » Filter Reference » Image Thresholding » ThresholdToRegion_Color
Creates a region containing image pixels with values close to the given color.
Name | Type | Range | Description | |
---|---|---|---|---|
inImage | Image | Input image | ||
inRoi | Region* | Region of interest | ||
inRgbColor | Pixel | Color to compare the image to | ||
inChromaAmount | Real | 0.0 - 1.0 | Proportion of chromatic information in distance computation | |
inMaxDifference | Real | 0.0 - | Maximum difference between image pixel and model color | |
inHysteresis | Real | 0.0 - | Defines how much the difference criterium is lowered for pixels neighboring with other foreground pixels | |
outRegion | Region | Output region |
Only the following inImage pixel formats are supported: 1xuint8, 2xuint8, 3xuint8, 4xuint8
Applications
Color analysis with a given reference color.
Hints
- Define the reference color by setting the inRgbColor input. You can use the Color Picker tool on an image preview and then copy-and-paste the value.
- Increase inChromaAmount to make the filter less sensitive to changes in brightness. Decrease it to make brightness more important.
- Set inMaxDifference experimentally to a value that best separates the foreground and background pixels.
Examples
Description of usage of this filter can be found in examples and tutorial: Rubber Ring.
Hardware Acceleration
This operation is optimized for SSE2 technology for pixels of types: 1xUINT8, 3xUINT8.
This operation supports automatic parallelization for multicore and multiprocessor systems.
Complexity Level
This filter is available on Basic Complexity Level.
Filter Group
This filters is member of ThresholdToRegion filter group.