Adjust - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Mozilla Firefox.

Online Help

All Products    Maple    MapleSim


ColorTools

  

Adjust

  

create a new color with different lightness and chroma

 

Calling Sequence

Parameters

Description

Examples

Compatibility

Calling Sequence

Adjust(color, chroma=c, lightness=l)

Parameters

color

-

color format recognized by ColorTools

c

-

(optional) numeric adjustment to chroma between -100 and 100

l

-

(optional) numeric adjustment to lightness between -100 and 100

Description

• 

The Adjust command creates a new Color structure which has the same hue as the input color, but with altered lightness and/or saturation. It uses the cylindrical perceptual color space LCH to make the adjustment and then projects back to a displayable color in the original colorspace unless the raw option is given.

• 

Contrast this command with the quartet of Lighten, Darken, Saturate, and Desaturate which use the HSV non-perceptual colorspace.

Examples

> 

with⁡ColorTools:

> 

Adjust⁡DarkRed,lightness=15::Lighten⁡DarkRed,1.5

⟨RGB : 0.771 0.204 0.129⟩::⟨RGB : 0.818 0 0⟩

(1)
> 

Adjust⁡DarkRed,lightness=−15::Darken⁡DarkRed,1.5

⟨RGB : 0.191 0.00669 0.00226⟩::⟨RGB : 0.363 0 0⟩

(2)
> 

Adjust⁡DarkRed,lightness=45,raw::Adjust⁡DarkRed,lightness=45

⟨*RGB* : 1.14 0.476 0.362⟩::⟨RGB : 1 0.572 0.488⟩

(3)
> 

Adjust⁡DarkRed,chroma=15::Saturate⁡DarkRed,1.5

⟨RGB : 0.538 0.00956 0.00309⟩::⟨RGB : 0.545 0 0⟩

(4)
> 

Adjust⁡DarkRed,chroma=−15::Desaturate⁡DarkRed,1.5

⟨RGB : 0.512 0.108 0.0582⟩::⟨RGB : 0.545 0.182 0.182⟩

(5)
> 

Adjust⁡DarkRed,chroma=15,raw::Adjust⁡DarkRed,chroma=15

⟨*RGB* : 0.573 -0.134 -0.0315⟩::⟨RGB : 0.538 0.00956 0.00309⟩

(6)

Compatibility

• 

The ColorTools[Adjust] 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]

ColorTools[Darken]

ColorTools[Desaturate]

ColorTools[Lighten]

ColorTools[Saturate]

ColorTools[ToDisplayable]