2.5.4.72 MsoShade

  • Article

The MsoShade function performs a modification to a color by decreasing the luminance component, as specified in the HSL color space, by a percentage.

ABNF:

 MsoShade = val val " MSOSHADE():128"

Required Arguments:

Name: Color

Type: vColor

An argument that specifies the color.

Name: Delta

Type: vSignedInt

An argument that specifies the percentage to decrease the luminance of Color. If the value is less than zero, the luminance is increased.

Return Value:

Type: PtgColorRGB

This function returns a PtgColorRGB containing the shaded color. If Delta is greater than zero, the luminance of Color is decreased by the percentage specified by the absolute value of Delta. If Delta is less than zero, the luminance of Color is increased by the following amount: the percentage specified by Delta multiplied by the result of 240 minus the luminance of Color. If Delta is less than -100, the function sets the value to -100 and performs the operation. If Delta is greater than 100, the function sets the value to 100 and performs the operation.