PDF::API2::Page.3pm

Langue: en

Autres versions - même langue

Version: 2007-05-08 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

$page = PDF::API2::Page->new $pdf, $parent, $index

Returns a page object (called from $pdf->page).
$page = PDF::API2::Page->coerce $pdf, $pdfpage
Returns a page object converted from $pdfpage (called from $pdf->openpage).
$page->update
Marks a page to be updated (by $pdf->update).
$page->mediabox $w, $h
$page->mediabox $llx, $lly, $urx, $ury
$page->mediabox $alias
Sets the mediabox. This method supports the following aliases: '4A', '2A', 'A0', 'A1', 'A2', 'A3', 'A4', 'A5', 'A6', '4B', '2B', 'B0', 'B1', 'B2', 'B3', 'B4', 'B5', 'B6', 'LETTER', 'BROADSHEET', 'LEDGER', 'TABLOID', 'LEGAL', 'EXECUTIVE', and '36X36'.
($llx, $lly, $urx, $ury) = $page->get_mediabox
Gets the mediabox based one best estimates or the default.
$page->cropbox $w, $h
$page->cropbox $llx, $lly, $urx, $ury
$page->cropbox $alias
Sets the cropbox. This method supports the same aliases as mediabox.
($llx, $lly, $urx, $ury) = $page->get_cropbox
Gets the cropbox based one best estimates or the default.
$page->bleedbox $w, $h
$page->bleedbox $llx, $lly, $urx, $ury
$page->bleedbox $alias
Sets the bleedbox. This method supports the same aliases as mediabox.
($llx, $lly, $urx, $ury) = $page->get_bleedbox
Gets the bleedbox based one best estimates or the default.
$page->trimbox $w, $h
$page->trimbox $llx, $lly, $urx, $ury
Sets the trimbox. This method supports the same aliases as mediabox.
($llx, $lly, $urx, $ury) = $page->get_trimbox
Gets the trimbox based one best estimates or the default.
$page->artbox $w, $h
$page->artbox $llx, $lly, $urx, $ury
$page->artbox $alias
Sets the artbox. This method supports the same aliases as mediabox.
($llx, $lly, $urx, $ury) = $page->get_artbox
Gets the artbox based one best estimates or the default.
$page->rotate $deg
Rotates the page by the given degrees, which must be a multiple of 90.

(This allows you to auto-rotate to landscape without changing the mediabox!)

$gfx = $page->gfx $prepend
Returns a graphics content object. If $prepend is true the content will be prepended to the page description.
$txt = $page->text $prepend
Returns a text content object. If $prepend is true the content will be prepended to the page description.
$ant = $page->annotation
Returns a new annotation object.
$page->resource $type, $key, $obj
Adds a resource to the page-inheritance tree.

Example:

     $co->resource('Font',$fontkey,$fontobj);
     $co->resource('XObject',$imagekey,$imageobj);
     $co->resource('Shading',$shadekey,$shadeobj);
     $co->resource('ColorSpace',$spacekey,$speceobj);
 
 

Note: You only have to add the required resources, if they are NOT handled by the *font*, *image*, *shade* or *space* methods.

AUTHOR

alfred reibenschuh

HISTORY

     $Log: Page.pm,v $
     Revision 2.1  2007/05/08 18:32:09  areibens
     renamed compress to compressFlate
 
     Revision 2.0  2005/11/16 02:16:00  areibens
     revision workaround for SF cvs import not to screw up CPAN
 
     Revision 1.2  2005/11/16 01:27:48  areibens
     genesis2
 
     Revision 1.1  2005/11/16 01:19:24  areibens
     genesis
 
     Revision 1.15  2005/11/02 18:18:20  fredo
     added get_(crop/bleed/trim/art)box methods
 
     Revision 1.14  2005/08/06 20:59:10  fredo
     fixed anotation pdf-array again for other braindead softs
 
     Revision 1.13  2005/06/17 19:43:47  fredo
     fixed CPAN modulefile versioning (again)
 
     Revision 1.12  2005/06/17 18:53:33  fredo
     fixed CPAN modulefile versioning (dislikes cvs)
 
     Revision 1.11  2005/06/14 12:54:16  fredo
     fix for existing annotation dictionary (ex. ScanSoft PDF)
 
     Revision 1.10  2005/03/14 22:01:05  fredo
     upd 2005
 
     Revision 1.9  2004/12/16 00:30:52  fredo
     added no warn for recursion
 
     Revision 1.8  2004/09/13 15:27:59  fredo
     added rotate for acrobat-wise pdf-creators
 
     Revision 1.7  2004/06/15 09:11:38  fredo
     removed cr+lf
 
     Revision 1.6  2004/06/09 16:29:12  fredo
     fixed named page size handling for *box methods
 
     Revision 1.5  2004/06/07 19:44:12  fredo
     cleaned out cr+lf for lf
 
     Revision 1.4  2003/12/08 13:05:19  Administrator
     corrected to proper licencing statement
 
     Revision 1.3  2003/11/30 17:17:37  Administrator
     merged into default
 
     Revision 1.2.2.1  2003/11/30 16:56:22  Administrator
     merged into default
 
     Revision 1.2  2003/11/30 11:32:33  Administrator
     added CVS id/log
 
 

POD ERRORS

Hey! The above document had some coding errors, which are explained below:
Around line 81:
'=item' outside of any '=over'
Around line 557:
You forgot a '=back' before '=head1'