__header__
Description
The Color Distance Filter tool will create a monochrome filter
(greyscale) which allows you to measure how close a color is to a
trained (reference) color.
Using the Color Distance Filter
When the Color Distance Filter tool is dragged onto a
sequence/playlist a
small green box will appear on the viewer window. (When selected this
box will turn red.) This box can be moved and resized over any area in
the viewer window.
To train a color to use as your
reference
point first, drag the box over the color you wish to select.
To
train
the selected color, right-click the Color Distance Filter tool icon in
the
playlist and choose "Train". When you select "Train"
Automation
Manager will take a moment and create the Color Distance
Filter.
Once this process reaches 100% you can continue.
When running the Color Distance Filter tool in your program The result
will be a monochrome image. The color you selected as your reference point will
appear
black (or white if inverted is checked). The more similar a color is to your reference color
the
lighter it will appear in the new filter. The more dissimilar
a
color is to your reference color the darker it will appear.
Notice how the pink paper in the above image is now a dark grey, but
the green discs are a light grey.
Distance Algorithims
IPCOLORDIFFSumAbs:
Distance from trained color as a sum of the absolute Distances;
   = abs(tx - x)*m_Bias[0] +abs(ty - y)*m_Bias[1] + abs(tz - z)*m_Bias[2];
IPCOLORDIFFBlack:
Distance from Black;
   = x*m_Bias[0] + y*m_Bias[1] + z*m_Bias[2];
IPCOLORDIFFWhite:
Distance from White;
  = (3-x-y-z)*m_Bias[0] + (POS(x-tx) + POS(y-ty) + POS(z-tz))*m_Bias[1];
IPCOLORDIFFGeneric:
Sum Off Positive Component Distance from the Trained Color
IPCOLORDIFFGenericSQR:
Sum off Positive Squared Distance from the Trained Color
IPCOLORDIFFGenericSQRT:
Sum of Componet Positive Square root Distance from the Trained Color
IPCOLORDIFFDist:
default:
Euclidean distance
Note do not train if the color is passed as an input to the Train color
Inputs
CIFViewer
CIF
ROI
Parameters
Color Space
Distance Method
Invert
Smoothing
CreateOnLoad
Bias 1
Bias 2
Bias 3
UpdateViewer
RefreshViewer
CIF
TrainColor
__footer__