ColorTools - Maple Programming Help

Online Help

All Products    Maple    MapleSim


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

ColorTools

  

ToDisplayable

  

compute a nearby color that can be represented in RGB

 

Calling Sequence

Parameters

Description

Examples

Compatibility

Calling Sequence

ToDisplayable(color)

Parameters

color

-

color in a format recognized by ColorTools

Description

• 

Many colors in the device independent colors spaces, such as CIE Lab, cannot be exactly represented in RGB and displayed on a monitor.  The ToDisplayable command computes a nearby color that can be represented in RGB and thus displayed.

• 

Color Object that is not exactly displayable will be displayed with asterisks around the color space when the color object is printed.

• 

By default a nearby color is determined by moving along the line towards the 50% gray in the CIE XYZ color space until a displayable color is reached.

• 

Simpler algorithms which truncate the color into a 0 to 1 range in RGB or HSV color space can be used instead by specifying the mode option.

Examples

withColorTools:

CColorXYZ,Convert0.75,1.01,1.01,RGB,XYZ

C*XYZ* : 0.766 0.916 1.1

(1)

ToDisplayableC

XYZ : 0.753 0.898 1.08

(2)

ToDisplayableC,mode=RGB

XYZ : 0.754 0.898 1.08

(3)

ToDisplayableC,mode=HSV

XYZ : 0.749 0.896 1.08

(4)

Compatibility

• 

The ColorTools[ToDisplayable] command was introduced in Maple 18.

• 

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

See Also

ColorTools

ColorTools/ColorSpaces

ColorTools[Color]