A Font Whose Makers Forbid Carrying It

Say what a font whose own flag forbids carrying it does to the document: carried with a warning, described only, or refused.

Summary

A font file carries a note from the people who made it, saying whether it may travel inside a document. Most allow it; a few forbid it. When a request uses one of those, you choose what happens: the font goes in all the same and the answer tells you so, or only its description goes in and reading software draws with its own copy, or the document is refused and the answer names the font.

Technically

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

font_permissions reads the embedding flag a font states in its OS/2 table, fsType, and acts on a font whose flag says it is restricted, the one value that forbids carrying it. warn, the default, carries the font and names it among the remarks of the answer; leave_out carries its description alone, as a font named in fonts_described_only is; refuse refuses the document, naming the font. A font whose flag allows embedding is carried whichever value is set.

Request Schema

  • font_permissions — string, optional, warn by default. One of warn, leave_out, refuse.

Scope: every font of the request that states such a flag.

A Whole Request That Creates a PDF

One name below stands for a font file: put the encoded file in its place, or send the file itself beside the description, as a supplied part of the same call. One page carries a real font already encoded, and its request posts as it stands. 

{
  "fonts": [{ "name": "body", "data": "PASTE_THE_FONT_FILE_BASE64_HERE" }],
  "font_permissions": "refuse",
  "items": [
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 700, "urx": 523, "ury": 740 },
      "content": ["Refused if the font forbids being carried"],
      "font": "body",
      "font_size": 16
    }
  ]
}

The line that sends it, in three languages

The fonts

Carrying a Font inside the Document The Older Type 1 Font Programs The Fourteen Fonts All Reading Software Owns The Typographic Niceties of a Font A Font Whose Letters You Draw Yourself A Backup Font for the Rarer Signs Fonts Whose Letters Cost One Byte Fonts Whose Signs Come Out in Colour Fonts the Document Names without Carrying Fonts Carried Whole

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