Docs For Class Zend

Description

General entity which describes PDF document.

It implements document abstraction with a document level operations.

Class is used to create new PDF document or load existing document. See details in a class constructor description

Class agregates document level properties and entities (pages, bookmarks, document level actions, attachments, form object, etc)

copyright: Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
license: New BSD License

Located in /Pdf.php (line 99)

Class Constant Summary

PDF_HEADER = "%PDF-1.4\n%\xE2\xE3\xCF\xD3\n"

PDF_VERSION = 1.4

Variable Summary

array $pages

Method Summary

static Zend_Memory_Manager getMemoryManager ()

static Zend_Pdf load ([string $source = null], [integer $revision = null])

static Zend_Pdf parse ([ &$source = null], [integer $revision = null], string $source)

static string pdfDate ([integer $timestamp = null])

static void setMemoryManager ( $memoryManager)

Zend_Pdf __construct ([string $source = null], [integer $revision = null], [ $load = false])

string getJavaScript ()

array getNamedActions ()

Zend_Pdf_Page newPage (mixed $param1, [mixed $param2 = null])

array properties ()

string render ([boolean $newSegmentOnly = false], [resource $outputStream = null])

integer revisions ()

void rollback (integer $steps)

void save (string $filename, [boolean $updateOnly = false])

void setJavaScript (string $javascript)

Variables

array $pages = array() (line 124)

Pages collection

var: - array of Zend_Pdf_Page object
todo: implement it as a class, which supports ArrayAccess and Iterator interfaces, to provide incremental parsing and pages tree updating. That will give good performance and memory (PDF size) benefits.
access: public

Methods

static getMemoryManager (line 178)

Request used memory manager

access: public

static Zend_Memory_Manager getMemoryManager ()

static load (line 217)

Load PDF document from a file

access: public

static Zend_Pdf load ([string $source = null], [integer $revision = null])

string $source
integer $revision

static parse (line 205)

Create new PDF document from a $source string

access: public

static Zend_Pdf parse ([ &$source = null], [integer $revision = null], string $source)

string $source
integer $revision
&$source

static pdfDate (line 671)

Convert date to PDF format (it's close to ASN.1 (Abstract Syntax Notation One) defined in ISO/IEC 8824).

todo: Address the following E_STRICT issue: PHP Strict Standards: date(): It is not safe to rely on the system's timezone settings. Please use the date.timezone setting, the TZ environment variable or the date_default_timezone_set() function. In case you used any of those methods and you are still getting this warning, you most likely misspelled the timezone identifier.
todo: This really isn't the best location for this method. It should probably actually exist as Zend_Pdf_Element_Date or something like that.
access: public

static string pdfDate ([integer $timestamp = null])

integer $timestamp: (optional) If omitted, uses the current time.

static setMemoryManager (line 192)

Set user defined memory manager

access: public

static void setMemoryManager ( $memoryManager)

Zend_Memory_Manager $memoryManager

Constructor __construct (line 261)

Creates or loads PDF document.

If $source is null, then it creates a new document.

If $source is a string and $load is false, then it loads document from a binary string.

If $source is a string and $load is true, then it loads document from a file. $revision used to roll back document to specified version (0 - currtent version, 1 - previous version, 2 - ...)

throws: Zend_Pdf_Exception
access: public

Zend_Pdf __construct ([string $source = null], [integer $revision = null], [ $load = false])

string $source: - PDF file to load
integer $revision
$load

getJavaScript (line 494)

Return the document-level JavaScript or null if there is no JavaScript for this document

access: public

string getJavaScript ()

getNamedActions (line 507)

Return an associative array containing all the named actions in the PDF.

Named actions (it's always "GoTo" actions) can be used to reference from outside the PDF, ex: 'http://www.something.com/mydocument.pdf#MyAction'

access: public

array getNamedActions ()

newPage (line 458)

Create page object, attached to the PDF document.

Method signatures:

Create new page with a specified pagesize. If $factory is null then it will be created and page must be attached to the document to be included into output.

--------------------------------------------------------- new Zend_Pdf_Page(string $pagesize); ---------------------------------------------------------

2. Create new page with a specified pagesize (in default user space units). If $factory is null then it will be created and page must be attached to the document to be included into output. --------------------------------------------------------- new Zend_Pdf_Page(numeric $width, numeric $height); ---------------------------------------------------------

access: public

Zend_Pdf_Page newPage (mixed $param1, [mixed $param2 = null])

mixed $param1
mixed $param2

properties (line 482)

Return return the an associative array with PDF meta information, values may be string, boolean or float.

Returned array could be used directly to access, add, modify or remove document properties.

Standard document properties: Title (must be set for PDF/X documents), Author, Subject, Keywords (comma separated list), Creator (the name of the application, that created document, if it was converted from other format), Trapped (must be true, false or null, can not be null for PDF/X documents)

todo: implementation
access: public

array properties ()

render (line 521)

Render the completed PDF to a string.

If $newSegmentOnly is true, then only appended part of PDF is returned.

access: public

string render ([boolean $newSegmentOnly = false], [resource $outputStream = null])

boolean $newSegmentOnly
resource $outputStream

revisions (line 315)

Retrive number of revisions.

access: public

integer revisions ()

rollback (line 335)

Rollback document $steps number of revisions.

This method must be invoked before any changes, applied to the document. Otherwise behavior is undefined.

access: public

void rollback (integer $steps)

integer $steps

save (line 231)

Render PDF document and save it.

If $updateOnly is true, then it only appends new section to the end of file.

throws: Zend_Pdf_Exception
access: public

void save (string $filename, [boolean $updateOnly = false])

string $filename
boolean $updateOnly

setJavaScript (line 648)

Set the document-level JavaScript

access: public

void setJavaScript (string $javascript)

string $javascript

Class Constants

PDF_HEADER = "%PDF-1.4\n%\xE2\xE3\xCF\xD3\n" (line 111)

PDF file header.

PDF_VERSION = 1.4 (line 106)

Version number of generated PDF documents.