You are here: Start » Filter Reference » Image » Image Metrics » ColorDistance
Module: | FoundationPro |
---|
Compares two pixels using chromatic and non-chromatic information. Assumes RGB color space.
Applications
Name | Type | Range | Description | |
---|---|---|---|---|
inPixelA | Pixel | |||
inPixelB | Pixel | |||
inChromaAmount | Real | 0.0 - 1.0 | Proportion of chromatic information in distance computation | |
outDistance | Real |
Description
The operation computes the distance between two pixels.
The distance between pixels is computed using two measures:
- Value distance - the difference between average channel values
- Chromatic distance - euclidean distance between pixels normalized to the same value level
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
Errors
This filter can throw an exception to report error. Read how to deal with errors in Error Handling.
List of possible exceptions:
Error type | Description |
---|---|
RuntimeError | Each pixel component must be nonnegative in ColorDistance. |
Complexity Level
This filter is available on Advanced Complexity Level.
Filter Group
This filter is member of ColorDistance filter group.
See Also
- ColorDistanceImage – Compares each pixel with the specified color using chromatic and non-chromatic information.