Previous Next

                                                          582
                CHAPTER 8                                                            Interactive Features



                tions” on page 654 and “Remote Go-To Actions” on page 655). In each case, the
                destination specifies the view of the document to be presented when the outline
                item or annotation is opened or the action is performed. In addition, the optional
                OpenAction entry in a document’s catalog (Section 3.6.1, “Document Catalog”)
                may specify a destination to be displayed when the document is opened. A desti-
                nation may be specified either explicitly by an array of parameters defining its
                properties or indirectly by name.


                Explicit Destinations

                Table 8.2 shows the allowed syntactic forms for specifying a destination explicitly
                in a PDF file. In each case, page is an indirect reference to a page object. All coor-
                dinate values (left, right, top, and bottom) are expressed in the default user space
                coordinate system. The page’s bounding box is the smallest rectangle enclosing all
                of its contents. (If any side of the bounding box lies outside the page’s crop box,
                the corresponding side of the crop box is used instead; see Section 10.10.1, “Page
                Boundaries,” for further discussion of the crop box.)

                Note: No page object can be specified for a destination associated with a remote go-
                to action (see “Remote Go-To Actions” on page 655) because the destination page is
                in a different PDF document. In this case, the page parameter specifies a page num-
                ber within the remote document instead of a page object in the current document.

                                            TABLE 8.2 Destination syntax
SYNTAX                                MEANING

[ page /XYZ left top zoom ]           Display the page designated by page, with the coordinates (left, top) posi-
                                      tioned at the upper-left corner of the window and the contents of the page
                                      magnified by the factor zoom. A null value for any of the parameters left, top,
                                      or zoom specifies that the current value of that parameter is to be retained un-
                                      changed. A zoom value of 0 has the same meaning as a null value.

[ page /Fit ]                         Display the page designated by page, with its contents magnified just enough
                                      to fit the entire page within the window both horizontally and vertically. If
                                      the required horizontal and vertical magnification factors are different, use
                                      the smaller of the two, centering the page within the window in the other
                                      dimension.

Previous Next