Calcular brillo percibido

Emplea la conocida fórmula RGB ponderada, que atribuye la mayor influencia al verde, después al rojo y por último al azul. El resultado se clasifica como claro u oscuro mediante un umbral documentado y se acompaña de un color de texto negro o blanco recomendado. Úsela cuando un tema, una insignia, un gráfico o un fondo elegido por el usuario necesite una decisión de primer plano inmediata y reproducible.

Por qué el brillo percibido pondera los canales RGB

Un promedio simple supone que la vista humana responde igual al rojo, al verde y al azul, pero no es así. El verde influye mucho más en el brillo que percibimos, el rojo tiene una aportación intermedia y el azul, una menor. Por ello, esta calculadora aplica los pesos clásicos de luminancia del estilo BT.601: 0.299 para el rojo, 0.587 para el verde y 0.114 para el azul. Cada canal debe ser un entero entre 0 y 255. Los valores ponderados se suman para obtener una puntuación en la misma escala aproximada de 0 a 255, donde el negro vale cero y el blanco, 255. La puntuación se redondea a tres decimales para conservar una precisión útil sin perder legibilidad. La operación es determinista: los mismos datos RGB siempre producen idéntico resultado, sin consultar perfiles de color, usar la red, introducir azar ni depender del dispositivo. Resulta especialmente práctica para decisiones rápidas de interfaz, aunque no sustituye un análisis completo de accesibilidad o gestión del color.

Cómo la clasificación clara u oscura elige el texto

Después de calcular el brillo percibido, la capacidad compara la puntuación con el umbral 128. Una puntuación igual o superior a 128 se clasifica como clara; una inferior se considera oscura. Para un fondo claro, la respuesta recomienda texto negro y, para uno oscuro, texto blanco. La salida incluye los canales originales, la puntuación precisa, la clasificación, el color de texto recomendado, el umbral y la fórmula. Así, su aplicación puede guardar o auditar la decisión sin depender de un booleano sin documentar. El límite es explícito: una puntuación exactamente igual a 128 pertenece a la clase clara. Este criterio evita diferencias sutiles entre clientes. La recomendación ofrece una elección binaria cómoda para etiquetas, fichas, avatares generados y vistas previas de temas. No garantiza que cualquier tipografía o tamaño cumpla una norma concreta de accesibilidad; para verificar conformidad formal, utilice una calculadora de relación de contraste.

Valide los canales y utilice el resultado con seguridad

Envíe los componentes RGB en los campos r, g y b. Los tres son obligatorios, deben ser numéricos, enteros y estar dentro del intervalo inclusivo de 0 a 255. Valores como -1, 256, una fracción, una cadena numérica, NaN o un campo ausente se rechazan como entrada no válida, en lugar de limitarse silenciosamente. Esta validación estricta es importante porque el recorte puede ocultar errores de conversión anteriores y hacer que un diseño guardado difiera de su vista previa. Tras recibir una respuesta válida, use classification si solo necesita una rama clara u oscura, o aplique recommended_text_color directamente si la interfaz acepta un color hexadecimal. Utilice perceived_brightness para ordenar muestras o mostrar el cálculo. La API cuesta $0.002 por solicitud, mientras que el navegador puede ejecutar localmente el mismo cálculo determinista. Para paletas grandes, calcule una vez cada color y conserve el resultado junto a sus valores RGB de origen.