### ----------------------------------------------------
### -- PDF::ISO_32000_2
### -- Licenses: Artistic-2.0
### -- Authors: David Warring
### -- File: resources/ISO_32000_2/Table_177-Additional_entries_specific_to_a_free_text_annotation.json
### ----------------------------------------------------
{
  "table": {
    "caption": "Table 177 — Additional entries specific to a free text annotation",
    "head": [
      "Key",
      "Type",
      "Value"
    ],
    "rows": [
      [
        "Subtype",
        "name",
        "(Required) The type of annotation that this dictionary describes; is FreeText for a free text annotation."
      ],
      [
        "DA",
        "string",
        "(Required) The default appearance string that is used in formatting the text (see 12.7.4.3, \"Variable text\").\nThe annotation dictionary’s AP entry, if present, takes precedence over the DA entry (see “Table 170 — Entries in an appearance dictionary” and 12.5.5, “Appearance streams”)."
      ],
      [
        "Q",
        "integer",
        "(Optional; PDF 1.4) A code specifying the form of quadding (justification)\nthat is used in displaying the annotation’s text:\n0 Left-justified\n1 Centred\n2 Right-justified\nDefault value: 0 (left-justified)."
      ],
      [
        "RC",
        "text string or text stream",
        "(Optional; PDF 1.5) A rich text string (see Adobe XML Architecture, XML Forms Architecture (XFA) Specification, version 3.3) that is used to generate the appearance of the annotation.\nNOTE As freetext annotations do not have an open state this cannot apply to the popup window as described for the RC key in \"Table 172 — Additional entries in an annotation dictionary specific to markup annotations\"."
      ],
      [
        "DS",
        "text string",
        "(Optional; PDF 1.5) A default style string, as described in Adobe XML Architecture, XML Forms Architecture (XFA) Specification, version 3.3."
      ],
      [
        "CL",
        "array",
        "(Optional; meaningful only if IT is FreeTextCallout; PDF 1.6) An array of four or six numbers specifying a callout line attached to the free text annotation. Six numbers [x1 y1 x2 y2 x3 y3] represent the starting, knee point, and ending coordinates of the line in default user space, as shown in \"Figure 79 — Free text annotation with callout\". Four numbers [x1 y1 x2 y2] represent the starting and ending coordinates of the line."
      ],
      [
        "IT",
        "name",
        "(Optional; PDF 1.6) A name describing the intent of the free text annotation (see also the IT entry in \"Table 172 — Additional entries in an annotation dictionary specific to markup annotations\"). The following values is valid:\nFreeText The annotation is intended to function as a plain free-text annotation. A plain free-text annotation is also known as a text box comment.\nFreeTextCallout The annotation is intended to function as a callout. The callout is associated with an area on the page through the callout line specified in CL.\nFreeTextTypeWriter The annotation is intended to function as a click-to-type or typewriter object and no callout line is drawn.\nDefault value: FreeText"
      ],
      [
        "BE",
        "dictionary",
        "(Optional; PDF 1.6) A border effect dictionary (see \"Table 169 — Entries in a border effect dictionary\") used in conjunction with the border style dictionary specified by the BS entry."
      ],
      [
        "RD",
        "rectangle",
        "(Optional; PDF 1.6) A set of four numbers describing the numerical differences between two rectangles: the Rect entry of the annotation and a rectangle contained within that rectangle. The inner rectangle is where the annotation’s text is displayed. Any border styles and/or border effects specified by BS and BE entries, respectively, is applied to the border of the inner rectangle.\nThe four numbers correspond to the differences in default user space between the left, top, right, and bottom coordinates of Rect and those of the inner rectangle, respectively. Each value is greater than or equal to 0. The sum of the top and bottom differences is less than the height of Rect, and the sum of the left and right differences is less than the width of Rect."
      ],
      [
        "BS",
        "dictionary",
        "(Optional; PDF 1.6) A border style dictionary (see \"Table 168 — Entries in a border style dictionary\") specifying the line width and dash pattern that is used in drawing the annotation’s border."
      ],
      [
        "LE",
        "name",
        "(Optional; meaningful only if CL is present; PDF 1.6) A name specifying the line ending style that is used in drawing the callout line specified in CL. The name specifies the line ending style for the endpoint defined by the pairs of coordinates (x1, y1). \"Table 179 — Line ending styles\" shows the possible line ending styles.\nDefault value: None."
      ]
    ]
  }
}


