You are here: Start » Filter Reference » Image Metrics » ColorDistanceImage
ColorDistanceImage
Compares each pixel with the specified color using chromatic and non-chromatic information.
| Name | Type | Range | Description | |
|---|---|---|---|---|
 |
inImage | Image | Unsigned color image used in comparison | |
|
inRoi | Region* | Range of pixels to be processed | |
|
inRgbColor | Pixel | Color to compare the image to | |
|
inChromaAmount | Real | 0.0 - 1.0 | Proportion of chromatic information in distance computation |
 |
outValueImage | Image | Unsigned image of distances | |
Only the following inImage pixel formats are supported: 1xuint8, 2xuint8, 3xuint8, 4xuint8
Applications
Description
The operation computes the distance between each pixel of inImage and a specified color, presenting result as a monochromatic image. Input image should be in RGB color space.
Distance between pixels is computed using two measures:
- Value distance - difference between pixel average values.
- Chromatic distance - euclidean distance between pixel colors interpreted as points in N-dimensional space ( where N denotes the number of pixel channels ) rescaled to the (0.0 - 255.0) range.
The resulting distance is computed as a weighted average of these two values, parameter inChromaAmount ( 0.0 - 1.0 ) being the weight of the chromatic distance, and 1 - inChromaAmount being the weight of the value distance.
Examples
 |
 |
ColorDistanceImage run with inRgbColor = 
, inChromaAmount = 0.8
Hardware Acceleration
This operation supports automatic parallelization for multicore and multiprocessor systems.
Errors
This filter can throw an exception to report error. Read how to deal with errors here: Error Handling
| Error type | Description |
|---|---|
| RuntimeError | Each pixel component of inRgbColor must be nonnegative in ColorDistanceImage |
Complexity Level
This filter is available on Advanced Complexity Level.
