SATURATE function

SATURATE(Color, Amount) SATURATE(Color; Amount)

Color

Color or { Color }

The color to saturate.

Amount

Number or { Number }

A number between 0 and 100 (inclusive), where 0 means that no modifications should be made and 100 means that the resulting color should be fully saturated.

Returns

Color or { Color }

A saturated version of the given color.

Saturates the given color by a specified amount. The implementation uses the Hue-Saturation-Lightness (HSL) color model to linearly increase the saturation with the given amount. Use DESATURATE to perform the reverse operation.

This function is Calcapp-specific.

Examples

SATURATE(Color.AliceBlue, 50)SATURATE(Color,AliceBlue; 50)

Returns a variant of the alice blue color, which has been saturated by 50 percent.

SATURATE({ Color.AliceBlue, Color.Azure }, 50)SATURATE({ Color,AliceBlue; Color,Azure }; 50)

Returns variants of the alice blue and azure colors, which have both been saturated by 50 percent.

SATURATE({ Color.AliceBlue, Color.Azure }, { 50, 25 })SATURATE({ Color,AliceBlue; Color,Azure }; { 50; 25 })

Returns variants of the alice blue and azure colors, which have been saturated by 50 and 25 percent, respectively.