How a Page Arrives, and How Long It Stands
Turn the document into a slideshow: each page arrives with an effect of its own and stands for the time you give it before the next one comes.
See It in a Real PDF
A plain first slide and thirteen more, each stating the effect it arrives by — the twelve the PDF standard (ISO 32000) defines — how long that effect takes and how long the slide stands before the next one comes. The file asks to open full screen, which is where the effects play, and a link on the first slide shows the screen again, brought in by dissolving.
Summary
You have seen it in a meeting room: a slide wipes away, another slides in from the side, a third opens like a pair of shutters. It only happens when the document is shown full screen; printed, or read in a window, none of it changes anything. A page you say nothing about simply appears when the reader turns to it.
Technically
Written at the top level of a request, under
"page_shows"
page_shows writes /Trans and /Dur on the pages it names: how the page arrives and how long it stands when reading software shows the document full screen. arrives states the effect and how many seconds the effect itself takes; stands is how long the page is left before the next arrives by itself, and absent leaves the page standing until the reader turns it. Both are the presentation the standard defines, so reading software that has no full-screen mode ignores them and shows the pages plainly. A page named twice takes the last entry given for it, whole.
Request Schema
-
page_shows— array, optional, empty by default. -
page_shows[].page— integer, required, counting from 1. The page the entry is for. -
page_shows[].arrives— object, optional. How the page arrives. Absent, the reader turns to it with no effect at all. -
page_shows[].arrives.effect— required as soon asarrivesis present. One effect among the twelve the standard names:replace,split,blinds,box,wipe,dissolve,glitter,fly,push,cover,uncover,fade. An effect that needs nothing —replace, which makes the page simply appear,dissolveandfade— is written as its name alone; the others are an object carrying what they need: anaxis(horizontalorvertical), amotion(inwardoroutward), aheadingamongrightwards,upwards,leftwards,downwardsanddiagonally, the last of which only a glitter reads. -
page_shows[].arrives.seconds— number, optional. How long the effect itself lasts. -
page_shows[].stands— number, optional. How many seconds the page stands before the next arrives by itself. Absent, the page stands until the reader turns it.
Scope: the pages named, and them alone. Nothing here changes what is printed or what a page holds — only the way reading software showing the document full screen moves from one page to the next.
A Whole Request That Creates a PDF
{
"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]
}
]
}The sheet, and what is laid under it
The Size of the Pages A Size of Its Own for Certain Pages The Unit a Page Is Measured In Where a Page's Sheet Sits in the Drawing The Areas a Page States The Shapes a Page Lays over What It Draws Which Way up a Page Is Shown A PDF You Send, as the Pages Themselves How Far a Supplied PDF Is Allowed to Unpack The Template under the Pages A Watermark Laid across a Run of Pages Named Regions a Page Marks for Filling
Where to Go Next
Every JSON key of a request, in one page The other forty-one settings of a request