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".
  • archive settles the version on its own side: pdfa3b imposes 1.7, pdfa4 imposes 2.0. A version written in the request is applied afterwards.
  • Known demands: layers and object streams want 1.5; the print wishes of reading want 1.7; reading.lock_actual_size and the annotations and widgets tab 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 line that sends it, in three languages

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

See the Prices See the Examples