ColorDescription - Maple Help

Online Help

All Products    Maple    MapleSim


ColorTools

  

ColorDescription

  

compute a descriptive name for a color

 

Calling Sequence

Parameters

Description

Examples

Compatibility

Calling Sequence

ColorDescription(color)

ColorDescription(color, short)

Parameters

color

-

color format recognized by ColorTools

Description

• 

The ColorDescription command returns a string with a description of the input color.

• 

The description is based on the HSV representation of the color and is usually three parts: a lightness description, a saturation description, and a hue description, in that order.

– 

The lightness description is one of "Blackish", "Very Dark", "Dark", "Medium", "Light", "Very Light", or "Whitish".

– 

The saturation description is one of: "Pale", "Faded", "Strong", or "Vivid"

– 

The hue description will be either Gray, or one of:

• 

A pure hue: Red, Yellow, Orange, Green, Blue, or Purple.

• 

or an adjacent pair of the above hues combined with a space; this indicates that the color is near the mid-point of the two hues but is slightly closer to the second color.

• 

An adjacent pair of the above hues with the first modified with the suffix "ish". This indicated that the color is nearer the second hue but shaded slightly in the direction of the first.

• 

If the short option is given:

– 

the lightness description is "Light", "Dark", or none.

– 

the saturation description is "Pale" or none.

– 

the "ish" hue descriptions are "rounded" up or down to pure hues or combined hues.

• 

The description returned can be used as an input for the Color constructor by adding the palette specifier "Generic" to the beginning. This will not result in a perfect round trip for the vast majority of colors.

Examples

withColorTools:

ColorDescriptionDarkOrchid

Medium Faded Bluish Purple

(1)

ColorRGB,Generic Medium Faded Bluish Purple

RGB : 0.682 0.212 0.839

(2)

ColorDescriptionDarkOrchid,short

Blue Purple

(3)

ColorRGB,Generic Blue Purple

RGB : 0.58 0.0824 0.969

(4)

ColorDescriptionColor10,10,10

Black

(5)

Compatibility

• 

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

• 

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

See Also

ColorTools

ColorTools[Color]

ColorTools[ColorSpaces]

ColorTools[NearestNamedColor]

ColorTools[RGB24ToName]