L'orientation à l'écran et à l'impression

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.

Dans un rapport, un grand tableau tient mieux couché que debout. On ne redessine rien : on demande simplement que cette page-là soit présentée tournée d'un quart de tour. C'est le geste qu'on fait avec une feuille de papier qu'on tourne dans ses mains pour lire ce qui est écrit en travers. Le dessin ne bouge pas, c'est la feuille qui tourne.

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.

page_turns donne, page par page, la rotation qu'un lecteur applique avant d'afficher la feuille. Le contenu n'est pas déplacé : c'est la feuille qui tourne, dans le sens des aiguilles d'une montre. C'est ainsi qu'une page à l'italienne vit à l'intérieur d'un document à la française. À ne pas confondre avec la rotation rotate d'un élément, qui tourne le dessin lui-même sur une feuille qui ne bouge pas.

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.

• 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 le dessine

Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.

{
  "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 ligne qui l'envoie, en trois langages