Manual Reference Pages - TEXT::PDF::PAGES (3)
Text::PDF::Pages - a PDF pages hierarchical element. Inherits from Text::PDF::Dict
A Pages object is the parent to other pages objects or to page objects
This creates a new Pages object. Notice that $parent here is not the
file context for the object but the parent pages object for this
pages. If we are using this class to create a root node, then $parent
should point to the file context, which is identified by not having a
Type of Pages. $pdfs is the file object (or objects) in which to
create the new Pages object.
Tells all the files that this thing is destined for that they should output this
object come time to output. If this object has no parent, then it must be the
root. So set as the root for the files in question and tell it to be output too.
If $isnew is set, then call new_obj rather than out_obj to create as a new
object in the file.
Returns the given page, using the page count values in the pages tree. Pages
start at 0.
Inserts the page before the given $pnum. $pnum can be -ve to count from the END
of the document. -1 is after the last page. Likewise $pnum can be greater than the
number of pages currently in the document, to append.
This method only guarantees to provide a reasonable pages tree if pages are
appended or prepended to the document. Pages inserted in the middle of the
document may simply be inserted in the appropriate leaf in the pages tree without
adding any new branches or leaves. To tidy up such a mess, it is best to call
$p->rebuild_tree to rebuild the pages tree into something efficient.
CW$root_pages = CW$p->rebuild_tree([@pglist])
Rebuilds the pages tree to make a nice balanced tree that conforms to Adobe
recommendations. If passed a pglist then the tree is built for that list of
pages. No check is made of whether the pglist contains pages.
Returns the top of the tree for insertion in the root object.
CW@pglist = CW$p->get_pages
Returns a list of page objects in the document in page order
Searches up through the inheritance tree to find a property.
Creates or edits the resource dictionary at this level in the hierarchy. If
the font is already supported even through the hierarchy, then it is not added.
CW$p->bbox($xmin, CW$ymin, CW$xmax, CW$ymax, [$param])
Specifies the bounding box for this and all child pages. If the values are
identical to those inherited then no change is made. $param specifies the attribute
name so that other bounding boxes can be set with this method.
Ensures that the current resource contains all the entries in the proc_sets
listed. If necessary it creates a local resource dictionary to achieve this.
Returns the top of the pages tree
|perl v5.20.3 ||TEXT::PDF::PAGES (3) ||2006-03-17 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.