Luminosità percepita

Applica la nota formula RGB ponderata, che attribuisce l’influenza maggiore al verde, poi al rosso e infine al blu. Il risultato viene classificato come chiaro o scuro rispetto a una soglia documentata e abbinato al colore di testo nero o bianco consigliato. Lo utilizzi quando un tema, un badge, un grafico o uno sfondo scelto dall’utente richiede una decisione immediata e riproducibile sul primo piano.

Perché la luminosità percepita pondera i canali RGB

Una media semplice considera rosso, verde e blu come se la vista umana rispondesse allo stesso modo a ciascun canale, ma non è così. Il verde contribuisce molto di più alla luminosità percepita, il rosso ha un peso intermedio e il blu un peso minore. Questo calcolatore applica quindi i coefficienti classici di luminanza in stile BT.601: 0.299 per il rosso, 0.587 per il verde e 0.114 per il blu. Ogni canale deve essere un numero intero compreso tra 0 e 255. La somma ponderata produce un indice sulla stessa scala approssimativa da 0 a 255, dove il nero vale zero e il bianco 255. Il risultato viene arrotondato a tre decimali per restare leggibile senza sacrificare una precisione utile. Il calcolo è deterministico: valori RGB identici producono sempre la stessa uscita, senza consultare profili colore, usare la rete, introdurre casualità o dipendere dal dispositivo. È ideale per decisioni rapide di interfaccia, non per un’analisi completa dell’accessibilità o della gestione cromatica.

Come la classe chiara o scura determina il testo

Dopo aver calcolato la luminosità percepita, la capacità confronta l’indice con la soglia 128. Un valore uguale o superiore a 128 viene classificato come chiaro, mentre un valore inferiore viene classificato come scuro. Per uno sfondo chiaro la risposta consiglia testo nero; per uno sfondo scuro consiglia testo bianco. L’uscita comprende i canali originali, l’indice preciso, la classificazione, il colore del testo consigliato, la soglia e la formula. La Sua applicazione può quindi conservare o verificare la decisione senza affidarsi a un valore booleano non documentato. Il confine è esplicito: un indice esattamente pari a 128 appartiene alla classe chiara. In questo modo il comportamento resta coerente tra client diversi. Il suggerimento è una scelta binaria pratica per etichette, chip, avatar generati e anteprime dei temi. Non garantisce che ogni carattere o dimensione soddisfi una specifica norma di accessibilità; per la conformità formale, utilizzi un controllo del rapporto di contrasto.

Convalidi i canali e usi il risultato in sicurezza

Invii i componenti RGB nei campi r, g e b. Tutti e tre sono obbligatori, devono essere numerici, interi e inclusi nell’intervallo da 0 a 255. Valori come -1, 256, un canale frazionario, una stringa numerica, NaN o un campo mancante vengono rifiutati come input non valido anziché essere corretti silenziosamente. Una convalida rigorosa è importante perché una correzione automatica può nascondere errori di conversione a monte e rendere un progetto salvato diverso dall’anteprima. Dopo una risposta valida, usi classification se Le serve soltanto una diramazione chiara o scura, oppure applichi direttamente recommended_text_color se l’interfaccia accetta un colore esadecimale. perceived_brightness è utile per ordinare campioni o mostrare il calcolo. L’API costa $0.002 per richiesta, mentre il browser può eseguire localmente lo stesso calcolo deterministico. Per tavolozze grandi, calcoli ogni colore una sola volta e conservi il risultato con i valori RGB di origine.