Un code Aztec, sans marge blanche autour
Dessiner un code Aztec, celui des billets de train : carré, sans marge autour, avec la part de sécurité que vous choisissez.
Demandé avec
"type": "aztec"
En mots de tous les jours
Écrit pour tout le monde. Il dit ce que cela pose sur une feuille de papier, et ne vous demande rien de plus.
C'est le carré que l'on voit sur les billets de train et les cartes d'embarquement. Sa particularité est simple : il se lit sans marge blanche autour, donc il tient là où les autres codes ne rentrent pas, tout au bord d'un petit billet. Vous donnez le texte à porter, le cadre, et la part du carré réservée à la sécurité : plus cette part est grande, plus le code reste lisible même froissé ou taché, mais plus il devient dense. Sans indication de votre part, la part de sécurité est celle que la norme recommande.
Pour un développeur
Écrit pour celui qui écrit le programme appelant : le modèle, les unités, et les réglages qui portent le poids.
Le symbole est carré et remplit toute la largeur du rectangle, ancré au coin inférieur gauche ; il prend la largeur entière, puisqu'un code Aztec se lit sans zone de silence. La part réservée à la correction d'erreur s'exprime en pour cent, de 0 à 90 ; en son absence, elle vaut 23 %, la valeur que la norme recommande. La taille du symbole suit la longueur du texte et la part de correction demandée. L'article dessine le code seul : la référence lisible se pose à côté avec un article text.
Chaque clé, avec son défaut
La référence : quelles clés sont obligatoires, lesquelles sont facultatives, ce que vaut chacune par défaut et quelles combinaisons le serveur décline.
Clés obligatoires : content, chaîne ; rect. Facultatives : correction, entier de 0 à 90, part du symbole donnée à la correction d'erreur, défaut 23 ; pages, tableau d'entiers en base 1, défaut vide ; transform, six nombres ; rotate, degrés dans le sens trigonométrique autour du centre de la boîte ; layer, nom d'un calque déclaré. Refus croisé : transform et rotate ensemble. Une valeur de correction au-delà de 90, ou un texte plus long que ce que le plus grand symbole porte, reçoit une réponse 400.
Une requête entière qui le dessine
Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.
{
"items": [
{
"type": "aztec",
"content": "HQF2026 PARIS LONDON 14B 07JUL",
"rect": {"llx": 72, "lly": 700, "urx": 129, "ury": 757}
}
]
}Les codes-barres et les codes carrés
Un code-barres à barres verticales Un code QR carré, lisible au téléphone Un code Data Matrix, très petit et très solide Un code PDF417, qui porte tout un formulaire
Où aller ensuite
Chaque clé d'une requête, en une page Les vingt autres choses que l'on peut dessiner
Glossaire
- norme
- Une règle débattue en commission, publiée sous un numéro que n'importe qui peut acheter et lire, et identique pour toutes les entreprises qui s'en réclament. Dire qu'on la suit peut donc être vérifié face au texte. Une façon de faire qui s'est simplement répandue parce qu'elle marchait est une habitude du métier : utile, très suivie, et qui ne répond devant aucun texte.
- Aztec
- Le code avec une petite cible au milieu, celui des billets de train et des cartes d'embarquement montrées sur un écran de téléphone. Il a été conçu pour être lu sur un écran allumé et à travers une vitre rayée, et il tient dans moins de place que les autres pour le même texte.
- calque
- Un groupe nommé de choses dessinées sur une page, que le lecteur peut afficher ou masquer, comme un calque posé sur un plan. Un plan peut garder ses cotes sur l'un et ses notes sur l'autre, et un calque peut être réglé pour s'afficher à l'écran et rester hors de l'impression.