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.
Résumé
La mesure 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 bas-gauche de la feuille et l'axe vertical monte, et les éléments se positionnent depuis 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 prend le dessus. 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 vaut 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, par numéro à partir de 1. Les clés inconnues d'un objet sont ignorées ; une même clé écrite deux fois dans le même objet est refusée à la lecture.
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 Les zones que la page déclare Les formes posées sur ce qu'une page dessine L'orientation à l'écran et à l'impression Comment une page arrive, et combien de temps elle reste Jusqu'où un PDF fourni a le droit de se déplier Le modèle sous les pages
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