ForHosting KIT · Imagens

Converter RGB para HSL

Obtenha os valores HSL de uma cor RGB com quatro casas decimais: 255, 128, 64 é matiz 20.1047°, saturação 100 % e luminosidade 62.549 %. Canais com decimais, vindos de cores misturadas ou interpoladas, também funcionam. Grátis no seu navegador.

  • Grátis
  • Funciona no seu navegador
  • Sem cadastro
  • Seus dados não saem do seu aparelho
Use pelo WebAPIE-mailTelegramApp em breve
Se você digitar
Resistência (Ω)
255
G
128
B
64
Você obtém
Hue
20,1047
Saturação
100
Luminosidade
62,549

Converta uma cor RGB em seu equivalente HSL e receba um resultado compacto e previsível, fácil de usar em ferramentas de design, folhas de estilo e código de aplicativos. Informe os canais vermelho, verde e azul entre 0 e 255. O conversor retorna o matiz em um círculo de 0–360 graus e a saturação e a luminosidade como porcentagens de 0 a 100. Canais ausentes, não numéricos, infinitos ou fora do intervalo são rejeitados, em vez de corrigidos silenciosamente, para que os erros continuem visíveis e os dados posteriores sejam confiáveis.

Informe os canais RGB corretamente

Forneça três campos numéricos para vermelho, verde e azul usando os nomes abreviados r, g e b. Cada canal deve ficar entre 0 e 255, inclusive. Zero indica que o canal não contribui com intensidade, enquanto 255 representa intensidade total.

Valores decimais intermediários também são permitidos, o que ajuda quando outro cálculo produz cores interpoladas. O conversor não limita valores inválidos de propósito. Se um canal for negativo, maior que 255, ausente, não numérico ou infinito, a solicitação retornará um erro de entrada.

Esse comportamento rigoroso torna fluxos automatizados mais seguros, pois um valor de origem inválido não pode virar silenciosamente uma cor plausível, porém incorreta. Para um primeiro teste conhecido, use r 255, g 0 e b 0; o resultado será vermelho com matiz de zero grau, saturação total e cinquenta por cento de luminosidade. Ao copiar valores de CSS, envie apenas os números dos canais, sem o invólucro rgb(), vírgulas ou sinais de porcentagem.

Manter a entrada numérica também evita confusão entre a escala RGB de 0–255 e a notação percentual adotada por alguns sistemas de design.

Entenda como o resultado HSL é calculado

A conversão primeiro normaliza cada canal RGB dividindo-o por 255. Depois, identifica o maior e o menor canal normalizado. A média entre eles se torna a luminosidade, e a diferença, chamada croma, determina se a cor tem saturação e um matiz significativo.

Quando o croma é zero, a cor é um tom de cinza: a saturação é zero e o matiz retorna como zero por convenção, porque nenhuma posição no círculo cromático é visualmente distinta. Para cores cromáticas, a saturação corresponde ao croma ajustado à luminosidade atual, e o matiz depende de qual canal RGB é o maior. Vermelho, verde e azul ocupam setores diferentes do círculo, e as diferenças relativas selecionam a posição dentro do setor.

O matiz retornado é expresso em graus desde zero até menos de 360. Saturação e luminosidade são multiplicadas por 100 e expressas em porcentagens. Os resultados são arredondados para quatro casas decimais, oferecendo precisão útil com respostas estáveis e legíveis.

Essa é a transformação RGB para HSL padrão: ela reorganiza as mesmas informações e não aplica gerenciamento de cores, correção de gama nem conversão de perfis.

Use HSL em fluxos de design e aplicativos

HSL costuma ser mais fácil de interpretar que RGB quando você precisa criar variações. O matiz identifica a família da cor, a saturação controla quanto ela parece viva ou acinzentada, e a luminosidade a aproxima do preto ou do branco. Depois de converter uma cor de marca, você pode manter o matiz e ajustar a luminosidade para estados de foco, pressionado ou desativado.

Um pipeline de dados pode normalizar registros de cores variados em uma representação HSL comum antes de ordenar ou agrupar. Uma verificação de qualidade também pode comparar os valores retornados com tokens de design e rejeitar canais RGB malformados logo no início. Lembre-se de que alterações numéricas iguais não garantem mudanças visuais iguais; HSL é prático para controles, mas não é um espaço de cor perceptualmente uniforme.

Preserve também os valores RGB originais quando conversões reversas exatas forem importantes, pois o arredondamento pode causar uma pequena diferença na volta. A operação é determinística e depende apenas dos números fornecidos: não acessa a rede, não usa aleatoriedade, relógio ou banco de cores externo.

Criar controles de cor

Converta canais RGB armazenados antes de exibir controles de matiz, saturação e luminosidade em um editor.

Produzir variantes de interface

Descubra os valores HSL de uma cor-base e ajuste a luminosidade ou a saturação para estados interativos.

Normalizar registros de cores

Transforme campos RGB em uma estrutura HSL consistente para dados, testes ou relatórios do aplicativo.

Quais valores RGB são aceitos?

Cada campo r, g e b deve ser um número finito entre 0 e 255, incluindo os limites.

Quais intervalos o resultado utiliza?

O matiz usa graus de 0 a 360; saturação e luminosidade usam porcentagens de 0 a 100.

Qual matiz é retornado para tons de cinza?

O cinza não possui matiz visualmente significativo; por convenção, retornam-se zero grau e zero por cento de saturação.

Canais fora do intervalo são limitados?

Não. Qualquer valor abaixo de 0 ou acima de 255 gera erro de entrada para manter visíveis os problemas na origem.

Devo colar o texto rgb() inteiro da minha folha de estilo?

Não. Digite só os três números dos canais, sem o rgb(), as vírgulas ou os sinais de porcentagem. Isso também evita confundir a escala de 0 a 255 com a notação RGB em porcentagem usada por alguns sistemas de design.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/color/rgb-to-hsl

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/color/rgb-to-hsl \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"r":255,"g":128,"b":64}'
{
  "r": 255,
  "g": 128,
  "b": 64
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "color.rgb_to_hsl",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Use HSL em fluxos de design e aplicativos

Assim, entradas idênticas geram saídas idênticas em chamadas repetidas, algo adequado para testes, scripts de build, integrações API e ferramentas reproduzíveis de sistemas de design.

Quanto custa uma conversão pela API?

Cada solicitação API custa US$ 0,002. A experiência no navegador pode executar localmente a mesma conversão determinística.

Ver a documentação completa do KIT →