Skip to content
Back to top

# Glossary

Alpha
Opacity

  Alpha values are real numbers in the closed interval from 0 to 1, where 0 means full transparency, and 1 means full opacity.

Annotation Type

  There are many annotation types defined in the PDF reference.

  MuPDF supports the following types:

    Text, FreeText, Square, Circle, Line, Polygon, PolyLine, Highlight, Underline, Squiggly, StrikeOut, Redact, Stamp, Caret, Ink, Popup, FileAttachment, Redaction

  These types are not supported yet:

    Sound, Movie, RichMedia, Widget, Screen, PrinterMark, TrapNet, Watermark, 3D, Projection

Associated File

  TODO

Blend Mode

  Blend modes define how a layer of graphics combines with a backdrop.

  Below is an illustration of the visual effect for RGB colors for the blend modes defined for PDF.

  For further details refer to the PDF specification’s section on blend modes.

Border Effect
  Fancier borders can be drawn with a border effect:

    None, Cloudy

Border Style
  Annotations have have two border styles:

    Solid, Dashed

  More fancy borders are defined by the border effect.

CMYK JPEG

  The situation with JPEG and CMYK colorspaces is complicated, and depends on many factors such as App markers, the ColorTransform PDF parameter, and whether a JPEG is intended as a standalone or embedded in PDF.

  TODO: explain our behavior, and adobe’s behavior, and when impossible situations appear

File specification

  In PDF a file specification names a file.

  If a file specification only contains a file name or a path, then it represents an external file. Such a file is assumed to be found at the specified location in the file system.

  A file specification may also embed the file contents as a stream inside the PDF. In this case the file specification represents an embedded file. For embedded files, further metadata may be stored (e.g. file size, creation and modification date).

  For more details read the PDF specification’s section on file specifications.

Icon Name

  Some annotations appear as an icon. The available icons differ per annotation type.

  Text

    Comment, Help, Insert, Key, NewParagraph, Note, Paragraph

  FileAttachment

    Graph, PaperClip, PushPin, Tag

  Sound

    Mic, Speaker

  Stamp

    Approved, AsIs, Confidential, Departmental, Draft, Experimental, Expired, Final, ForComment, ForPublicRelease, NotApproved, NotForPublicRelease, Sold, TopSecret

Knockout and Isolation

  In a knockout transparency group each element overwrites the prior elements in the group instead of compositing with them.

  In an isolated transparency group the group does not composite with the group’s backdrop, but rather a fully transparent backdrop.

  For further details refer to the PDF specification’s sections on isolation and knockout.

Language code

  Language codes consists of a primary code, followed zero or more by subcodes each preceded by a hyphen, e.g. “en”, “en-US”, “kr”, “zh-CN”, “zh-TW”.

  For further details see the PDF specification’s section on Language Identifiers.

Line Cap Style

  PDFs define three different shapes for the ends of unclosed subpaths: butt cap, round cap, and square cap. See below for the visual effect and refer to the PDF specifications section about Line Cap Styles for details.

Line Ending Style

  Styles used to draw line endings for certain annotations. Below is an illustration with the name of each style. The example uses black line color, with both none and blue interior color.

Line Join Style

  PDFs define three different shapes for the joining of two lines in a subpath: miter join, round join, and bevel join. See below for the visual effects and refer to the PDF specifications section about Line Join Styles for details.

MIME-type

  A MIME-type is a string describing the type of data. PDF data has the MIME-type “application/pdf”, while unknown data has the MIME-type “application/octet-stream”. For further details see the specification that the PDF specification references: RFC 2048 - Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types.

Miter Limit

  When mitered line joins are used, then lines joining at sharper and sharper angles will produce longer and longer miters. The miter may stick out longer than anticipated. Therefore PDF defines a miter limit value, at which a longer miter join will be changed to a bevel join. See below for the visual effects and refer to the PDF specifications section about Miter Limit for details.

Page Box

  The PDF reference defines several boxes to determine different parts of a page. See the chapter on Page Boundaries for more details.

  MediaBox

    The MediaBox defines the size of the physical medium on which the page is to be printed. It includes items that will be physically trimmed from the final product like crop marks, registration marks, etc.

  CropBox

    The CropBox defines the visible region of the page to be displayed or printed. This has no real meaning, but is used to clip the page contents when rendering.

  BleedBox

    The BleedBox defines the region to which the page contents expect to be clipped. This includes any extra bleed area to account for imprecision in the printing process.

  TrimBox

    The TrimBox defines the intended dimensions of the finished page after trimming.

  ArtBox

    The ArtBox defines the area where it is considered safe to place graphical elements.

QuadPoint

  A QuadPoint in PDF is a non-axis aligned quadrilateral, used to define areas on the page that typically cover text (which may be rotated, or skewed). It is given as an array of 8 numbers (four x, y pairs).

  QuadPoints are used with Link and text markup annotations.

  The order of the points is a matter of confusion, because the order used in the PDF reference doesn’t match the order that Adobe uses.

  This is the order that is typically used:

    `[ ulx uly urx ury llx lly lrx lry ]`

Standard Structure Type

  The PDF specification defines how a PDF can specify a logical structure hierarchy of elements, similar to of HTML or XML. Each of the defined structure elements, e.g. Div, BlockQuote, P, H1-H6 etc., are associated with some visual content.

Widget Type

  Widgets are a type of annotation. There are a few different subtypes:

  Btn

    Pushbutton, Check Boxes, Radio Buttons

  Tx

    Text Fields

  Ch

    Choice Fields (list box, combo box)

  Sig

    Signature Field

Winding
Non-zero Winding Number Rule
Even-Odd Rule

  These rules in PDF defined what parts of a `Path` are inside and outside the curve respectively. This is used to determine what parts of a curve should be filled.

  See the PDF specification sections on the Non-zero Winding Number Rule and Even-Odd Rule.