Dans quel sens une page s’affiche

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.

Le résultat dans un vrai PDF

Une feuille telle qu’elle part à l’impression

Un dessin sur quatre pages : une feuille de presse qui indique jusqu’où court l’encre, où tombe la lame et ce qui mérite d’être gardé, avec les repères de coupe ; la même feuille rognée à la page finie ; une page à l’italienne qui indique un quart de tour horaire sur une feuille à la française ; et la première feuille de nouveau, comme moitié droite d’une feuille de presse large de deux pages.

Ouvrir le PDF Voir l’exemple complet

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 prend place dans 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 concernée par l’entré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 d’une montre), upside_down (demi-tour), left (quart de tour dans le sens inverse des aiguilles d’une montre).

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

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 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 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

Voir les prix Voir les exemples