Comment une page arrive, et combien de temps elle reste

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.

Vous l'avez vu en salle de réunion : une diapositive s'efface, une autre glisse depuis le côté, une troisième s'ouvre comme deux volets. C'est ce que ceci règle, page par page. Vous dites comment une page arrive — en glissant, en se fondant, en s'ouvrant en deux — et combien de secondes elle reste avant que la suivante vienne d'elle-même. Ça n'arrive que lorsque le document est montré en plein écran ; à l'impression, ou lu dans une fenêtre, rien de tout ça ne change quoi que ce soit. Une page dont vous ne dites rien apparaît simplement quand le lecteur y arrive.

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.

Écrit au premier niveau d'une requête, sous "page_shows"

page_shows dit, page par page, comment la page arrive et combien de temps elle reste quand quelqu'un montre le document en plein écran. arrives porte l'effet et le temps que l'effet lui-même prend ; stands est le temps que la page reste avant que la suivante arrive d'elle-même, et absent laisse la page en place jusqu'à ce que le lecteur la tourne. Ce sont la présentation que la norme définit, donc un logiciel de lecture sans mode plein écran les ignore et montre les pages simplement. Une page nommée deux fois prend la dernière entrée donnée pour elle, en entier.

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_shows — tableau, facultatif, vide par défaut.
• page_shows[].page — entier, obligatoire, à partir de 1. La page que l'entrée vise.
• page_shows[].arrives — objet, facultatif. La façon dont la page arrive. Absent, le lecteur y vient sans le moindre effet.
• page_shows[].arrives.effect — objet, obligatoire dès que arrives est là. Un effet parmi ceux que la norme nomme : split, blinds, box, wipe, dissolve, glitter, fly, push, cover, uncover, fade. Chacun porte ce qu'il lui faut — un axis (horizontal ou vertical), un motion (inward ou outward), une direction en degrés.
• page_shows[].arrives.seconds — nombre, facultatif. Le temps que dure l'effet lui-même.
• page_shows[].stands — nombre, facultatif. Le nombre de secondes que la page reste avant que la suivante arrive d'elle-même. Absent, la page reste jusqu'à ce que le lecteur la tourne.

Portée : les pages nommées, et elles seules. Rien ici ne change ce qui est imprimé ni ce qu'une page porte — seulement la façon dont un logiciel montrant le document en plein écran passe d'une page à la suivante.

Une requête entière qui le dessine

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

{
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "page_shows": [
    { "page": 1, "stands": 4 },
    {
      "page": 2,
      "arrives": {
        "effect": { "split": { "axis": "vertical", "motion": "outward" } },
        "seconds": 1
      },
      "stands": 4
    }
  ],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 500, "urx": 523, "ury": 560 },
      "content": ["First slide"],
      "font": "sans",
      "font_size": 28
    },
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 500, "urx": 523, "ury": 560 },
      "content": ["Second slide"],
      "font": "sans",
      "font_size": 28,
      "pages": [2]
    }
  ]
}

La ligne qui l'envoie, en trois langages

Glossaire

logiciel de lecture

Le programme qui ouvre un PDF et le pose sur un écran — celui installé sur la machine, ou celui que porte un navigateur. Sur ce site, la personne qui tient le document est le lecteur, et le programme qui le lui montre est un logiciel de lecture : le document demande, et chaque programme répond pour lui-même. Sa page les nomme un par un.

norme

Une règle débattue en commission, publiée sous un numéro que n'importe qui peut acheter et lire, et identique pour toutes les entreprises qui s'en réclament. Dire qu'on la suit peut donc être vérifié face au texte. Une façon de faire qui s'est simplement répandue parce qu'elle marchait est une habitude du métier : utile, très suivie, et qui ne répond devant aucun texte.

Tous les mots que le site explique