Aller au contenu

Mode manuel

Le mode manuel expose tous les réglages acceptés par le moteur. Vous retrouvez les mêmes contrôles dans l'interface de l'éditeur et dans l'API.

Les 7 essentiels

Si vous ne changez rien d'autre, ce sont ceux qui comptent le plus :

  1. content : URL ou texte à encoder.
  2. primaryColor + backgroundColor : gardez un contraste d'au moins 4:1.
  3. eccLevel : L / M / Q / H. H par défaut. H obligatoire en présence d'un logo.
  4. moduleShape : square / circle / roundedsquare / diamond / hexagon / dot / cross / star / leaf / pointed / drop.
  5. finderOuterShape + finderInnerShape : les 3 motifs des coins. Square ou roundedsquare pour la sécurité ; circle / target / double pour le design.
  6. outputWidth + pixelsPerModule : choisissez-en un, l'autre est calculé.
  7. fileFormat : png, jpg, svg, pdf, webp.

Dégradé

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

gradientDirection accepte vertical, horizontal, diagonal, diagonal-reverse, radial ou custom (avec gradientAngle: 0-360).

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

logoSizePercent est plafonné à 25 pour que la correction d'erreurs reste dans des limites récupérables.

Cadres et textes superposés

{
  "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"
}

La combinaison des trois (cadre + bandeau central + CTA en dessous) est ce que le moteur montre dans la vignette Banner ticket de la vitrine.

Liste complète des paramètres

Consultez la Référence QrConfig. Elle est générée automatiquement à partir des mêmes modèles que ceux du moteur ; elle est donc toujours à jour.