### ----------------------------------------------------
### -- PDF::ISO_32000
### -- Licenses: Artistic-2.0
### -- Authors: David Warring
### -- File: resources/ISO_32000/Table_101-Entries_in_an_Optional_Content_Configuration_Dictionary.json
### ----------------------------------------------------
{
  "table": {
    "caption": "Table 101 – Entries in an Optional Content Configuration Dictionary",
    "head": [
      "Key",
      "Type",
      "Value"
    ],
    "rows": [
      [
        "Name",
        "text string",
        "(Optional) A name for the configuration, suitable for presentation in a user interface."
      ],
      [
        "Creator",
        "text string",
        "(Optional) Name of the application or feature that created this configuration dictionary."
      ],
      [
        "BaseState",
        "name",
        "(Optional) Used to initialize the states of all the optional content groups in a document when this configuration is applied. The value of this entry is one of the following names:\nON The states of all groups is turned ON.\nOFF The states of all groups is turned OFF.\nUnchanged The states of all groups is left unchanged.\nAfter this initialization, the contents of the ON and OFF arrays is processed, overriding the state of the groups included in the arrays.\nDefault value: ON.\nIf BaseState is present in the document’s default configuration dictionary, its value is ON."
      ],
      [
        "ON",
        "array",
        "(Optional) An array of optional content groups whose state is set to ON when this configuration is applied.\nIf the BaseState entry is ON, this entry is redundant."
      ],
      [
        "OFF",
        "array",
        "(Optional) An array of optional content groups whose state is set to OFF when this configuration is applied.\nIf the BaseState entry is OFF, this entry is redundant."
      ],
      [
        "Intent",
        "name or array",
        "(Optional) A single intent name or an array containing any combination of names. it is used to determine which optional content groups’ states to consider and which to ignore in calculating the visibility of content (see 8.11.2.3, \"Intent\").\nPDF defines two intent names, View and Design. In addition, the name All indicates the set of all intents, including those not yet defined. Default value: View. The value is View for the document’s default configuration."
      ],
      [
        "AS",
        "array",
        "(Optional) An array of usage application dictionaries (see Table 103) specifying which usage dictionary categories (see Table 102) is consulted by conforming readers to automatically set the states of optional content groups based on external factors, such as the current system language or viewing magnification, and when they is applied."
      ],
      [
        "Order",
        "array",
        "(Optional) An array specifying the order for presentation of optional content groups in a conforming reader’s user interface. The array elements may include the following objects:\nOptional content group dictionaries, whose Name entry is displayed in the user interface by the conforming reader.\nArrays of optional content groups which may be displayed by a conforming reader in a tree or outline structure. Each nested array may optionally have as its first element a text string to be used as a non-selectable label in a conforming reader’s user interface.\nText labels in nested arrays is used to present collections of related optional content groups, and not to communicate actual nesting of content inside multiple layers of groups (see EXAMPLE 1 in 8.11.4.3, \"Optional Content Configuration Dictionaries\"). To reflect actual nesting of groups in the content, such as for layers with sublayers, nested arrays of groups without a text label is used (see EXAMPLE 2 in 8.11.4.3, \"Optional Content Configuration Dictionaries\").\nAn empty array [] explicitly specifies that no groups is presented.\nIn the default configuration dictionary, the default value is an empty array; in other configuration dictionaries, the default is the Order value from the default configuration dictionary.\nAny groups not listed in this array is not presented in any user interface that uses the configuration."
      ],
      [
        "ListMode",
        "name",
        "(Optional) A name specifying which optional content groups in the Order array is displayed to the user. Valid values is:\nAllPages Display all groups in the Order array.\nVisiblePages Display only those groups in the Order array that are referenced by one or more visible pages.\nDefault value: AllPages."
      ],
      [
        "RBGroups",
        "array",
        "(Optional) An array consisting of one or more arrays, each of which represents a collection of optional content groups whose states is intended to follow a radio button paradigm. That is, the state of at most one optional content group in each array is ON at a time. If one group is turned ON, all others is turned OFF. However, turning a group from ON to OFF does not force any other group to be turned ON.\nAn empty array [] explicitly indicates that no such collections exist.\nIn the default configuration dictionary, the default value is an empty array; in other configuration dictionaries, the default is the RBGroups value from the default configuration dictionary."
      ],
      [
        "Locked",
        "array",
        "(Optional; PDF 1.6) An array of optional content groups that is locked when this configuration is applied. The state of a locked group cannot be changed through the user interface of a conforming reader. Conforming writers can use this entry to prevent the visibility of content that depends on these groups from being changed by users.\nDefault value: an empty array.\nA conforming reader may allow the states of optional content groups from being changed by means other than the user interface, such as JavaScript or items in the AS entry of a configuration dictionary."
      ]
    ]
  }
}


