Zum Inhalt springen

Anleitung

QR-Codes im Dark Mode und Scanner-Kompatibilität

Moderne Handykameras lesen invertierte QR-Codes oft, viele eingebettete Scanner dagegen nicht. Vergleichen Sie zwei Ansätze für dunkle Designs und wählen Sie die passende Option für Ihren Anwendungsfall.

Die QR-Spezifikation definiert dunkle Module auf hellem Hintergrund als Standard. Moderne Handykameras testen oft beide Polaritäten und können invertierte Codes lesen. Viele eingebettete Scanner, darunter einige Implementierungen auf Basis von ZXing, testen nur die Standardpolarität. Ironfang Render berücksichtigt diesen Unterschied, wenn es jede Ausgabe prüft.

Eine helle Kachel für breite Kompatibilität

Setzen Sie einen standardmäßigen QR-Code, dunkel auf hell, auf eine helle Kachel im dunklen Design. Die Kachel bewahrt die erforderliche Ruhezone und den Kontrast und sorgt für breite Scanner-Kompatibilität.

Das standardmäßige QR-Bild direkt auf der dunklen Oberfläche platzieren.

curl -X POST https://api.ironfang.uk/render/v1/qr \
  -H "Authorization: Bearer if_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "data": "https://example.com",
    "dots": "circle",
    "dark": "#05050a",
    "light": "#ffffff"
  }' --output qr-tile.png

Invertierung für kontrollierte Bildschirme

Setzen Sie invert auf true, um helle Module auf dunklem Hintergrund zu erzeugen. In diesem Modus muss dark die hellere Modulfarbe enthalten und light die dunklere Hintergrundfarbe. Es gilt dieselbe Kontrastschwelle, und Ironfang Render prüft das fertige Bild gegen sein Negativ.

Invertierte Ausgaben für Anwendungsbildschirme und Dashboards verwenden, die Sie selbst kontrollieren.

curl -X POST https://api.ironfang.uk/render/v1/qr \
  -H "Authorization: Bearer if_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "data": "https://example.com",
    "invert": true,
    "dark": "#fafafa",
    "light": "#05050a",
    "dots": "circle"
  }' --output qr-dark.png

Weiterlesen