SECTION 4.10
381
Optional Content
KEY
TYPE
VALUE
Export
dictionary
(Optional)
A dictionary containing one entry,
ExportState
, a name whose value
may be
ON
or
OFF
. This value indicates the recommended state for content in this
group when the document (or part of it) is saved by a viewer application to a for-
mat that does not support optional content (for example, an earlier version of
PDF or a raster image format).
(Optional)
A dictionary specifying a range of magnifications at which the content
in this optional content group is best viewed. It may contain one or both of the
following entries:
Zoom
dictionary
•
min
: The minimum recommended magnification factor at which the group
should be
ON
. Default value: 0.
•
max
: The magnification factor below which the group should be
ON
. Default
value: infinity.
Print
dictionary
(Optional)
A dictionary specifying that the content in this group is intended for
use in printing. It contains the following optional entries:
•
Subtype
: A name object specifying the kind of content controlled by the group;
for example,
Trapping
,
PrintersMarks
and
Watermark
.
•
PrintState
: A name that may be
ON
or
OFF
, indicating that the group should be
set to that state when the document is printed from a viewer application.
View
dictionary
(Optional)
A dictionary that has a single entry,
ViewState
, a name that may have a
value of
ON
or
OFF
, indicating that the group should be set to that state when the
document is opened in a viewer application.
(Optional)
A dictionary specifying one or more users for whom this optional con-
tent group is primarily intended. Each dictionary has two required entries:
User
dictionary
•
Type
: A name object that can be
Ind
(individual),
Ttl
(title), or
Org
(organiza-
tion).
•
Name
: A text string or array of text strings representing the name(s) of the in-
dividual, position or organization.
PageElement
dictionary
(Optional)
A dictionary declaring that the group contains a pagination artifact. It
contains one entry,
Subtype
, whose value is a name that can be
HF
(header/foot-
er),
FG
(foreground image or graphic),
BG
(background image or graphic), or
L
(logo).
While the data in the usage dictionary can be viewed as information for a docu-
ment user to examine, it can also be used by viewer applications to automatically