Page Interface

The page interface contains routines that create, access or destroy pages of data. Pages exist only in terms of the document which contains them. Pages can be created or acquired by page sequence numbers. They can be deleted or moved from one document to another. They may also be re-sequenced within a document.

A page object reflects a single side of a single sheet of media (a physical page). It can be larger than the actual page image since it contains both the physical page and cropped (logical) page image size. A page must have at least one container, to provide structural grouping, which is built when the page is constructed.

The page’s scaling and location within presentation media are defined by the page’s matrix when it is created or accessed. Annotations can be created for viewing or removed from view. The electronic view of a page can show one of three areas:

  •  the rectangular area that encloses all text, graphics, and images on the page
  • the logical page which is defined by crop marks
  • the physical page

NOTE:  The Adobe PDF Library requires the x and y coordinates of the elements it adds to a page from the driver application.

Order Method Description
1  PDDocCreatePage()  Creates and acquires a new page. The page is inserted into the document at a specified location.
2  PDDocAcquirePage()  Increments the page’s reference count.
3  PDDocDeletePage()  Deletes the specified pages, inclusively.
4  PDDocInsertPages()  Inserts pages from one document into another document, including anything associated with the page, such as annotations.
5  PDDocReplacePages()  Replaces a specified range of pages in one document with pages from another.
6  PDDocMovePage()  Re-sequences pages within a document.
7  PDPageGetBBox()  Gets the bounding box for a page. A bounding box is the rectangle that encloses all text, graphics, and images on the page.
8  PDPageSetCropBox()  Sets the crop box for a page. A crop box is the region of the page that is displayed and printed.
9  PDPageGetCropBox()  Gets the crop box for a page.
10  PDPageSetMediaBox  Sets the media box for a page. The media box is the dimensions of the physical page.
11  PDPageGetMediaBox()  Gets the media box for a page.
12  PDPageAddAnnot()  Adds an annotation at the specified location in a page’s annotation array.
13  PDPageAddNewAnnot()  Adds an annotation to the page.
14  PDPageGetAnnot()  Gets a specific annotation on a page.
15  PDPageGetAnnotIndex()  Gets the index of a given annotation object on a specified page.
16  PDPageRemoveAnnot()  Removes an annotation from the specified page.
17  PDPageGetDefaultMatrix()  Gets the matrix that transforms user space coordinates to rotated and cropped coordinates.
18  PDPageGetFlippedMatrix()  Gets the matrix that transforms user space coordinates to rotated and cropped coordinates.
19  PDPageAquirePDEContent()  Creates a PDEContent from the PDPage’s contents and resources.
20  PDPageEnumContent() Enumerates the contents of a page, calling a procedure for each drawing object in the page description.
21  PDPageGetNumber()  Gets the page number for a specified page.
22  PDPageGetDoc() Gets the document that contains a specified page.