Calcul de luminosité perçue

Il emploie la formule RGB pondérée habituelle, qui accorde la plus forte influence au vert, puis au rouge et enfin au bleu. Le résultat est classé comme clair ou sombre selon un seuil documenté, puis associé à une suggestion de texte noir ou blanc. Utilisez-le lorsqu’un thème, un badge, un graphique ou un arrière-plan choisi par l’utilisateur exige un premier plan immédiat et reproductible.

Pourquoi la luminosité perçue pondère les canaux RGB

Une moyenne simple suppose que la vision humaine réagit de la même manière au rouge, au vert et au bleu. Ce n’est pas le cas. Le vert contribue bien davantage à la luminosité perçue, le rouge apporte une part intermédiaire et le bleu une part plus faible. Ce calculateur applique donc les coefficients classiques de luminance de type BT.601 : 0.299 pour le rouge, 0.587 pour le vert et 0.114 pour le bleu. Chaque canal doit être un entier compris entre 0 et 255. La somme pondérée donne un indice sur la même échelle approximative de 0 à 255, où le noir vaut zéro et le blanc 255. Le résultat est arrondi à trois décimales pour rester lisible tout en conservant une précision utile. Le calcul est déterministe : des entrées RGB identiques produisent toujours la même sortie, sans profil colorimétrique, réseau, hasard ni réglage propre à l’appareil. Il convient aux décisions rapides d’interface, mais ne remplace pas une analyse complète d’accessibilité ou de gestion des couleurs.

Comment la classe claire ou sombre détermine le texte

Après le calcul de la luminosité perçue, la capacité compare l’indice au seuil 128. Une valeur supérieure ou égale à 128 est classée comme claire, tandis qu’une valeur inférieure est classée comme sombre. Sur un fond clair, la réponse recommande un texte noir ; sur un fond sombre, elle recommande un texte blanc. La sortie contient les canaux d’origine, l’indice précis, la classe, la couleur de texte conseillée, le seuil et la formule. Votre application peut ainsi enregistrer ou auditer la décision sans dépendre d’un booléen opaque. La limite est explicite : une valeur exactement égale à 128 appartient à la classe claire. Ce choix garantit un comportement cohérent entre les clients. La recommandation fournit un premier plan binaire pratique pour les libellés, pastilles, avatars générés et aperçus de thèmes. Elle ne garantit pas la conformité de toute police ou taille à une norme d’accessibilité ; pour cela, utilisez un vérificateur de rapport de contraste.

Validez les canaux et exploitez le résultat correctement

Envoyez les composantes RGB dans les champs r, g et b. Les trois champs sont obligatoires, numériques, entiers et compris dans l’intervalle inclusif de 0 à 255. Les valeurs telles que -1, 256, un canal décimal, une chaîne numérique, NaN ou un champ absent sont rejetées comme entrées invalides au lieu d’être corrigées silencieusement. Cette validation stricte évite de masquer une erreur de conversion en amont et d’obtenir un rendu enregistré différent de son aperçu. Après une réponse valide, utilisez classification si vous avez seulement besoin d’une branche claire ou sombre, ou appliquez directement recommended_text_color si l’interface accepte une couleur hexadécimale. perceived_brightness permet de trier des échantillons ou de présenter le calcul. L’API coûte $0.002 par requête, tandis que le navigateur peut exécuter localement le même calcul déterministe. Pour une grande palette, calculez chaque couleur une seule fois et conservez le résultat avec ses valeurs RGB sources.