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.