NAME

Text::PDF::Pages - a PDF pages hierarchical element. Inherits from Text::PDF::Dict

DESCRIPTION

A Pages object is the parent to other pages objects or to page objects themselves.

METHODS

Text::PDF::Pages->new($parent)

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.

$p->add_page($page, $index)

Appends a page to this pages object or if defined $index then inserts the page at that index in the elements array of this pages object (note that does not equal the page number)

$p->find_prop($key)

Searches up through the inheritance tree to find a property.

$p->add_font($font)

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.

$p->bbox($xmin, $ymin, $xmax, $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 box'es can be set with this method.

$p->proc_set(@entries)

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.