Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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.