Un QR code, de forme carrée, lisible au téléphone
Dessiner un QR code qui encode une adresse web ou un texte, lu par n’importe quel téléphone, avec sa marge blanche tout autour.
Le résultat dans un vrai PDF
Le code qu’une facture, une carte d’embarquement ou une étiquette finit par réclamer, dessiné dans le document plutôt que récupéré en image sur un site et collé dedans.
Ouvrir le PDF Voir l’exemple complet
Également dans les exemples : Réglages QR et Data Matrix côte à côte · Une facture commerciale · Une carte d’embarquement
Résumé
Le petit carré de points noirs que l’on vise avec l’appareil photo du téléphone. Une adresse de site, un numéro de commande, un mot de passe de réseau : quoi qu’il encode, le carré se dessine à la taille que le cadre permet, avec la petite marge blanche qui permet au téléphone de le reconnaître du premier coup. Plus le texte est long, plus les points sont fins — pour un code lu de loin, ou imprimé en petit, mieux vaut donc un texte court. Vous pouvez aussi demander un code plus solide, qui se lit encore une fois éraflé ou déchiré : il contient le même texte dans un carré un peu plus grand.
Techniquement
Demandé avec
"type": "qr"
La part du code gardée en réserve pour le reconstituer lorsqu’il est abîmé, et la façon dont le code encode ce qu’il transporte, sont toutes deux énoncées plutôt que devinées. En leur absence, le texte est encodé octet par octet, ce qui couvre l’ASCII comme l’UTF-8, et quinze parts sur cent environ sont gardées en réserve — la valeur appliquée avant que l’une ou l’autre de ces clés n’existe. Un texte que l’encodage énoncé ne peut pas contenir est refusé plutôt que transporté autrement. Les modules sont dessinés comme des carrés pleins dans le flux de contenu de la page. Le carré et sa zone de silence sur ses quatre côtés remplissent la largeur du rectangle, et l’ensemble est ancré au coin inférieur gauche : la hauteur du rectangle est une marge, sa largeur commande. La version choisie est la plus petite qui contienne le texte tel qu’il est encodé et au niveau de correction d’erreur demandé, de 21×21 jusqu’à 177×177 ; au-delà du plus grand symbole, la réponse est 400. Comme pour les autres codes, l’élément dessine le symbole seul, et le texte lisible par une personne se pose à côté.
Schéma de la requête
Clés obligatoires : content, une chaîne non vide ; rect. Facultatives : correction, l’une de low, medium (par défaut), quartile ou high, la part du code gardée en réserve pour le ramener à bon port lorsqu’il est abîmé ; mode, l’un de numeric, alphanumeric ou byte (par défaut), la façon dont le code épelle ce qu’il transporte ; pages, un tableau d’entiers comptés à partir de 1, vide par défaut ; transform, six nombres ; rotate, degrés dans le sens inverse des aiguilles d’une montre autour du centre du rectangle ; layer, le nom d’un calque déclaré. Refus croisé : transform avec rotate. Un texte que le mode énoncé ne sait pas épeler répond 400, et un texte plus long que ce que le plus grand symbole tient au niveau de correction d’erreur demandé aussi. charset, dont la seule valeur est utf_8, déclare en tête des octets qu’ils sont écrits en UTF-8, pour qu’un scanner rende un accent ou le signe euro tels qu’ils sont entrés ; absent, rien n’est déclaré. Il n’est déclaré qu’en mode byte, tout autre mode à côté répondant 400.
Une requête entière qui crée un PDF
{
"items": [
{
"type": "qr",
"content": "https://hqf-pdf.com/",
"correction": "quartile",
"mode": "byte",
"rect": {"llx": 72, "lly": 680, "urx": 152, "ury": 760}
}
]
}
Les codes-barres et les codes carrés
Un code-barres à barres verticales Un code Aztec, sans marge blanche autour Un code DataMatrix, très petit et très robuste Un code PDF417, qui contient tout un formulaire
Où aller ensuite
Toutes les clés JSON d’une requête, en une page Les vingt-deux autres choses que l’on peut dessiner