File indexing completed on 2025-01-19 05:21:21

 <?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-2015 Zend Technologies USA Inc. (http://www.zend.com)
  * @license    http://framework.zend.com/license/new-bsd     New BSD License
  * @version    $Id$
  */
 
 
 /** 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-2015 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();
     }
 }