--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/web/Zend/Pdf/Element/Reference.php Mon Dec 13 18:29:26 2010 +0100
@@ -0,0 +1,303 @@
+<?php
+/**
+ * Zend Framework
+ *
+ * LICENSE
+ *
+ * This source file is subject to the new BSD license that is bundled
+ * with this package in the file LICENSE.txt.
+ * It is also available through the world-wide-web at this URL:
+ * http://framework.zend.com/license/new-bsd
+ * If you did not receive a copy of the license and are unable to
+ * obtain it through the world-wide-web, please send an email
+ * to license@zend.com so we can send you a copy immediately.
+ *
+ * @category Zend
+ * @package Zend_Pdf
+ * @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license http://framework.zend.com/license/new-bsd New BSD License
+ * @version $Id: Reference.php 22797 2010-08-06 15:02:12Z alexander $
+ */
+
+
+/** Internally used classes */
+require_once 'Zend/Pdf/Element/Null.php';
+
+
+/** Zend_Pdf_Element */
+require_once 'Zend/Pdf/Element.php';
+
+/**
+ * PDF file 'reference' element implementation
+ *
+ * @category Zend
+ * @package Zend_Pdf
+ * @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license http://framework.zend.com/license/new-bsd New BSD License
+ */
+class Zend_Pdf_Element_Reference extends Zend_Pdf_Element
+{
+ /**
+ * Object value
+ * The reference to the object
+ *
+ * @var mixed
+ */
+ private $_ref;
+
+ /**
+ * Object number within PDF file
+ *
+ * @var integer
+ */
+ private $_objNum;
+
+ /**
+ * Generation number
+ *
+ * @var integer
+ */
+ private $_genNum;
+
+ /**
+ * Reference context
+ *
+ * @var Zend_Pdf_Element_Reference_Context
+ */
+ private $_context;
+
+
+ /**
+ * Reference to the factory.
+ *
+ * It's the same as referenced object factory, but we save it here to avoid
+ * unnecessary dereferencing, whech can produce cascade dereferencing and parsing.
+ * The same for duplication of getFactory() function. It can be processed by __call()
+ * method, but we catch it here.
+ *
+ * @var Zend_Pdf_ElementFactory
+ */
+ private $_factory;
+
+ /**
+ * Object constructor:
+ *
+ * @param integer $objNum
+ * @param integer $genNum
+ * @param Zend_Pdf_Element_Reference_Context $context
+ * @param Zend_Pdf_ElementFactory $factory
+ * @throws Zend_Pdf_Exception
+ */
+ public function __construct($objNum, $genNum = 0, Zend_Pdf_Element_Reference_Context $context, Zend_Pdf_ElementFactory $factory)
+ {
+ if ( !(is_integer($objNum) && $objNum > 0) ) {
+ require_once 'Zend/Pdf/Exception.php';
+ throw new Zend_Pdf_Exception('Object number must be positive integer');
+ }
+ if ( !(is_integer($genNum) && $genNum >= 0) ) {
+ require_once 'Zend/Pdf/Exception.php';
+ throw new Zend_Pdf_Exception('Generation number must be non-negative integer');
+ }
+
+ $this->_objNum = $objNum;
+ $this->_genNum = $genNum;
+ $this->_ref = null;
+ $this->_context = $context;
+ $this->_factory = $factory;
+ }
+
+ /**
+ * Check, that object is generated by specified factory
+ *
+ * @return Zend_Pdf_ElementFactory
+ */
+ public function getFactory()
+ {
+ return $this->_factory;
+ }
+
+
+ /**
+ * Return type of the element.
+ *
+ * @return integer
+ */
+ public function getType()
+ {
+ if ($this->_ref === null) {
+ $this->_dereference();
+ }
+
+ return $this->_ref->getType();
+ }
+
+
+ /**
+ * Return reference to the object
+ *
+ * @param Zend_Pdf_Factory $factory
+ * @return string
+ */
+ public function toString($factory = null)
+ {
+ if ($factory === null) {
+ $shift = 0;
+ } else {
+ $shift = $factory->getEnumerationShift($this->_factory);
+ }
+
+ return $this->_objNum + $shift . ' ' . $this->_genNum . ' R';
+ }
+
+
+ /**
+ * Dereference.
+ * Take inderect object, take $value member of this object (must be Zend_Pdf_Element),
+ * take reference to the $value member of this object and assign it to
+ * $value member of current PDF Reference object
+ * $obj can be null
+ *
+ * @throws Zend_Pdf_Exception
+ */
+ private function _dereference()
+ {
+ if (($obj = $this->_factory->fetchObject($this->_objNum . ' ' . $this->_genNum)) === null) {
+ $obj = $this->_context->getParser()->getObject(
+ $this->_context->getRefTable()->getOffset($this->_objNum . ' ' . $this->_genNum . ' R'),
+ $this->_context
+ );
+ }
+
+ if ($obj === null ) {
+ $this->_ref = new Zend_Pdf_Element_Null();
+ return;
+ }
+
+ if ($obj->toString() != $this->_objNum . ' ' . $this->_genNum . ' R') {
+ require_once 'Zend/Pdf/Exception.php';
+ throw new Zend_Pdf_Exception('Incorrect reference to the object');
+ }
+
+ $this->_ref = $obj;
+ }
+
+ /**
+ * Detach PDF object from the factory (if applicable), clone it and attach to new factory.
+ *
+ * @param Zend_Pdf_ElementFactory $factory The factory to attach
+ * @param array &$processed List of already processed indirect objects, used to avoid objects duplication
+ * @param integer $mode Cloning mode (defines filter for objects cloning)
+ * @returns Zend_Pdf_Element
+ */
+ public function makeClone(Zend_Pdf_ElementFactory $factory, array &$processed, $mode)
+ {
+ if ($this->_ref === null) {
+ $this->_dereference();
+ }
+
+ // This code duplicates code in Zend_Pdf_Element_Object class,
+ // but allows to avoid unnecessary method call in most cases
+ $id = spl_object_hash($this->_ref);
+ if (isset($processed[$id])) {
+ // Do nothing if object is already processed
+ // return it
+ return $processed[$id];
+ }
+
+ return $this->_ref->makeClone($factory, $processed, $mode);
+ }
+
+ /**
+ * Mark object as modified, to include it into new PDF file segment.
+ */
+ public function touch()
+ {
+ if ($this->_ref === null) {
+ $this->_dereference();
+ }
+
+ $this->_ref->touch();
+ }
+
+ /**
+ * Return object, which can be used to identify object and its references identity
+ *
+ * @return Zend_Pdf_Element_Object
+ */
+ public function getObject()
+ {
+ if ($this->_ref === null) {
+ $this->_dereference();
+ }
+
+ return $this->_ref;
+ }
+
+ /**
+ * Get handler
+ *
+ * @param string $property
+ * @return mixed
+ */
+ public function __get($property)
+ {
+ if ($this->_ref === null) {
+ $this->_dereference();
+ }
+
+ return $this->_ref->$property;
+ }
+
+ /**
+ * Set handler
+ *
+ * @param string $property
+ * @param mixed $value
+ */
+ public function __set($property, $value)
+ {
+ if ($this->_ref === null) {
+ $this->_dereference();
+ }
+
+ $this->_ref->$property = $value;
+ }
+
+ /**
+ * Call handler
+ *
+ * @param string $method
+ * @param array $args
+ * @return mixed
+ */
+ public function __call($method, $args)
+ {
+ if ($this->_ref === null) {
+ $this->_dereference();
+ }
+
+ return call_user_func_array(array($this->_ref, $method), $args);
+ }
+
+ /**
+ * Clean up resources
+ */
+ public function cleanUp()
+ {
+ $this->_ref = null;
+ }
+
+ /**
+ * Convert PDF element to PHP type.
+ *
+ * @return mixed
+ */
+ public function toPhp()
+ {
+ if ($this->_ref === null) {
+ $this->_dereference();
+ }
+
+ return $this->_ref->toPhp();
+ }
+}