Un code-barres à barres verticales
Dessiner un code-barres lisible par une douchette : Code 128 pour du texte, EAN-13, UPC-A et EAN-8 pour un article du commerce.
Demandé avec
"type": "barcode"
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 la suite de barres noires que la caissière passe devant sa petite lampe rouge. Vous donnez le texte ou le numéro d'article, et le cadre où il doit tenir : les barres se dessinent à la bonne largeur, avec la marge blanche que les lecteurs réclament de chaque côté. Comme les barres sont vraiment dessinées, et non collées comme une photo, elles restent nettes à l'impression, même sur une étiquette minuscule. Si vous voulez aussi voir le numéro écrit en chiffres sous les barres, vous ajoutez un bloc de texte juste en dessous.
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.
Les barres et les zones de silence remplissent la largeur du rectangle, et les barres en occupent toute la hauteur. Quatre symbologies : Code 128, qui porte les caractères ASCII imprimables, et les trois codes du commerce de détail, qui portent un numéro d'article. Pour EAN-13, douze chiffres valent le numéro et la clé est calculée, treize valent le code entier et la clé est vérifiée ; même règle pour UPC-A à onze ou douze chiffres, et pour EAN-8 à sept ou huit. Un texte que la symbologie choisie sait encoder est accepté, les autres reçoivent une réponse 400.
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 : symbology, valant code128 (défaut), ean13, upc_a ou ean8 ; fill, couleur des barres (défaut noir), écrite comme partout ailleurs : un nombre pour un gris, trois pour le rouge, le vert et le bleu, quatre pour les quatre encres, {"gray": n}, ou {"space": "name", "components": …} ; 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. L'article dessine les barres seules ; les chiffres lisibles à l'œil se posent avec un article text.
Une requête entière qui le dessine
Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.
{
"items": [
{
"type": "barcode",
"content": "FR-1964413",
"rect": {"llx": 72, "lly": 700, "urx": 237, "ury": 740}
}
]
}Les codes-barres et les codes carrés
Un code QR carré, lisible au téléphone Un code Aztec, sans marge blanche autour 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
- CMJN
- Les quatre encres d'une imprimerie : le cyan (un bleu), le magenta (un rose), le jaune et le noir. Un écran, lui, fabrique ses couleurs avec de la lumière. Un document qui part à l'impression dit donc ses couleurs en encres, et non en couleurs d'écran.
- 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.