LIGHTEN function

LIGHTEN(Color, Amount) LIGHTEN(Color; Amount)

Color

Color or { Color }

The color to lighten.

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 white.

Returns

Color or { Color }

A lightened version of the given color.

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

This function is Calcapp-specific.

Examples

LIGHTEN(Color.Red, 20)LIGHTEN(Color,Red; 20)

Returns a variant of the default red color, which has been lightened by 20 percent.

LIGHTEN({ Color.Red, Color.Green }, 20)LIGHTEN({ Color,Red; Color,Green }; 20)

Returns variants of the default red and green colors, which have both been lightened by 20 percent.

LIGHTEN({ Color.Red, Color.Green }, { 10, 20 })LIGHTEN({ Color,Red; Color,Green }; { 10; 20 })

Returns variants of the default red and green colors, which have been lightened by 10 and 20 percent, respectively.