Un code QR carré, lisible au téléphone
Dessiner un code QR qui porte une adresse web ou un texte, lu par n'importe quel téléphone, avec sa marge blanche tout autour.
Demandé avec
"type": "qr"
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 petit carré de points noirs que l'on vise avec l'appareil photo du téléphone. Vous donnez ce qu'il doit contenir — une adresse de site, un numéro de commande, un mot de passe de réseau — et l'endroit où le poser. Le carré se dessine à la bonne taille, avec la petite marge blanche autour, celle 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 un texte court.
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 code est encodé en mode octet, au niveau de correction M, ce qui couvre l'ASCII comme l'UTF-8. Le carré et sa zone de silence sur les quatre côtés remplissent la largeur du rectangle, et le tout est ancré au coin inférieur gauche : la hauteur du rectangle sert de réserve, la largeur commande. La version est choisie à la plus petite qui contient le texte ; un texte que le plus grand symbole accepte passe, au-delà la réponse est 400. Comme pour les autres codes, l'article dessine le symbole seul, et le texte lisible se pose à côté.
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 non vide ; rect. Facultatives : 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. Le mode d'encodage et le niveau de correction sont fixés : le fil expose le contenu et la boîte.
Une requête entière qui le dessine
Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.
{
"items": [
{
"type": "qr",
"content": "https://hqf-pdf.com/",
"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 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
- octet
- L'unité dans laquelle se compte le poids d'un fichier, comme un colis se compte en grammes. Mille octets font un kilo-octet, un million font un méga-octet — la taille d'une photo prise avec un téléphone. Un PDF d'une page pèse ici entre six mille et cent vingt mille, donc cent PDF tiennent dans la place de cinq photos.
- 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.