Graphics Programs Reference
In-Depth Information
Destinations
A destination defines a place in a PDF file, consisting of the page number, position
within that page, and magnification to use when viewing that page. Destinations may
be defined explicitly (as we will do for simplicity) or referenced by a name and looked
up in a document-wide
name tree
listing all destinations. The bookmarks are typically
displayed alongside the document in a PDF viewer.
Destinations are defined using an array object, with the contents depending upon the
kind of destination. Destination syntax is summarized in
Table 7-1
.
Table 7-1. Syntax for destinations. “page” is an indirect reference to a page object. Destinations use
the crop box (or media box if there is no crop box) unless otherwise specified.
Array
Description
[
page
/Fit]
Display the page at a scale which just fits the whole page in the window both horizontally
and vertically.
[
page
/FitH
top
]
Display the page with the vertical coordinate
top
at the top edge of the window, and
the magnification set to fit the document horizontally.
[
page
/FitV
left
]
Display the page with the horizontal coordinate
left
at the left edge of the window, and
the magnification set to fit the document vertically.
[
page
/XYZ
left
top
zoom
]
Display the page with (
left
,
top
) at the upper-left corner of the window and the page
magnified by factor
zoom
. A null value for any parameter indicates no change.
[
page
/FitR
left
bottom
right
top
]
Display the page zoomed to show the rectangle specified by
left
,
bottom
,
right
, and
top
.
[
page
/FitB]
Display the page like
/Fit
, but use the bounding box of the page's contents, rather
than the crop box.
[
page
/FitBH
top
]
Display the page like
/FitH
, but use the bounding box of the page's contents, rather
than the crop box.
[
page
/FitBV
left
]
Display the page like
/FitV
, but use the bounding box of the page's contents, rather
than the crop box.
The Document Outline (Bookmarks)
The document outline consists of a tree of outline entries defined by an
outline dic-
tionary
and a number of
outline item dictionaries
. The outline dictionary is pointed to
by the
/Outlines
entry in the document catalog. The subentries (children) for an entry
may be shown by default (
open
) or concealed by default and only revealed by clicking
(
closed
). The outline dictionaries are summarized in Tables
7-2
and
7-3
.