Une taille propre à certaines pages
Donner à une page précise une largeur et une hauteur qui lui sont propres, sans toucher au reste du document.
Résumé
Dans un dossier relié, il arrive qu'une feuille soit plus grande que les autres : un plan, un grand tableau de chiffres, une carte pliée dans la reliure. Ici, la feuille est désignée par son numéro, et on peut en désigner autant qu'on veut — un plan à la page quatre, un autre à la page onze, chacun avec sa taille à lui.
Techniquement
Écrit au premier niveau d'une requête, sous
"page_sizes"
page_sizes est une liste d'entrées, chacune nommant une page par son numéro à partir de 1 et lui donnant un /MediaBox de deux dimensions en points ; toutes les autres pages restent à la taille du document. Une entrée dit la taille d'une page, elle ne la crée pas : nommer une page au-delà de la fin du document laisse le document aussi long qu'il était. Une page nommée deux fois prend la dernière taille écrite pour elle.
Schéma de la requête
-
page_sizes— tableau, facultatif, vide par défaut. -
page_sizes[].page— entier ≥ 1, obligatoire. Le numéro de la page visée. -
page_sizes[].width— nombre, obligatoire. Largeur en points. -
page_sizes[].height— nombre, obligatoire. Hauteur en points.
Une entrée prend le pas sur page pour la seule page qu'elle nomme. Pour qu'une page existe, un élément la nomme dans son pages, ou le contenu coule jusqu'à elle. Les autres pages gardent la taille de page, A4 par défaut.
Une requête entière qui crée un PDF
{
"page_sizes": [{ "page": 2, "width": 841.89, "height": 595.28 }],
"standard_fonts": [{ "name": "sans", "face": "helvetica" }],
"items": [
{
"type": "text",
"pages": [1],
"rect": { "llx": 60, "lly": 760, "urx": 535, "ury": 785 },
"content": ["Page one, upright"],
"font": "sans",
"font_size": 14
},
{
"type": "text",
"pages": [2],
"rect": { "llx": 60, "lly": 540, "urx": 780, "ury": 565 },
"content": ["Page two, wider than it is tall"],
"font": "sans",
"font_size": 14
}
]
}La feuille, et ce qu'on pose dessous
La taille des 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