Função HSL

Retorna um valor que representa um índice na paleta de cores do documento. Ele especifica uma cor por seus componentes de tonalidade, saturação e luminosidade.

Sintaxe

HSL(matiz, saturação, luminosidade )

Parâmetros

Name	Obrigatório/opcional	Tipo de dados	Descrição
Matiz	Obrigatório	Número	A matiz da cor, expressa como um número entre 0 e 239, inclusive, ou uma expressão que é avaliada neste número.
Saturação	Obrigatório	Número	A saturação da cor, expressa como um número entre 0 e 240, inclusive, ou uma expressão que é avaliada neste número.
Luminosidade	Obrigatório	Número	A luminosidade da cor, expressa como um número entre 0 e 240, inclusive, ou uma expressão que é avaliada neste número.

Valor de retorno

Número

Comentários

Se a cor retornada pela função ainda não existir na paleta de cores do documento atual, ela será adicionada à lista de documentos de cores disponíveis.

A tabela a seguir relaciona algumas cores padrão e seus valores de matiz, saturação e luminosidade.

Color	Valor de matiz	Valor de saturação	Valor de luminosidade
Preto	0	0	24
Azul	160	240	120
Verde	80	240	120
Ciano	120	240	120
Vermelho	0	240	120
Magenta	200	240	120
Amarelo	40	240	120
Branco	0	0	240

Exemplo 1

HSL(160.240.120)

Retornará o índice da cor azul.

Exemplo 2

HSL(HUE(FillForegnd),SAT(FillForegnd),MIN(LUM(FillForegnd)+100.240))

Retornará o índice de uma cor que espelha a cor de preenchimento de primeiro plano com uma luminosidade crescente.