Calcular brilho percebido

Ela usa a conhecida fórmula RGB ponderada, na qual o verde exerce a maior influência, seguido pelo vermelho e pelo azul. O resultado é classificado como claro ou escuro com um limite documentado e recebe uma sugestão de texto preto ou branco. Use a ferramenta quando um tema, selo, gráfico ou fundo escolhido pelo usuário precisar de uma decisão de primeiro plano imediata e reproduzível.

Por que o brilho percebido pondera os canais RGB

Uma média simples trata vermelho, verde e azul como se a visão humana respondesse igualmente a todos, o que não acontece. O verde contribui muito mais para o brilho percebido, o vermelho tem uma participação intermediária e o azul contribui menos. Por isso, esta calculadora aplica os pesos clássicos de luminância no estilo BT.601: 0.299 para vermelho, 0.587 para verde e 0.114 para azul. Cada canal deve ser um número inteiro de 0 a 255. A soma ponderada produz uma pontuação na mesma escala aproximada de 0 a 255, em que preto é zero e branco é 255. A pontuação é arredondada para três casas decimais, mantendo precisão útil e leitura fácil. A operação é determinística: entradas RGB idênticas sempre geram a mesma saída, sem consulta a perfil de cor, acesso à rede, aleatoriedade ou ajuste específico do dispositivo. É uma estimativa rápida e compreensível para interfaces, não uma análise completa de gerenciamento de cores ou acessibilidade.

Como a classificação clara ou escura escolhe o texto

Depois de calcular o brilho percebido, a capacidade compara a pontuação ao limite 128. Uma pontuação igual ou superior a 128 é classificada como clara; abaixo desse valor, é classificada como escura. Para um fundo claro, a resposta recomenda texto preto; para um fundo escuro, recomenda texto branco. A saída traz os canais originais, a pontuação precisa, a classificação, a cor de texto sugerida, o limite e a fórmula. Assim, sua aplicação pode armazenar e auditar a decisão sem depender de um booleano sem documentação. A fronteira é explícita: uma pontuação exatamente igual a 128 pertence à classe clara. Isso evita resultados diferentes entre clientes perto do corte. A recomendação é uma escolha binária conveniente para rótulos, chips, avatares gerados e prévias de temas. Ela não garante que todo tamanho de fonte ou tratamento visual atenda a uma norma específica; para conformidade formal, use um verificador de relação de contraste.

Valide os canais e use o resultado com segurança

Envie os componentes RGB nos campos r, g e b. Todos são obrigatórios, precisam ser numéricos, inteiros e permanecer no intervalo inclusivo de 0 a 255. Valores como -1, 256, um canal fracionário, uma string numérica, NaN ou um campo ausente são rejeitados como entrada inválida, em vez de serem ajustados silenciosamente. Essa rejeição rigorosa importa porque o ajuste pode esconder erros anteriores de conversão e fazer um design salvo divergir da prévia. Depois de receber uma resposta válida, use classification quando precisar apenas da ramificação clara ou escura, ou aplique recommended_text_color diretamente se a interface aceitar uma cor hexadecimal. Use perceived_brightness para ordenar amostras ou exibir o cálculo. A API custa US$ 0,002 por solicitação, enquanto o navegador pode executar localmente o mesmo cálculo determinístico. Em paletas grandes, calcule uma vez por cor e guarde o resultado com os valores RGB de origem para preservar a decisão.