ColorTools - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Graphics : Packages : ColorTools : ColorTools/Distance

ColorTools

  

Distance

  

compute the distance between two colors

 

Calling Sequence

Parameters

Options

Description

Examples

References

Compatibility

Calling Sequence

Distance(color1, color2)

Parameters

color1, color2

-

colors in formats recognized by ColorTools

Options

• 

metric : name or string the names accepted are cie76, cie94 (the default), cie00, or cmc.  The strings accepted are the names of color spaces.

• 

raw : if this option is given, the metric is not normalized

Description

• 

The Distance command computes the distance between two colors using one of several standard color metrics.  The metric can be chosen by passing a name to the metric option. The cie94, cie00, and cmc metrics are not commutative. For these metrics, color1 is the reference color and color2 is the sample color. In these metrics a distances of less than 0.01 mean the two colors are generally not visually distinguishable.

• 

If the metric option is passed a string, then the metric used is the Euclidean distance in the color space represented by that string.

• 

All metrics are normalized so that the distance between white and black is equal to 1 unless the raw option is given.

Examples

withColorTools:

DistanceRed,#e00

0.03644340870

(1)

Distance#fe0000,#ff0000,'metric'=RGB

0.002264119494

(2)

Distance0.99,0.,0.,1.,0.,0.,'metric'=RGB,'raw'

0.01000000000

(3)

References

  

Wikipedia, Color Difference, http://wikipedia.org/wiki/Color_difference

Compatibility

• 

The ColorTools[Distance] command was introduced in Maple 16.

• 

For more information on Maple 16 changes, see Updates in Maple 16.

See Also

ColorTools

ColorTools/ColorSpaces

ColorTools[Color]

 


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam