LUM Function

Returns the value of a color's luminosity component.

Syntax

LUM(expression)

Parameters

Name

Required/Optional

Data Type

Description

expression

Required

Numeric

The index of a color in the document's color table, or a reference to a cell that contains a color index.

Return Value

Number

Remarks

The return value is a number in the range 0 to 240, inclusive. The function returns 0 for invalid input.

Example 1

LUM(Sheet.4!FillForegnd)

Returns the luminosity of Sheet.4's fill foreground color.

Example 2

LUM(6)

Returns 120 if the document uses the default Visio color palette, where magenta is the color at index 6.

Example 3

LUM(HSL(10, 20, 30))

Returns 30.