Previous Next

                                           383
SECTION 4.10                                                            Optional Content



The entries in the usage dictionary are used as follows:

• View : The recommended state is the value of the ViewState entry. This entry al-
  lows a document to contain content that is relevant only when the document is
  viewed interactively, such as instructions for how to interact with the docu-
  ment.
• Print: The recommended state is the value of the PrintState entry. If PrintState
  is not present, the state of the optional content group is left unchanged.
• Export: The recommended state is the value of the ExportState entry.
• Zoom: If the current magnification level of the document is greater than or
  equal to min and less than max, an ON state is recommended; otherwise, OFF is
  recommended.
• User: The Name entry specifies a name or names to match with the user’s iden-
  tification. The Type entry determines how the Name entry is interpreted
  (name, title, or organization). If there is an exact match, an ON state is recom-
  mended; otherwise OFF is recommended.
• Language: This category allows the selection of content based on the language
  and locale of the application. If an exact match to the language and locale is
  found among the Lang entries of the optional content groups in the usage ap-
  plication dictionary’s OCGs list, all groups that have exact matches receive an
  ON recommendation. If no exact match is found, but a partial match is found
  (that is, the language matches but not the locale), all partially matching groups
  that have Preferred entries with a value of ON receive an ON recommendation.
  All other groups receive an OFF recommendation.

Example 4.39 shows the use of an auto state array with usage application dictio-
naries. The AS entry in the default configuration dictionary is an array of three
usage application dictionaries, one for each of the Event values View, Print, and
Export.

Note: While this case is typical, there is no restriction on multiple entries with the
same value of Event, which allows documents with incompatible usage application
dictionaries to be combined into larger documents and have their behavior pre-
served. If a given optional content group appears in more than one OCGs array, its
state is ON only if all categories in all the usage application dictionaries it appears in
recommend a state of ON.

Previous Next