Graphics Programs Reference
In-Depth Information
Table 7-2. Entries in an outline dictionary
Key
Value type
Value
/Type
name
If present, must be
/Outlines
.
/First
indirect reference to dictionary
An outline item dictionary for the first top-level item in the document outline.
Required if any document outline entries present.
/Last
indirect reference to dictionary
An outline item dictionary for the last top-level item in the document outline.
Required if any document outline entries present.
/Count
integer
The total number of open outline entries in all parts of the outline. May be
omitted if no open entries.
Table 7-3. Entries in an outline item dictionary *denotes a required entry
Key
Value type
Value
/Title
*
text string
Text to be displayed for this entry.
/Parent
*
indirect reference to dictionary
Pointer to the parent of this item in the outline tree. Either another outline
item dictionary or the top-level outline dictionary.
/Prev
indirect reference to dictionary
Pointer to the previous item at this level, if there is one.
/Next
indirect reference to dictionary
Pointer to the next item at this level, if there is one.
/First
indirect reference to dictionary
Pointer to the first child item of this entry, if it has one.
/Last
indirect reference to dictionary
Pointer to the last child item of this entry, if it has one.
/Count
integer
The number of open entries below this one, if this entry is open. If closed, a
negative integer whose absolute value is the number of descendants which
would be revealed if this item were to be opened by the user.
/Dest
name, string or array
The destination. Arrays are destinations, names are references to entries in
the
/Dests
entry in the document catalog, strings are references to entries
in the
/Dests
entry in the document's name dictionary.
Building an example
Consider a file with three pages. We wish to build the following hierarchy:
Part 1
(points to page one)
Part 1A
(points to page two)
Part 1B
(points to page three)
The resultant code is shown in
Example 7-1
. The page objects in this document have
object numbers 3, 5, and 7 for pages one, two and three respectively. Object 12 is the
document catalog. Object 11 is the document outline dictionary, and objects 8, 9, and
10 are document outline item dictionaries.
