Wahrgenommene Helligkeit

Er verwendet die bekannte gewichtete RGB-Formel, bei der Grün den größten Einfluss hat, gefolgt von Rot und Blau. Das Ergebnis wird anhand eines dokumentierten Grenzwerts als hell oder dunkel eingestuft und mit einer Empfehlung für schwarzen oder weißen Text versehen. Verwenden Sie den Rechner, wenn ein Theme, ein Badge, ein Diagramm oder ein benutzerdefinierter Hintergrund sofort eine nachvollziehbare Vordergrundfarbe benötigt.

Warum die wahrgenommene Helligkeit RGB-Kanäle gewichtet

Ein einfacher Mittelwert behandelt Rot, Grün und Blau so, als würde das menschliche Auge auf alle drei Kanäle gleich reagieren. Das trifft nicht zu. Grün trägt erheblich stärker zur wahrgenommenen Helligkeit bei, Rot hat einen mittleren und Blau einen geringeren Anteil. Deshalb nutzt dieser Rechner die klassischen Luminanzgewichte nach dem Muster BT.601: 0.299 für Rot, 0.587 für Grün und 0.114 für Blau. Jeder Kanal muss eine ganze Zahl zwischen 0 und 255 sein. Aus der gewichteten Summe entsteht ein Wert auf derselben ungefähren Skala von 0 bis 255, auf der Schwarz null und Weiß 255 entspricht. Das Ergebnis wird auf drei Dezimalstellen gerundet und bleibt dadurch gut lesbar, ohne nützliche Genauigkeit zu verlieren. Die Berechnung ist deterministisch: Gleiche RGB-Eingaben liefern stets dieselbe Ausgabe, ohne Farbprofilabfrage, Netzwerkzugriff, Zufall oder gerätespezifische Anpassung. Sie eignet sich für schnelle UI-Entscheidungen, ersetzt jedoch keine vollständige Farbmanagement- oder Barrierefreiheitsanalyse.

Wie die Einstufung in hell oder dunkel die Textfarbe bestimmt

Nach der Berechnung vergleicht die Fähigkeit den Helligkeitswert mit dem Grenzwert 128. Ein Wert ab 128 wird als hell eingestuft, ein niedrigerer Wert als dunkel. Für einen hellen Hintergrund empfiehlt die Antwort schwarzen Text, für einen dunklen Hintergrund weißen Text. Die Ausgabe enthält die ursprünglichen Kanäle, den genauen Wert, die Einstufung, die empfohlene Textfarbe, den Grenzwert und die Formel. So kann Ihre Anwendung die Entscheidung speichern und prüfen, statt sich auf einen undokumentierten booleschen Wert zu verlassen. Die Grenze ist eindeutig: Ein Wert von genau 128 gehört zur hellen Klasse. Dadurch verhalten sich verschiedene Clients am Übergang identisch. Die Empfehlung ist eine praktische binäre Wahl für Beschriftungen, Chips, generierte Avatare und Theme-Vorschauen. Sie garantiert nicht, dass jede Schriftgröße oder Gestaltung eine bestimmte Norm erfüllt; verwenden Sie für einen formalen Nachweis einen Kontrastverhältnis-Prüfer.

Kanäle validieren und das Ergebnis sicher verwenden

Übermitteln Sie die RGB-Komponenten in den Feldern r, g und b. Alle drei Felder sind erforderlich, müssen numerisch und ganzzahlig sein und im einschließlich geltenden Bereich von 0 bis 255 liegen. Werte wie -1, 256, ein Bruchwert, eine numerische Zeichenfolge, NaN oder ein fehlendes Feld werden als ungültige Eingabe abgelehnt und nicht unbemerkt begrenzt. Diese strenge Prüfung verhindert, dass vorgelagerte Konvertierungsfehler verborgen bleiben und ein gespeichertes Design von seiner Vorschau abweicht. Nutzen Sie nach einer gültigen Antwort classification, wenn nur zwischen hell und dunkel verzweigt werden soll. Verwenden Sie recommended_text_color direkt, wenn Ihre Oberfläche eine hexadezimale Vordergrundfarbe annimmt. Mit perceived_brightness können Sie Farbfelder sortieren oder die Berechnung anzeigen. Die API kostet $0.002 pro Anfrage; im Browser lässt sich dieselbe deterministische Berechnung lokal ausführen. Speichern Sie bei großen Paletten das einmal berechnete Ergebnis zusammen mit den RGB-Quellwerten.