Zum Inhalt springen
← Alle Artikel

QR-Code-Farbkontrast: Auf die Helligkeit kommt es an, nicht auf den Farbton

2026-11-07 · 7 Min. Lesezeit

QR-Code-Farbkontrast: Auf die Helligkeit kommt es an, nicht auf den Farbton

Auf dieser Seite
  1. Warum ein Scanner Helligkeit sieht, nicht Farbton
  2. So berechnest du die relative Leuchtdichte einer Hex-Farbe
  3. QR-Code-Farbkontrast in unseren Decoder-Tests
  4. Was ein Prüfgerät bewertet: Symbolkontrast nach ISO/IEC 15415
  5. Hell-auf-dunkel-Codes brauchen Unterstützung für Invertierung
  6. Ändere die Form, nicht die Helligkeit
  7. FAQ
  8. Quellen

Beim Farbkontrast eines QR-Codes läuft alles auf eine Zahl pro Farbe hinaus: wie hell sie ist. Der Open-Source-Decoder jsQR und die Java-Bibliothek von ZXing wandeln jedes Pixel in einen einzigen Grauwert um, bevor sie irgendetwas lesen – der Farbton fällt also weg. Marineblau und dunkles Lila werden als dunkel gelesen; Koralle als mittleres Grau, Gelb und Pastellrosa als helles Grau. Diese Helligkeit kannst du mit der Formel des W3C für die relative Leuchtdichte aus einem Hex-Code berechnen.

Fakten geprüft am 5. November 2026.

Warum ein Scanner Helligkeit sieht, nicht Farbton

Die Bibliothek jsQR wandelt das Bild zuerst in Graustufen um und gewichtet die Kanäle 0–255 jedes Pixels mit 0.2126 × Rot + 0.7152 × Grün + 0.0722 × Blau. Die Java-Bibliothek von ZXing berechnet, wenn sie RGB-Pixel erhält, das, was ihr Quellcode einen „grünbetonten Mittelwert“ nennt: (Rot + 2 × Grün + Blau) ÷ 4. Beide Formeln liefern eine Helligkeitszahl pro Pixel. Nach unserem Verständnis sehen zwei Farben mit gleicher Helligkeit für diese Decoder identisch aus, egal welchen Farbton sie haben.

Auch der Standard reduziert jedes Modul auf einen von zwei Werten. Das Referenz-Dekodierverfahren in der Ausgabe 2006 von ISO/IEC 18004 tastet an jedem Rasterpunkt einen Bereich von 3 × 3 Pixeln ab und entscheidet anhand eines globalen Schwellwerts „dunkel oder hell“.

Eine Ausnahme ist für den Druck wichtig. DENSO WAVE schreibt in seinen FAQ, dass QR-Code-Scanner rotes Licht verwenden; ein roter Code auf weißem Grund lässt sich deshalb nicht lesen, ebenso wenig ein blauer Code auf grünem Grund. Die Grundempfehlung lautet Schwarz auf Weiß. Wenn deine Codes von Rotlichtscannern gelesen werden, spielt also auch der Farbton eine Rolle. Wie Kamera-Apps auf Smartphones Farbe in Grau umwandeln, haben wir nicht überprüft.

So berechnest du die relative Leuchtdichte einer Hex-Farbe

Die Definition in WCAG 2.2 des W3C normiert die relative Leuchtdichte (relative luminance) auf 0 für das dunkelste Schwarz und 1 für das hellste Weiß. Für eine Hex-Farbe gilt:

  1. Teile den Hex-Code in Rot, Grün und Blau auf und dividiere jeden Wert durch 255.
  2. Linearisiere jeden Wert: Ist er 0.04045 oder kleiner, teile ihn durch 12.92; sonst berechne ((Wert + 0.055) ÷ 1.055) hoch 2.4.
  3. Addiere: L = 0.2126 × R + 0.7152 × G + 0.0722 × B.
  4. Vergleiche zwei Farben mit dem Kontrastverhältnis (contrast ratio) (L1 + 0.05) ÷ (L2 + 0.05), wobei L1 die hellere Farbe ist. Die Verhältnisse reichen von 1:1 bis 21:1.

Rechenbeispiel: Marineblau #1d3557. Die Kanäle sind 29, 53 und 87, also 0.1137, 0.2078 und 0.3412 nach der Division durch 255. Alle drei liegen über 0.04045 und werden daher zu 0.0123, 0.0356 und 0.0953 linearisiert. Gewichtet: 0.0026 + 0.0255 + 0.0069 = 0.035. Gegen Weiß (L = 1) ergibt sich 1.05 ÷ 0.085 = 12.4:1.

WCAG wurde für Text auf Webseiten geschrieben, nicht für QR-Codes. Das zugehörige Erfolgskriterium zum Kontrast verlangt mindestens 4.5:1 für normalen Text und 3:1 für großen Text, sagt, dass der berechnete Wert nicht gerundet werden soll (4.499:1 verfehlt 4.5:1), und erklärt, dass die Berechnung so angelegt ist, dass der Farbton kein entscheidender Faktor ist. Kein QR-Standard, den wir gelesen haben, verwendet WCAG-Werte; wir leihen uns die Formel, weil sie jeden Hex-Code in eine veröffentlichte, reproduzierbare Helligkeitszahl übersetzt. Umgestellt braucht eine Farbe ein L von etwa 0.183 oder weniger, um gegen reines Weiß 4.5:1 zu erreichen (unsere Rechnung).

Eine Reihe von zehn Farbfeldern von Schwarz bis Weiß, jeweils mit Hex-Code, relativer Leuchtdichte nach WCAG und Kontrastverhältnis gegen Weiß beschriftet: Schwarz 0.000 und 21.0:1, Marineblau #1d3557 0.035 und 12.4:1, Lila #7b1fa2 0.078 und 8.2:1, Rot #d7261e 0.159 und 5.0:1, Blau #1565c0 0.133 und 5.7:1, Grün #2e7d32 0.155 und 5.1:1, Koralle #e76f51 0.290 und 3.1:1, Gelb #f2c14e 0.576 und 1.7:1, Rosa #f8bbd0 0.601 und 1.6:1, Weiß 1.000 und 1.0:1

Für diesen Artikel erstellte Grafik; Werte mit der Formel aus WCAG 2.2 berechnet.

QR-Code-Farbkontrast in unseren Decoder-Tests

Am 5. November 2026 haben wir einen Prototyp-Code mit runden Punkten (Fehlerkorrekturstufe H, ein Kurzlink) in fünf Farbschemata gerendert und jeden mit jsQR und ZXing in 400, 240 und 160 px Breite dekodiert. Für ZXing haben wir zxing-wasm verwendet, eine WebAssembly-Version von ZXing-C++, nicht die oben zitierte Java-Bibliothek; wie sie Farbe in Grau umwandelt, haben wir nicht geprüft.

FarbschemaLeuchtdichte oder KontrastjsQR bei 400 / 240 / 160 pxZXing bei 400 / 240 / 160 px
Marineblau #1d3557 auf Weiß (Referenz)L 0.035, 12.4:1fehlgeschlagen / dekodiert / dekodiertbei allen drei dekodiert
Fünf dunkle Farben, pro Modul gemischtL 0.035–0.082fehlgeschlagen / dekodiert / dekodiertbei allen drei dekodiert
Fünf mittlere Farbtöne, pro Modul gemischtL 0.27–0.58bei allen drei fehlgeschlagenbei allen drei fehlgeschlagen
Pastell #c98aa0 auf #fde8ef2.4:1bei allen drei fehlgeschlagenbei allen drei dekodiert
Helle Punkte auf Marineblau (invertiert)Marineblauer Hintergrund, umgekehrtohne Invertierung bei allen drei fehlgeschlagen; mit Invertierung 2 von 3ohne Invertierung bei allen drei fehlgeschlagen; mit Invertierung 3 von 3

Fünf Versionen desselben QR-Codes mit grünen oder roten Markierungen für jeden Decoder und jede Breite: marineblaue Punkte auf Weiß, fünf dunkle Farben, fünf mittlere Farbtöne, Pastellrosa auf Zartrosa und helle Punkte auf Marineblau

Für diesen Artikel aus unseren Decoder-Testergebnissen erstellte Grafik.

Drei Befunde fallen auf. Der dunkle mehrfarbige Code wurde genau wie die einfarbige marineblaue Referenz dekodiert; der Fehlschlag von jsQR bei 400 px trat auch bei Marineblau auf, die Farben waren also nicht die Ursache. Die Palette mit mittleren Farbtönen wirkte genauso bunt und scheiterte überall; nach unserer Einschätzung liegen ihre helleren Module, etwa Gelb mit 1.7:1, zu nah am weißen Hintergrund. Beim Pastellcode waren sich die beiden Decoder uneinig – deshalb beweist eine einzelne erfolgreiche Dekodierung wenig. Decoder-Tests ersetzen nicht das Scannen gedruckter Probedrucke mit echten Smartphones, und kein Ergebnis hier verspricht, dass sich irgendein Design scannen lässt.

Was ein Prüfgerät bewertet: Symbolkontrast nach ISO/IEC 15415

ISO/IEC 18004 legt fest, dass QR-Symbole anhand der 2D-Druckqualitätsrichtlinien in ISO/IEC 15415 auf ihre Qualität zu prüfen sind. Die Ausgabe 2006 setzt außerdem die Note jedes Scans auf die niedrigste seiner Parameternoten, einschließlich des Symbolkontrasts, und die Gesamtnote des Symbols auf den Mittelwert mehrerer Scans. ISO/IEC 15415 selbst haben wir nicht gelesen; die folgenden Details stammen daher von Herstellern von Prüfgeräten (Herstellerdokumentation).

Das Handbuch des Prüfgeräts DataMan 475V von Cognex definiert den Symbolkontrast als Unterschied im Reflexionsgrad zwischen dem hellsten und dem dunkelsten Modul und bewertet ihn mit A ab 70 %, B ab 55 %, C ab 40 %, D ab 20 % und F unter 20 %. Axicon gibt an, dass die Version 2024 von ISO/IEC 15415 den Symbolkontrast aus den hellsten und dunkelsten 1 % der Pixel misst statt aus dem einzelnen hellsten und dunkelsten Wert.

Der Symbolkontrast ist eine Reflexionsmessung am gedruckten Code, keine aus einem Hex-Wert berechnete Zahl, und wir haben keine veröffentlichte Umrechnung von einem WCAG-Verhältnis in einen Symbolkontrast-Prozentwert gefunden. Nutze die Formel, um Farben am Bildschirm vorzusortieren; beurteile den Druck mit einem Prüfgerät oder mit Probedrucken.

Hell-auf-dunkel-Codes brauchen Unterstützung für Invertierung

Die Ausgabe 2006 von ISO/IEC 18004 sagt, Symbole seien dafür gedacht, gelesen zu werden, entweder dunkel auf hell oder hell auf dunkel, und ihr Dekodierverfahren erkennt die Reflexionspolarität an den Suchmustern. ISO hat im August 2024 eine vierte Ausgabe veröffentlicht, die wir nicht gelesen haben.

Decoder gehen unterschiedlich mit Invertierung um. Der Java-MultiFormatReader von ZXing versucht es nur dann erneut mit einem invertierten Bild, wenn der Aufrufer den Hinweis ALSO_INVERTED setzt. jsQR probiert standardmäßig beides, mit etwa 50 % Leistungseinbuße, und laut README wird sich die Voreinstellung wahrscheinlich auf „nicht invertieren“ ändern. In unserem Test, in dem wir die Invertierung bei beiden Bibliotheken ausdrücklich aus- und eingeschaltet haben, scheiterte der invertierte Code jedes Mal, wenn sie aus war. Wenn dein Layout dunkel ist, setz den Code auf eine helle Fläche; die Checkliste zur Fehlerbehebung beschreibt diese Lösung.

Ändere die Form, nicht die Helligkeit

Damit ein Code anders aussieht, ohne seine Helligkeit anzutasten, änderst du die Punktform. Im Editor von QR Maker AI findest du unter Stil → Punktform die Optionen „Gewebe“ und „Gewebe vertikal“, Stand November 2026 Pro-Funktionen (siehe Preise). Sie verbinden aufeinanderfolgende dunkle Module in einer Zeile oder Spalte zu einem abgerundeten Balken mit 0.76 Modulen Breite, der die Mitte jedes Moduls abdeckt. In unseren Decoder-Tests vor der Veröffentlichung wurden Gewebe-Codes von beiden Bibliotheken in jeder getesteten Größe dekodiert.

Das Stil-Panel des Editors schaltet die Punktform zwischen Rund, Fließend, Gewebe und Gewebe vertikal um, während der Code schwarz auf weiß bleibt

Screenshot aus einem Demo-Konto mit Beispieldaten.

Bevor du einen farbigen Code druckst:

  1. Berechne L für jede Punktfarbe, nicht einen Durchschnitt der Palette.
  2. Halte jede Punktfarbe deutlich dunkler als den Hintergrund; die dunkle Gruppe, die in unserem Test dekodiert wurde, lag gegen Weiß bei ungefähr 8:1 bis 12.4:1.
  3. Halte die Suchmuster dunkel und den Hintergrund hell.
  4. Prüfe die exportierte Datei mit dem kostenlosen QR-Code-Prüfer, der ein WCAG-Verhältnis zwischen dem durchschnittlichen dunklen Modul und den hellen Modulen berechnet und alles unter 4.5:1 markiert, und scanne dann einen Probedruck mit mehreren Smartphones.

Für Bilder unter den Punkten lies, wie künstlerische QR-Codes trotzdem scannbar bleiben; Farbideen nach Einsatzort findest du in Designideen für QR-Codes.

FAQ

Kann ein QR-Code jede Farbe haben?

Die Punkte können jede Farbe haben, die deutlich dunkler ist als der Hintergrund, denn der Open-Source-Decoder-Code, den wir gelesen haben, reduziert Farbe auf Helligkeit. Die FAQ von DENSO WAVE ergänzen, dass Rotlichtscanner einen roten Code auf Weiß nicht lesen können – teste Farben also mit den Scannern, die dein Publikum verwendet.

Welches Kontrastverhältnis sollte ein QR-Code haben?

Kein QR-Standard, den wir gelesen haben, legt ein WCAG-Verhältnis fest. Prüfgeräte bewerten den Symbolkontrast anhand des gemessenen Reflexionsgrads, mit A ab 70 % laut Handbuch von Cognex. Als Faustregel zum Vorsortieren: Die dunklen Farben, die in unseren Tests dekodiert wurden, hatten gegen Weiß ungefähr 8:1 oder mehr.

Warum lässt sich mein gelber oder goldener QR-Code nicht scannen?

Gelb ist hell. #f2c14e hat eine relative Leuchtdichte von 0.576 und gegen Weiß nur 1.7:1 Kontrast, ein Decoder sieht also hellgraue Punkte auf Weiß. Nimm für die Punkte eine dunkle Farbe und setz das Gelb in einen Rahmen.

Funktionieren invertierte QR-Codes?

Der Standard erlaubt Hell-auf-dunkel-Codes, aber der Decoder muss ein invertiertes Bild ausprobieren. In unserem Test sind beide Decoder ohne Invertierung gescheitert; Kamera-Apps auf Smartphones haben wir nicht getestet, daher ist ein Dunkel-auf-hell-Code die sicherere Wahl.

Quellen

  1. W3C — Web Content Accessibility Guidelines (WCAG) 2.2: relative luminance and contrast ratio definitions. W3C Recommendation, published 12 December 2024. Accessed 5 November 2026.
  2. jsQR project — src/binarizer/index.ts. Undated source file. Accessed 5 November 2026.
  3. ZXing project — RGBLuminanceSource.java. Undated source file. Accessed 5 November 2026.
  4. ISO/IEC — ISO/IEC 18004:2006, QR Code 2005 bar code symbology specification. Second edition, published 1 September 2006 (copy hosted by Public.Resource.Org). Accessed 5 November 2026.
  5. DENSO WAVE — FAQ. QRcode.com, undated. Accessed 5 November 2026.
  6. W3C WAI — Understanding Success Criterion 1.4.3: Contrast (Minimum). Updated 6 September 2026. Accessed 5 November 2026.
  7. zxing-wasm project — README. Undated. Accessed 5 November 2026.
  8. Cognex — ISO/IEC 15415 Grading Parameters, DataMan 475V Verifier Reference Manual. Dated 13 August 2020. Accessed 5 November 2026. (vendor data)
  9. Axicon — ISO/IEC standard for 2D barcodes. Undated. Accessed 5 November 2026. (vendor data)
  10. ISO — ISO/IEC 18004:2024 standard page. Fourth edition, published August 2024. Accessed 5 November 2026.
  11. ZXing project — MultiFormatReader.java. Undated source file. Accessed 5 November 2026.
  12. ZXing project — DecodeHintType.java. Undated source file. Accessed 5 November 2026.
  13. jsQR project — README. Undated. Accessed 5 November 2026.

Erstelle kostenlos einen dynamischen QR-Code – ändere das Ziel jederzeit und miss jeden Scan.

Mit diesem Design starten →