The PDF Version the File Declares
Choose the version the document announces, from 1.4 to 2.0, by what it carries and by the age of the software reading it.
See It in a Real PDF
One Letter per Recipient, All in the Same File
Four personal letters behind a contents page. The letters have no page numbers: each recipient gets the pages that follow their own, as many as are needed. Each line of the contents leads to the letter it names.
Open the PDF The Whole Example
Also shown in: Three Statements in One File · A Sheet That Measures What It Says · One Drawing, Placed Many Times
Summary
The PDF format has several generations, the way cars have model years. The first line of the file announces its own, and it is a promise: here is what you need to know how to do in order to show me whole. Software older than the version announced shows what it can and leaves the rest aside, quietly — which is why the choice is worth making rather than inheriting.
Technically
Written at the top level of a request, under
"version"
version sets the version the first line of the file declares. Each version brings what the library writes: 1.4 transparency, tagged content and the metadata packet; 1.5 layers, two-page spreads and the sliding transitions; 1.6 opening on the list of attachments and print scaling; 1.7 the wishes a print dialogue reads; 2.0 taking the print size away from the reading software. Nothing is raised on the customer's behalf: a document declaring less than what it carries is refused when written, naming what asked for more.
Request Schema
-
version— string, optional. Absent, the document is written as 1.7. -
Five values:
"1.4","1.5","1.6","1.7","2.0". -
archivesettles the version on its own side:pdfa3bimposes 1.7,pdfa4imposes 2.0. Aversionwritten in the request is applied afterwards. -
Known demands: layers and object streams want 1.5; the print wishes of
readingwant 1.7;reading.lock_actual_sizeand theannotationsandwidgetstab orders want 2.0.
A Whole Request That Creates a PDF
{
"version": "2.0",
"standard_fonts": [{ "name": "sans", "face": "helvetica" }],
"items": [
{
"type": "text",
"rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 762 },
"content": ["This file announces PDF 2.0"],
"font": "sans",
"font_size": 14
}
]
}
The document as a whole
The Numbers Reading Software Shows A Hundred Letters in a Single File What the Document Says about Itself What the Document Says about Itself, Said Once Text Nobody Can Copy The Notes a Program Leaves in the File for Itself The Notes a Program Leaves on One Page The Data a Program Hangs on a Run of Ink A File Still Readable Decades from Now The Print Standard the Document Claims The Variable Print Standard the Document Claims The Password That Opens It, and What May Be Done with It An Invoice a Person and a Machine Both Read The Address Relative Links Are Read Against The Extensions to PDF the File Says It Uses What a Picture Says about Itself, and How It Is Read The Attachments the Document Carries Beside Its Pages Files the Document Names without Carrying The Attachments Shown as a Portfolio Which Attachments a Page Claims Which Attachments a Font Claims The Identity Card a Single Font Carries Which Attachments the Document's Card Claims A Document Card Written Elsewhere The Areas of a Page a Reader Measures In The Identity Card a Single Page Carries The Accessibility Standard the Document Claims The Standards the Finished Document Is Measured Against
Where to Go Next
Every JSON key of a request, in one page The other forty-one settings of a request