Wie eine Seite erscheint und wie lange sie stehen bleibt

Das Dokument in eine Diashow verwandeln: Jede Seite erscheint mit einem eigenen Effekt und steht die angegebene Zeit, bevor die nächste kommt.

In einem echten PDF ansehen

Eine Diashow, die von selbst läuft

Eine schlichte erste Folie und dreizehn weitere, von denen jede den Effekt angibt, mit dem sie erscheint — die zwölf, die die PDF-Norm (ISO 32000) definiert —, wie lange dieser Effekt dauert und wie lange die Folie stehen bleibt, bevor die nächste kommt. Die Datei bittet darum, im Vollbild geöffnet zu werden, denn dort laufen die Effekte, und ein Link auf der ersten Folie zeigt den Bildschirm wieder, mit einer Überblendung eingeblendet.

Das PDF öffnen Das vollständige Beispiel ansehen

Zusammenfassung

Sie haben es in einem Besprechungsraum gesehen: Eine Folie wird weggewischt, eine andere gleitet von der Seite herein, eine dritte öffnet sich wie ein Paar Fensterläden. Das geschieht nur, wenn das Dokument im Vollbild gezeigt wird; gedruckt oder in einem Fenster gelesen ändert nichts davon etwas. Eine Seite, zu der Sie nichts sagen, erscheint einfach, wenn der Leser zu ihr blättert.

Technisch

Auf der obersten Ebene einer Anfrage geschrieben, unter "page_shows"

page_shows schreibt /Trans und /Dur an die genannten Seiten: wie die Seite erscheint und wie lange sie stehen bleibt, wenn die Anzeigesoftware das Dokument im Vollbild zeigt. arrives gibt den Effekt an und wie viele Sekunden der Effekt selbst dauert; stands ist die Zeit, die die Seite stehen bleibt, bevor die nächste von selbst erscheint, und fehlt es, bleibt die Seite stehen, bis der Leser umblättert. Beides ist die von der Norm definierte Präsentation, eine Anzeigesoftware ohne Vollbildmodus ignoriert sie also und zeigt die Seiten schlicht an. Eine doppelt genannte Seite nimmt den letzten Eintrag für sie, vollständig.

Anfrageschema

  • page_shows — Array, optional, standardmäßig leer.
  • page_shows[].page — Ganzzahl, erforderlich, ab 1 gezählt. Die Seite, für die der Eintrag gilt.
  • page_shows[].arrives — Objekt, optional. Wie die Seite erscheint. Fehlt es, blättert der Leser ohne jeden Effekt zu ihr.
  • page_shows[].arrives.effect — erforderlich, sobald arrives vorhanden ist. Einer der zwölf Effekte, die die Norm nennt: replace, split, blinds, box, wipe, dissolve, glitter, fly, push, cover, uncover, fade. Ein Effekt, der nichts braucht — replace, das die Seite einfach erscheinen lässt, dissolve und fade —, wird nur mit seinem Namen geschrieben; die anderen sind ein Objekt mit dem, was sie brauchen: eine axis (horizontal oder vertical), eine motion (inward oder outward), eine heading aus rightwards, upwards, leftwards, downwards und diagonally, wobei Letzteres nur ein Glitzern liest.
  • page_shows[].arrives.seconds — Zahl, optional. Wie lange der Effekt selbst dauert.
  • page_shows[].stands — Zahl, optional. Wie viele Sekunden die Seite stehen bleibt, bevor die nächste von selbst erscheint. Fehlt sie, bleibt die Seite stehen, bis der Leser umblättert.

Geltungsbereich: die genannten Seiten und nur sie. Nichts hier ändert, was gedruckt wird oder was eine Seite enthält — nur die Art, wie eine Anzeigesoftware, die das Dokument im Vollbild zeigt, von einer Seite zur nächsten wechselt.

Eine vollständige Anfrage, die ein PDF erzeugt

{
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "page_shows": [
    { "page": 1, "stands": 4 },
    {
      "page": 3,
      "arrives": { "effect": { "wipe": { "heading": "rightwards" } } }
    },
    {
      "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]
    }
  ]
}

Die Zeile, die es sendet, in drei Sprachen

Das Blatt und was darunter gelegt wird

Die Größe der Seiten Ein eigenes Format für bestimmte Seiten Die Einheit, in der eine Seite gemessen wird Wo das Blatt einer Seite in der Zeichnung sitzt Die Bereiche, die eine Seite angibt Die Formen, die eine Seite über das Gezeichnete legt Wie herum eine Seite gezeigt wird Ein mitgesendetes PDF als Seiten des Dokuments Wie weit sich ein mitgeliefertes PDF entpacken darf Die Vorlage unter den Seiten Ein über eine Reihe von Seiten gelegtes Wasserzeichen Benannte Bereiche, die eine Seite zum Füllen markiert

Wohin als Nächstes

Jeder JSON-Schlüssel einer Anfrage, auf einer Seite Die übrigen einundvierzig Einstellungen einer Anfrage

Die Preise ansehen Die Beispiele ansehen