L'orientation à l'écran et à l'impression
Faire pivoter une page d'un quart de tour avant que le logiciel de lecture ne la montre, sans déplacer ce qui est dessiné sur la feuille.
Résumé
Dans un rapport, un tableau large tient mieux couché que debout. C'est le geste que vous faites avec une feuille de papier, en la tournant dans vos mains pour lire ce qui est écrit en travers : ce qui est dessiné ne bouge pas, c'est la feuille qui tourne.
Techniquement
Écrit au premier niveau d'une requête, sous
"page_turns"
page_turns écrit /Rotate sur les pages qu'il nomme — 90, 180 ou 270 degrés dans le sens des aiguilles d'une montre — c'est-à-dire la rotation que le logiciel de lecture applique avant de montrer la feuille. Le contenu n'est pas déplacé : c'est la feuille qui tourne. C'est ainsi qu'une page à l'italienne vit à l'intérieur d'un document à la française. Une page droite n'écrit aucun /Rotate. C'est une autre chose que le rotate d'un élément, qui fait tourner ce qui est dessiné sur une feuille qui, elle, ne bouge pas.
Schéma de la requête
-
page_turns— tableau, facultatif, vide par défaut. -
page_turns[].page— entier ≥ 1, obligatoire. La page visée. -
page_turns[].turn— chaîne, obligatoire. Quatre valeurs :upright(montrée telle qu'elle est dessinée),right(quart de tour dans le sens des aiguilles),upside_down(demi-tour),left(quart de tour dans l'autre sens).
Une entrée dit comment une page est montrée, pas qu'il y en a une : une page nommée 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 rotation écrite pour elle.
Une requête entière qui crée un PDF
{
"page_turns": [{ "page": 1, "turn": "right" }],
"standard_fonts": [{ "name": "sans", "face": "helvetica" }],
"items": [
{
"type": "text",
"rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 765 },
"content": ["Drawn upright, shown on its side"],
"font": "sans",
"font_size": 14
}
]
}La feuille, et ce qu'on pose dessous
La taille des pages 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 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