ColorTools - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Graphics : Packages : ColorTools : Color and Color Object Manipulation Commands : ColorTools/Desaturate

ColorTools

  

Desaturate

  

create a new color with lower saturation

 

Calling Sequence

Parameters

Description

Examples

Compatibility

Calling Sequence

Desaturate(color)

Desaturate(color, factor)

Parameters

color

-

color format recognized by ColorTools

factor

-

positive number

Description

• 

The Desaturate command creates a new Color structure which has the same hue and lightness as the input color (in the hardward dependent HSV colorspace), but its saturation is multiplied by a factor of 0.8. In other words, the new Color structure is less colorful by a factor of 0.8, if possible within the bounds of the HSV colorspace.

• 

If the optional parameter factor is given the output is desaturated by that factor if it is greater than 1, and the reciprocal otherwise. Use the Saturate command to increase the saturation.

• 

A more perceptually accurate saturation adjustment can be achieved using the Adjust command.

Examples

withColorTools:

DesaturateCoral

RGB : 1 0.598 0.451

(1)

DesaturateCoral,1.5

RGB : 1 0.665 0.542

(2)

DesaturateCoral,11.5

RGB : 1 0.665 0.542

(3)

DesaturateBlack

RGB : 0 0 0

(4)

Compatibility

• 

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

• 

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

See Also

ColorTools

ColorTools/ColorSpaces

ColorTools[Adjust]

ColorTools[Color]

ColorTools[Saturate]