La taille des pages
Donner une largeur et une hauteur aux pages du document. Sans rien dire, la feuille est une A4 de 595,276 sur 841,89 points.
Le résultat dans un vrai PDF
Des titres réduits et une étiquette pivotée
Des titres de longueurs différentes réduits pour partager une même colonne, et une étiquette tournée d’un quart de tour le long du dos de la page.
Ouvrir le PDF Voir l’exemple complet
Également dans les exemples : Un ticket de caisse sur un rouleau de papier · Une carte d’embarquement · Un diaporama qui se déroule tout seul
Résumé
L’unité ici n’est pas le centimètre mais le point : il en faut un peu plus de 28 pour faire un centimètre. La feuille que prend l’imprimante de bureau, celle qu’on trouve partout en Europe, fait 595,276 points de large et 841,89 de haut. Chaque page du document sort à la taille que vous donnez, et une feuille posée dans le sens de la largeur est simplement une feuille dont le premier nombre est le plus grand des deux.
Techniquement
Écrit au premier niveau d’une requête, sous
"page"
page fixe le /MediaBox de toutes les pages du document, en points typographiques (un point vaut un soixante-douzième de pouce). L’origine des coordonnées est le coin inférieur gauche de la feuille, l’axe vertical monte, et les éléments se placent à partir de là. Les deux nombres sont obligatoires dès que l’objet est présent. Une page qui veut une taille à elle passe par page_sizes, qui la nomme par son numéro et prévaut. Les expressions de coordonnées {page_width} et {page_height} valent ces deux nombres.
Schéma de la requête
-
page— objet, facultatif. Absent, la feuille mesure 595,276 × 841,89 points (A4). -
page.width— nombre, obligatoire dès quepageest présent. Largeur en points. -
page.height— nombre, obligatoire dès quepageest présent. Hauteur en points.
Portée : toutes les pages du document. page_sizes reprend la main page par page ; les pages sont numérotées à partir de 1. Une clé qu’un objet ne connaît pas est refusée nommément à la lecture de la requête, tout comme une clé écrite deux fois dans le même objet.
Une requête entière qui crée un PDF
{
"page": { "width": 420, "height": 595 },
"standard_fonts": [{ "name": "sans", "face": "helvetica" }],
"items": [
{
"type": "text",
"rect": { "llx": 40, "lly": 530, "urx": 380, "ury": 555 },
"content": ["A5 upright"],
"font": "sans",
"font_size": 18
}
]
}
La feuille, et ce qu’on pose dessous
Une taille propre à certaines pages L’unité dans laquelle une page est mesurée Où se place la feuille d’une page dans le dessin Les zones que la page déclare Les formes posées sur ce qu’une page dessine Dans quel sens une page s’affiche Comment une page arrive, et combien de temps elle reste Un PDF que vous envoyez, pris comme pages du document Jusqu’où un PDF fourni a le droit de se déplier Le modèle sous les pages Un filigrane posé sur une suite de pages Zones nommées à remplir sur une page
Où aller ensuite
Toutes les clés JSON d’une requête, en une page Les quarante et un autres réglages d’une requête