Zum Inhalt springen

Manueller Modus

Der manuelle Modus legt jeden Regler offen, den die Engine akzeptiert. Dieselben Steuerelemente findest du in der Editor-Oberfläche und in der API.

Die 7 wichtigsten

Wenn du sonst nichts änderst, sind das die, auf die es am meisten ankommt:

  1. content – URL oder Text, der codiert wird.
  2. primaryColor + backgroundColor – müssen einen Kontrast von ≥ 4:1 halten.
  3. eccLevel – L / M / Q / H. Standard H. Bei einem Logo ist H Pflicht.
  4. moduleShape – square / circle / roundedsquare / diamond / hexagon / dot / cross / star / leaf / pointed / drop.
  5. finderOuterShape + finderInnerShape – die 3 Eckmuster. Square oder roundedsquare für Sicherheit; circle / target / double fürs Design.
  6. outputWidth + pixelsPerModule – wähle eins, das andere wird berechnet.
  7. fileFormat – png, jpg, svg, pdf, webp.

Farbverlauf

{
  "foregroundStyle": "linearGradient",
  "gradientColors": ["#dcc28a", "#7d4bff"],
  "gradientDirection": "diagonal"
}

gradientDirection akzeptiert vertical, horizontal, diagonal, diagonal-reverse, radial oder custom (mit gradientAngle: 0-360).

{
  "logoUrl": "https://yourbrand.com/logo.svg",
  "logoShape": "circle",
  "logoSizePercent": 18,
  "cleanBehindLogo": true,
  "eccLevel": "H"
}

logoSizePercent ist auf 25 begrenzt, damit die Fehlerkorrektur im wiederherstellbaren Bereich bleibt.

Rahmen + Textüberlagerungen

{
  "frame": {
    "enabled": true,
    "color": "#3d2a14",
    "width": 6,
    "cornerRadius": 14,
    "padding": 18,
    "shape": "rectangle"
  },
  "centerText": {
    "text": "ADMIT ONE",
    "color": "#3d2a14",
    "backgroundColor": "#f5ecd2",
    "height": 28,
    "fontSize": 13,
    "bold": true
  },
  "ctaText": "Scan to enter"
}

Die Kombination aller drei (Rahmen + Banner in der Mitte + CTA darunter) zeigt die Engine in der Showcase-Kachel Banner ticket.

Vollständige Parameterliste

Siehe QrConfig-Referenz. Sie wird aus denselben Modellen generiert, die die Engine nutzt, und ist daher immer synchron.