The Data a Program Hangs on a Run of Ink

Hang a list of your own data on a run of ink of the page, under a name you choose. Nothing of it is drawn, and no reading software shows it.

See It in a Real PDF

A Delivery Note That Knows Its Own Order

Every line of the note carries the order it was picked for, the article code and the shelf it came off, and prints none of them. The place where the driver signs carries the round and the van, and one beside the fold tick carries nothing but its own place.

Open the PDF The Whole Example

Summary

A warehouse prints a picking list and a scanner reads it back. What the scanner needs is the order line behind each row — the article code, the quantity — and none of that belongs on the paper. So it travels under the row instead of on it: you declare the list once, you hang it on the row, and a program opening the file afterwards finds it exactly there. The names in the list are yours, and nothing here reads them.

Technically

Written at the top level of a request, under "carried_facts"

carried_facts writes one dictionary per list as an object of its own and names it in the /Properties of every page, and an item naming one brackets everything it draws between /Tag /MC1 BDC … EMC. The run carries no /MCID, so the structure tree points at nothing there: facts is stated with tag and never beside mark, and either way round is refused. A list is written once however many items name it, and may be hung on runs on as many pages as the document has. A name no entry declared is refused before anything is drawn, and an item inside a named drawing states none of this.

Request Schema

  • carried_facts — array, optional, empty by default.
  • carried_facts[].name — string, required. The name items hang this list on what they draw by.
  • carried_facts[].facts — object, optional, empty by default. The entries, under your own names. A value is a string, a whole number, a number or a boolean; nothing here reads them.
  • An item hangs one on what it draws through its facts key, carrying the name declared here, beside the tag it opens the run under. An item with no facts carries none.
  • facts beside mark is refused, and facts without tag is refused: a run carrying a list carries no number, so the structure tree can claim nothing there.

Scope: one run of ink. private_data leaves the same on the whole document, page_private_data on one page, and drawings[].private_data on a named drawing.

A Whole Request That Creates a PDF

{
  "carried_facts": [
    {
      "name": "Line",
      "facts": {
        "order": "SO-4417",
        "quantity": 3,
        "price": 12.5,
        "urgent": true
      }
    }
  ],
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 700, "urx": 523, "ury": 740 },
      "content": ["Three widgets, blue"],
      "font": "sans",
      "font_size": 12,
      "tag": "Line",
      "facts": "Line"
    }
  ]
}

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 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 PDF Version the File Declares 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