Moving 2.0 development version to main trunk.
[fa-stable.git] / reporting / includes / class.pdf.inc
index a20148b0a6fbc8fd5b9a6c4ad5fa88c785aaa264..7c182017526dc8cd406e95c39f3946f55e719ed5 100644 (file)
 <?php
-/* $Revision$ */
-/**
-* Cpdf
-*
-* http://www.ros.co.nz/pdf
-*
-* A PHP class to provide the basic functionality to create a pdf document without
-* any requirement for additional modules.
-*
-* Note that they companion class CezPdf can be used to extend this class and dramatically
-* simplify the creation of documents.
-*
-* IMPORTANT NOTE
-* there is no warranty, implied or otherwise with this software.
-* 
-* LICENCE
-* This code has been placed in the Public Domain for all to enjoy.
-*
-* @author              Wayne Munro <pdf@ros.co.nz>
-* @version     009
-* @package     Cpdf
-*/
-class Cpdf {
-
-/**
-* the current number of pdf objects in the document
-*/
-var $numObj=0;
-/**
-* this array contains all of the pdf objects, ready for final assembly
-*/
-var $objects = array();
-/**
-* the objectId (number within the objects array) of the document catalog
-*/
-var $catalogId;
-/**
-* array carrying information about the fonts that the system currently knows about
-* used to ensure that a font is not loaded twice, among other things
-*/
-var $fonts=array(); 
-/**
-* a record of the current font
-*/
-var $currentFont='';
-/**
-* the current base font
-*/
-var $currentBaseFont='';
-/**
-* the number of the current font within the font array
-*/
-var $currentFontNum=0;
-/**
-* 
-*/
-var $currentNode;
-/**
-* object number of the current page
-*/
-var $currentPage;
-/**
-* object number of the currently active contents block
-*/
-var $currentContents;
-/**
-* number of fonts within the system
-*/
-var $numFonts=0;
-/**
-* current colour for fill operations, defaults to inactive value, all three components should be between 0 and 1 inclusive when active
-*/
-var $currentColour=array('r'=>-1,'g'=>-1,'b'=>-1);
-/**
-* current colour for stroke operations (lines etc.)
-*/
-var $currentStrokeColour=array('r'=>-1,'g'=>-1,'b'=>-1);
-/**
-* current style that lines are drawn in
-*/
-var $currentLineStyle='';
-/**
-* an array which is used to save the state of the document, mainly the colours and styles
-* it is used to temporarily change to another state, the change back to what it was before
-*/
-var $stateStack = array();
-/**
-* number of elements within the state stack
-*/
-var $nStateStack = 0;
-/**
-* number of page objects within the document
-*/
-var $numPages=0;
-/**
-* object Id storage stack
-*/
-var $stack=array();
-/**
-* number of elements within the object Id storage stack
-*/
-var $nStack=0;
-/**
-* an array which contains information about the objects which are not firmly attached to pages
-* these have been added with the addObject function
-*/
-var $looseObjects=array();
-/**
-* array contains infomation about how the loose objects are to be added to the document
-*/
-var $addLooseObjects=array();
-/**
-* the objectId of the information object for the document
-* this contains authorship, title etc.
-*/
-var $infoObject=0;
-/**
-* number of images being tracked within the document
-*/
-var $numImages=0;
-/**
-* an array containing options about the document
-* it defaults to turning on the compression of the objects
-*/
-var $options=array('compression'=>1);
-/**
-* the objectId of the first page of the document
-*/
-var $firstPageId;
-/**
-* used to track the last used value of the inter-word spacing, this is so that it is known
-* when the spacing is changed.
-*/
-var $wordSpaceAdjust=0;
-/**
-* the object Id of the procset object
-*/
-var $procsetObjectId;
-/**
-* store the information about the relationship between font families
-* this used so that the code knows which font is the bold version of another font, etc.
-* the value of this array is initialised in the constuctor function.
-*/
-var $fontFamilies = array();
-/**
-* track if the current font is bolded or italicised
-*/
-var $currentTextState = ''; 
-/**
-* messages are stored here during processing, these can be selected afterwards to give some useful debug information
-*/
-var $messages='';
-/**
-* the ancryption array for the document encryption is stored here
-*/
-var $arc4='';
-/**
-* the object Id of the encryption information
-*/
-var $arc4_objnum=0;
-/**
-* the file identifier, used to uniquely identify a pdf document
-*/
-var $fileIdentifier='';
-/**
-* a flag to say if a document is to be encrypted or not
-*/
-var $encrypted=0;
-/**
-* the ancryption key for the encryption of all the document content (structure is not encrypted)
-*/
-var $encryptionKey='';
-/**
-* array which forms a stack to keep track of nested callback functions
-*/
-var $callback = array();
-/**
-* the number of callback functions in the callback array
-*/
-var $nCallback = 0;
-/**
-* store label->id pairs for named destinations, these will be used to replace internal links
-* done this way so that destinations can be defined after the location that links to them
-*/
-var $destinations = array();
-/**
-* store the stack for the transaction commands, each item in here is a record of the values of all the 
-* variables within the class, so that the user can rollback at will (from each 'start' command)
-* note that this includes the objects array, so these can be large.
-*/
-var $checkpoint = '';
-/**
-* class constructor
-* this will start a new document
-* @var array array of 4 numbers, defining the bottom left and upper right corner of the page. first two are normally zero.
-*/
-function Cpdf ($pageSize=array(0,0,612,792)){
-  $this->newDocument($pageSize);
-  
-  // also initialize the font families that are known about already
-  $this->setFontFamily('init');
-//  $this->fileIdentifier = md5('xxxxxxxx'.time());
-
-}
-
-/**
-* Document object methods (internal use only)
-*
-* There is about one object method for each type of object in the pdf document
-* Each function has the same call list ($id,$action,$options).
-* $id = the object id of the object, or what it is to be if it is being created
-* $action = a string specifying the action to be performed, though ALL must support:
-*           'new' - create the object with the id $id
-*           'out' - produce the output for the pdf object
-* $options = optional, a string or array containing the various parameters for the object
-*
-* These, in conjunction with the output function are the ONLY way for output to be produced 
-* within the pdf 'file'.
-*/
-
-/**
-*destination object, used to specify the location for the user to jump to, presently on opening
-*/
-function o_destination($id,$action,$options=''){
-  if ($action!='new'){
-    $o =& $this->objects[$id];
-  }
-  switch($action){
-    case 'new':
-      $this->objects[$id]=array('t'=>'destination','info'=>array());
-      $tmp = '';
-      switch ($options['type']){
-        case 'XYZ':
-        case 'FitR':
-          $tmp =  ' '.$options['p3'].$tmp;
-        case 'FitH':
-        case 'FitV':
-        case 'FitBH':
-        case 'FitBV':
-          $tmp =  ' '.$options['p1'].' '.$options['p2'].$tmp;
-        case 'Fit':
-        case 'FitB':
-          $tmp =  $options['type'].$tmp;
-          $this->objects[$id]['info']['string']=$tmp;
-          $this->objects[$id]['info']['page']=$options['page'];
-      }
-      break;
-    case 'out':
-      $tmp = $o['info'];
-      $res="\n".$id." 0 obj\n".'['.$tmp['page'].' 0 R /'.$tmp['string']."]\nendobj\n";
-      return $res;
-      break;
-  }
-}
-
-/**
-* set the viewer preferences
-*/
-function o_viewerPreferences($id,$action,$options=''){
-  if ($action!='new'){
-    $o =& $this->objects[$id];
-  }
-  switch ($action){
-    case 'new':
-      $this->objects[$id]=array('t'=>'viewerPreferences','info'=>array());
-      break;
-    case 'add':
-      foreach($options as $k=>$v){
-        switch ($k){
-          case 'HideToolbar':
-          case 'HideMenubar':
-          case 'HideWindowUI':
-          case 'FitWindow':
-          case 'CenterWindow':
-          case 'NonFullScreenPageMode':
-          case 'Direction':
-            $o['info'][$k]=$v;
-          break;
-        }
-      }
-      break;
-    case 'out':
-
-      $res="\n".$id." 0 obj\n".'<< ';
-      foreach($o['info'] as $k=>$v){
-        $res.="\n/".$k.' '.$v;
-      }
-      $res.="\n>>\n";
-      return $res;
-      break;
-  }
-}
-
-/**
-* define the document catalog, the overall controller for the document
-*/
-function o_catalog($id,$action,$options=''){
-  if ($action!='new'){
-    $o =& $this->objects[$id];
-  }
-  switch ($action){
-    case 'new':
-      $this->objects[$id]=array('t'=>'catalog','info'=>array());
-      $this->catalogId=$id;
-      break;
-    case 'outlines':
-    case 'pages':
-    case 'openHere':
-      $o['info'][$action]=$options;
-      break;
-    case 'viewerPreferences':
-      if (!isset($o['info']['viewerPreferences'])){
-        $this->numObj++;
-        $this->o_viewerPreferences($this->numObj,'new');
-        $o['info']['viewerPreferences']=$this->numObj;
-      }
-      $vp = $o['info']['viewerPreferences'];
-      $this->o_viewerPreferences($vp,'add',$options);
-      break;
-    case 'out':
-      $res="\n".$id." 0 obj\n".'<< /Type /Catalog';
-      foreach($o['info'] as $k=>$v){
-        switch($k){
-          case 'outlines':
-            $res.="\n".'/Outlines '.$v.' 0 R';
-            break;
-          case 'pages':
-            $res.="\n".'/Pages '.$v.' 0 R';
-            break;
-          case 'viewerPreferences':
-            $res.="\n".'/ViewerPreferences '.$o['info']['viewerPreferences'].' 0 R';
-            break;
-          case 'openHere':
-            $res.="\n".'/OpenAction '.$o['info']['openHere'].' 0 R';
-            break;
-        }
-      }
-      $res.=" >>\nendobj";
-      return $res;
-      break;
-  }
-}
-
-/**
-* object which is a parent to the pages in the document
-*/
-function o_pages($id,$action,$options=''){
-  if ($action!='new'){
-    $o =& $this->objects[$id];
-  }
-  switch ($action){
-    case 'new':
-      $this->objects[$id]=array('t'=>'pages','info'=>array());
-      $this->o_catalog($this->catalogId,'pages',$id);
-      break;
-    case 'page':
-      if (!is_array($options)){
-        // then it will just be the id of the new page
-        $o['info']['pages'][]=$options;
-      } else {
-        // then it should be an array having 'id','rid','pos', where rid=the page to which this one will be placed relative
-        // and pos is either 'before' or 'after', saying where this page will fit.
-        if (isset($options['id']) && isset($options['rid']) && isset($options['pos'])){
-          $i = array_search($options['rid'],$o['info']['pages']);
-          if (isset($o['info']['pages'][$i]) && $o['info']['pages'][$i]==$options['rid']){
-            // then there is a match
-            // make a space
-            switch ($options['pos']){
-              case 'before':
-                $k = $i;
-                break;
-              case 'after':
-                $k=$i+1;
-                break;
-              default:
-                $k=-1;
-                break;
-            }
-            if ($k>=0){
-              for ($j=count($o['info']['pages'])-1;$j>=$k;$j--){
-                $o['info']['pages'][$j+1]=$o['info']['pages'][$j];
-              }
-              $o['info']['pages'][$k]=$options['id'];
-            }
-          }
-        } 
-      }
-      break;
-    case 'procset':
-      $o['info']['procset']=$options;
-      break;
-    case 'mediaBox':
-      $o['info']['mediaBox']=$options; // which should be an array of 4 numbers
-      break;
-    case 'font':
-      $o['info']['fonts'][]=array('objNum'=>$options['objNum'],'fontNum'=>$options['fontNum']);
-      break;
-    case 'xObject':
-      $o['info']['xObjects'][]=array('objNum'=>$options['objNum'],'label'=>$options['label']);
-      break;
-    case 'out':
-      if (count($o['info']['pages'])){
-        $res="\n".$id." 0 obj\n<< /Type /Pages\n/Kids [";
-        foreach($o['info']['pages'] as $k=>$v){
-          $res.=$v." 0 R\n";
-        }
-        $res.="]\n/Count ".count($this->objects[$id]['info']['pages']);
-        if ((isset($o['info']['fonts']) && count($o['info']['fonts'])) || isset($o['info']['procset'])){
-          $res.="\n/Resources <<";
-          if (isset($o['info']['procset'])){
-            $res.="\n/ProcSet ".$o['info']['procset']." 0 R";
-          }
-          if (isset($o['info']['fonts']) && count($o['info']['fonts'])){
-            $res.="\n/Font << ";
-            foreach($o['info']['fonts'] as $finfo){
-              $res.="\n/F".$finfo['fontNum']." ".$finfo['objNum']." 0 R";
-            }
-            $res.=" >>";
-          }
-          if (isset($o['info']['xObjects']) && count($o['info']['xObjects'])){
-            $res.="\n/XObject << ";
-            foreach($o['info']['xObjects'] as $finfo){
-              $res.="\n/".$finfo['label']." ".$finfo['objNum']." 0 R";
-            }
-            $res.=" >>";
-          }
-          $res.="\n>>";
-          if (isset($o['info']['mediaBox'])){
-            $tmp=$o['info']['mediaBox'];
-            $res.="\n/MediaBox [".sprintf('%.3f',$tmp[0]).' '.sprintf('%.3f',$tmp[1]).' '.sprintf('%.3f',$tmp[2]).' '.sprintf('%.3f',$tmp[3]).']';
-          }
-        }
-        $res.="\n >>\nendobj";
-      } else {
-        $res="\n".$id." 0 obj\n<< /Type /Pages\n/Count 0\n>>\nendobj";
-      }
-      return $res;
-    break;
-  }
-}
-
-/**
-* define the outlines in the doc, empty for now
-*/
-function o_outlines($id,$action,$options=''){
-  if ($action!='new'){
-    $o =& $this->objects[$id];
-  }
-  switch ($action){
-    case 'new':
-      $this->objects[$id]=array('t'=>'outlines','info'=>array('outlines'=>array()));
-      $this->o_catalog($this->catalogId,'outlines',$id);
-      break;
-    case 'outline':
-      $o['info']['outlines'][]=$options;
-      break;
-    case 'out':
-      if (count($o['info']['outlines'])){
-        $res="\n".$id." 0 obj\n<< /Type /Outlines /Kids [";
-        foreach($o['info']['outlines'] as $k=>$v){
-          $res.=$v." 0 R ";
-        }
-        $res.="] /Count ".count($o['info']['outlines'])." >>\nendobj";
-      } else {
-        $res="\n".$id." 0 obj\n<< /Type /Outlines /Count 0 >>\nendobj";
-      }
-      return $res;
-      break;
-  }
-}
-
-/**
-* an object to hold the font description
-*/
-function o_font($id,$action,$options=''){
-  if ($action!='new'){
-    $o =& $this->objects[$id];
-  }
-  switch ($action){
-    case 'new':
-      $this->objects[$id]=array('t'=>'font','info'=>array('name'=>$options['name'],'SubType'=>'Type1'));
-      $fontNum=$this->numFonts;
-      $this->objects[$id]['info']['fontNum']=$fontNum;
-      // deal with the encoding and the differences
-      if (isset($options['differences'])){
-        // then we'll need an encoding dictionary
-        $this->numObj++;
-        $this->o_fontEncoding($this->numObj,'new',$options);
-        $this->objects[$id]['info']['encodingDictionary']=$this->numObj;
-      } else if (isset($options['encoding'])){
-        // we can specify encoding here
-        switch($options['encoding']){
-          case 'WinAnsiEncoding':
-          case 'MacRomanEncoding':
-          case 'MacExpertEncoding':
-            $this->objects[$id]['info']['encoding']=$options['encoding'];
-            break;
-          case 'none':
-            break;
-          default:
-            $this->objects[$id]['info']['encoding']='WinAnsiEncoding';
-            break;
-        }
-      } else {
-        $this->objects[$id]['info']['encoding']='WinAnsiEncoding';
-      }
-      // also tell the pages node about the new font
-      $this->o_pages($this->currentNode,'font',array('fontNum'=>$fontNum,'objNum'=>$id));
-      break;
-    case 'add':
-      foreach ($options as $k=>$v){
-        switch ($k){
-          case 'BaseFont':
-            $o['info']['name'] = $v;
-            break;
-          case 'FirstChar':
-          case 'LastChar':
-          case 'Widths':
-          case 'FontDescriptor':
-          case 'SubType':
-          $this->addMessage('o_font '.$k." : ".$v);
-            $o['info'][$k] = $v;
-            break;
-        }
-     }
-      break;
-    case 'out':
-      $res="\n".$id." 0 obj\n<< /Type /Font\n/Subtype /".$o['info']['SubType']."\n";
-      $res.="/Name /F".$o['info']['fontNum']."\n";
-      $res.="/BaseFont /".$o['info']['name']."\n";
-      if (isset($o['info']['encodingDictionary'])){
-        // then place a reference to the dictionary
-        $res.="/Encoding ".$o['info']['encodingDictionary']." 0 R\n";
-      } else if (isset($o['info']['encoding'])){
-        // use the specified encoding
-        $res.="/Encoding /".$o['info']['encoding']."\n";
-      }
-      if (isset($o['info']['FirstChar'])){
-        $res.="/FirstChar ".$o['info']['FirstChar']."\n";
-      }
-      if (isset($o['info']['LastChar'])){
-        $res.="/LastChar ".$o['info']['LastChar']."\n";
-      }
-      if (isset($o['info']['Widths'])){
-        $res.="/Widths ".$o['info']['Widths']." 0 R\n";
-      }
-      if (isset($o['info']['FontDescriptor'])){
-        $res.="/FontDescriptor ".$o['info']['FontDescriptor']." 0 R\n";
-      }
-      $res.=">>\nendobj";
-      return $res;
-      break;
-  }
-}
-
-/**
-* a font descriptor, needed for including additional fonts
-*/
-function o_fontDescriptor($id,$action,$options=''){
-  if ($action!='new'){
-    $o =& $this->objects[$id];
-  }
-  switch ($action){
-    case 'new':
-      $this->objects[$id]=array('t'=>'fontDescriptor','info'=>$options);
-      break;
-    case 'out':
-      $res="\n".$id." 0 obj\n<< /Type /FontDescriptor\n";
-      foreach ($o['info'] as $label => $value){
-        switch ($label){
-          case 'Ascent':
-          case 'CapHeight':
-          case 'Descent':
-          case 'Flags':
-          case 'ItalicAngle':
-          case 'StemV':
-          case 'AvgWidth':
-          case 'Leading':
-          case 'MaxWidth':
-          case 'MissingWidth':
-          case 'StemH':
-          case 'XHeight':
-          case 'CharSet':
-            if (strlen($value)){
-              $res.='/'.$label.' '.$value."\n";
-            }
-            break;
-          case 'FontFile':
-          case 'FontFile2':
-          case 'FontFile3':
-            $res.='/'.$label.' '.$value." 0 R\n";
-            break;
-          case 'FontBBox':
-            $res.='/'.$label.' ['.$value[0].' '.$value[1].' '.$value[2].' '.$value[3]."]\n";
-            break;
-          case 'FontName':
-            $res.='/'.$label.' /'.$value."\n";
-            break;
-        }
-      }
-      $res.=">>\nendobj";
-      return $res;
-      break;
-  }
-}
-
-/**
-* the font encoding
-*/
-function o_fontEncoding($id,$action,$options=''){
-  if ($action!='new'){
-    $o =& $this->objects[$id];
-  }
-  switch ($action){
-    case 'new':
-      // the options array should contain 'differences' and maybe 'encoding'
-      $this->objects[$id]=array('t'=>'fontEncoding','info'=>$options);
-      break;
-    case 'out':
-      $res="\n".$id." 0 obj\n<< /Type /Encoding\n";
-      if (!isset($o['info']['encoding'])){
-        $o['info']['encoding']='WinAnsiEncoding';
-      }
-      if ($o['info']['encoding']!='none'){
-        $res.="/BaseEncoding /".$o['info']['encoding']."\n";
-      }
-      $res.="/Differences \n[";
-      $onum=-100;
-      foreach($o['info']['differences'] as $num=>$label){
-        if ($num!=$onum+1){
-          // we cannot make use of consecutive numbering
-          $res.= "\n".$num." /".$label;
-        } else {
-          $res.= " /".$label;
-        }
-        $onum=$num;
-      }
-      $res.="\n]\n>>\nendobj";
-      return $res;
-      break;
-  }
-}
-
-/**
-* the document procset, solves some problems with printing to old PS printers
-*/
-function o_procset($id,$action,$options=''){
-  if ($action!='new'){
-    $o =& $this->objects[$id];
-  }
-  switch ($action){
-    case 'new':
-      $this->objects[$id]=array('t'=>'procset','info'=>array('PDF'=>1,'Text'=>1));
-      $this->o_pages($this->currentNode,'procset',$id);
-      $this->procsetObjectId=$id;
-      break;
-    case 'add':
-      // this is to add new items to the procset list, despite the fact that this is considered
-      // obselete, the items are required for printing to some postscript printers
-      switch ($options) {
-        case 'ImageB':
-        case 'ImageC':
-        case 'ImageI':
-          $o['info'][$options]=1;
-          break;
-      }
-      break;
-    case 'out':
-      $res="\n".$id." 0 obj\n[";
-      foreach ($o['info'] as $label=>$val){
-        $res.='/'.$label.' ';
-      }
-      $res.="]\nendobj";
-      return $res;
-      break;
-  }
-}
-
-/**
-* define the document information
-*/
-function o_info($id,$action,$options=''){
-  if ($action!='new'){
-    $o =& $this->objects[$id];
-  }
-  switch ($action){
-    case 'new':
-      $this->infoObject=$id;
-      $date='D:'.date('Ymd');
-      $this->objects[$id]=array('t'=>'info','info'=>array('Creator'=>'R and OS php pdf writer, http://www.ros.co.nz','CreationDate'=>$date));
-      break;
-    case 'Title':
-    case 'Author':
-    case 'Subject':
-    case 'Keywords':
-    case 'Creator':
-    case 'Producer':
-    case 'CreationDate':
-    case 'ModDate':
-    case 'Trapped':
-      $o['info'][$action]=$options;
-      break;
-    case 'out':
-      if ($this->encrypted){
-        $this->encryptInit($id);
-      }
-      $res="\n".$id." 0 obj\n<<\n";
-      foreach ($o['info']  as $k=>$v){
-        $res.='/'.$k.' (';
-        if ($this->encrypted){
-          $res.=$this->filterText($this->ARC4($v));
-        } else {
-          $res.=$this->filterText($v);
-        }
-        $res.=")\n";
-      }
-      $res.=">>\nendobj";
-      return $res;
-      break;
-  }
-}
-
-/**
-* an action object, used to link to URLS initially
-*/
-function o_action($id,$action,$options=''){
-  if ($action!='new'){
-    $o =& $this->objects[$id];
-  }
-  switch ($action){
-    case 'new':
-      if (is_array($options)){
-        $this->objects[$id]=array('t'=>'action','info'=>$options,'type'=>$options['type']);
-      } else {
-        // then assume a URI action
-        $this->objects[$id]=array('t'=>'action','info'=>$options,'type'=>'URI');
-      }
-      break;
-    case 'out':
-      if ($this->encrypted){
-        $this->encryptInit($id);
-      }
-      $res="\n".$id." 0 obj\n<< /Type /Action";
-      switch($o['type']){
-        case 'ilink':
-          // there will be an 'label' setting, this is the name of the destination
-          $res.="\n/S /GoTo\n/D ".$this->destinations[(string)$o['info']['label']]." 0 R";
-          break;
-        case 'URI':
-          $res.="\n/S /URI\n/URI (";
-          if ($this->encrypted){
-            $res.=$this->filterText($this->ARC4($o['info']));
-          } else {
-            $res.=$this->filterText($o['info']);
-          }
-          $res.=")";
-          break;
-      }
-      $res.="\n>>\nendobj";
-      return $res;
-      break;
-  }
-}
-
-/**
-* an annotation object, this will add an annotation to the current page.
-* initially will support just link annotations 
-*/
-function o_annotation($id,$action,$options=''){
-  if ($action!='new'){
-    $o =& $this->objects[$id];
-  }
-  switch ($action){
-    case 'new':
-      // add the annotation to the current page
-      $pageId = $this->currentPage;
-      $this->o_page($pageId,'annot',$id);
-      // and add the action object which is going to be required
-      switch($options['type']){
-        case 'link':
-          $this->objects[$id]=array('t'=>'annotation','info'=>$options);
-          $this->numObj++;
-          $this->o_action($this->numObj,'new',$options['url']);
-          $this->objects[$id]['info']['actionId']=$this->numObj;
-          break;
-        case 'ilink':
-          // this is to a named internal link
-          $label = $options['label'];
-          $this->objects[$id]=array('t'=>'annotation','info'=>$options);
-          $this->numObj++;
-          $this->o_action($this->numObj,'new',array('type'=>'ilink','label'=>$label));
-          $this->objects[$id]['info']['actionId']=$this->numObj;
-          break;
-      }
-      break;
-    case 'out':
-      $res="\n".$id." 0 obj\n<< /Type /Annot";
-      switch($o['info']['type']){
-        case 'link':
-        case 'ilink':
-          $res.= "\n/Subtype /Link";
-          break;
-      }
-      $res.="\n/A ".$o['info']['actionId']." 0 R";
-      $res.="\n/Border [0 0 0]";
-      $res.="\n/H /I";
-      $res.="\n/Rect [ ";
-      foreach($o['info']['rect'] as $v){
-        $res.= sprintf("%.4f ",$v);
-      }
-      $res.="]";
-      $res.="\n>>\nendobj";
-      return $res;
-      break;
-  }
-}
-
-/**
-* a page object, it also creates a contents object to hold its contents
-*/
-function o_page($id,$action,$options=''){
-  if ($action!='new'){
-    $o =& $this->objects[$id];
-  }
-  switch ($action){
-    case 'new':
-      $this->numPages++;
-      $this->objects[$id]=array('t'=>'page','info'=>array('parent'=>$this->currentNode,'pageNum'=>$this->numPages));
-      if (is_array($options)){
-        // then this must be a page insertion, array shoudl contain 'rid','pos'=[before|after]
-        $options['id']=$id;
-        $this->o_pages($this->currentNode,'page',$options);
-      } else {
-        $this->o_pages($this->currentNode,'page',$id);
-      }
-      $this->currentPage=$id;
-      //make a contents object to go with this page
-      $this->numObj++;
-      $this->o_contents($this->numObj,'new',$id);
-      $this->currentContents=$this->numObj;
-      $this->objects[$id]['info']['contents']=array();
-      $this->objects[$id]['info']['contents'][]=$this->numObj;
-      $match = ($this->numPages%2 ? 'odd' : 'even');
-      foreach($this->addLooseObjects as $oId=>$target){
-        if ($target=='all' || $match==$target){
-          $this->objects[$id]['info']['contents'][]=$oId;
-        }
-      }
-      break;
-    case 'content':
-      $o['info']['contents'][]=$options;
-      break;
-    case 'annot':
-      // add an annotation to this page
-      if (!isset($o['info']['annot'])){
-        $o['info']['annot']=array();
-      }
-      // $options should contain the id of the annotation dictionary
-      $o['info']['annot'][]=$options;
-      break;
-    case 'out':
-      $res="\n".$id." 0 obj\n<< /Type /Page";
-      $res.="\n/Parent ".$o['info']['parent']." 0 R";
-      if (isset($o['info']['annot'])){
-        $res.="\n/Annots [";
-        foreach($o['info']['annot'] as $aId){
-          $res.=" ".$aId." 0 R";
-        }
-        $res.=" ]";
-      }
-      $count = count($o['info']['contents']);
-      if ($count==1){
-        $res.="\n/Contents ".$o['info']['contents'][0]." 0 R";
-      } else if ($count>1){
-        $res.="\n/Contents [\n";
-        foreach ($o['info']['contents'] as $cId){
-          $res.=$cId." 0 R\n";
-        }
-        $res.="]";
-      }
-      $res.="\n>>\nendobj";
-      return $res;
-      break;
-  }
-}
-
-/**
-* the contents objects hold all of the content which appears on pages
-*/
-function o_contents($id,$action,$options=''){
-  if ($action!='new'){
-    $o =& $this->objects[$id];
-  }
-  switch ($action){
-    case 'new':
-      $this->objects[$id]=array('t'=>'contents','c'=>'','info'=>array());
-      if (strlen($options) && intval($options)){
-        // then this contents is the primary for a page
-        $this->objects[$id]['onPage']=$options;
-      } else if ($options=='raw'){
-        // then this page contains some other type of system object
-        $this->objects[$id]['raw']=1;
-      }
-      break;
-    case 'add':
-      // add more options to the decleration
-      foreach ($options as $k=>$v){
-        $o['info'][$k]=$v;
-      }
-    case 'out':
-      $tmp=$o['c'];
-      $res= "\n".$id." 0 obj\n";
-      if (isset($this->objects[$id]['raw'])){
-        $res.=$tmp;
-      } else {
-        $res.= "<<";
-        if (function_exists('gzcompress') && $this->options['compression']){
-          // then implement ZLIB based compression on this content stream
-          $res.=" /Filter /FlateDecode";
-          $tmp = gzcompress($tmp);
-        }
-        if ($this->encrypted){
-          $this->encryptInit($id);
-          $tmp = $this->ARC4($tmp);
-        }
-        foreach($o['info'] as $k=>$v){
-          $res .= "\n/".$k.' '.$v;
-        }
-        $res.="\n/Length ".strlen($tmp)." >>\nstream\n".$tmp."\nendstream";
-      }
-      $res.="\nendobj\n";
-      return $res;
-      break;
-  }
-}
-
-/**
-* an image object, will be an XObject in the document, includes description and data
-*/
-function o_image($id,$action,$options=''){
-  if ($action!='new'){
-    $o =& $this->objects[$id];
-  }
-  switch($action){
-    case 'new':
-      // make the new object
-      $this->objects[$id]=array('t'=>'image','data'=>$options['data'],'info'=>array());
-      $this->objects[$id]['info']['Type']='/XObject';
-      $this->objects[$id]['info']['Subtype']='/Image';
-      $this->objects[$id]['info']['Width']=$options['iw'];
-      $this->objects[$id]['info']['Height']=$options['ih'];
-      if (!isset($options['type']) || $options['type']=='jpg'){
-        if (!isset($options['channels'])){
-          $options['channels']=3;
-        }
-        switch($options['channels']){
-          case 1:
-            $this->objects[$id]['info']['ColorSpace']='/DeviceGray';
-            break;
-          default:
-            $this->objects[$id]['info']['ColorSpace']='/DeviceRGB';
-            break;
-        }
-        $this->objects[$id]['info']['Filter']='/DCTDecode';
-        $this->objects[$id]['info']['BitsPerComponent']=8;
-      } else if ($options['type']=='png'){
-        $this->objects[$id]['info']['Filter']='/FlateDecode';
-        $this->objects[$id]['info']['DecodeParms']='<< /Predictor 15 /Colors '.$options['ncolor'].' /Columns '.$options['iw'].' /BitsPerComponent '.$options['bitsPerComponent'].'>>';
-        if (strlen($options['pdata'])){
-          $tmp = ' [ /Indexed /DeviceRGB '.(strlen($options['pdata'])/3-1).' ';
-          $this->numObj++;
-          $this->o_contents($this->numObj,'new');
-          $this->objects[$this->numObj]['c']=$options['pdata'];
-          $tmp.=$this->numObj.' 0 R';
-          $tmp .=' ]';
-          $this->objects[$id]['info']['ColorSpace'] = $tmp;
-          if (isset($options['transparency'])){
-            switch($options['transparency']['type']){
-              case 'indexed':
-                $tmp=' [ '.$options['transparency']['data'].' '.$options['transparency']['data'].'] ';
-                $this->objects[$id]['info']['Mask'] = $tmp;
-                break;
-            }
-          }
-        } else {
-          $this->objects[$id]['info']['ColorSpace']='/'.$options['color'];
-        }
-        $this->objects[$id]['info']['BitsPerComponent']=$options['bitsPerComponent'];
-      }
-      // assign it a place in the named resource dictionary as an external object, according to
-      // the label passed in with it.
-      $this->o_pages($this->currentNode,'xObject',array('label'=>$options['label'],'objNum'=>$id));
-      // also make sure that we have the right procset object for it.
-      $this->o_procset($this->procsetObjectId,'add','ImageC');
-      break;
-    case 'out':
-      $tmp=$o['data'];
-      $res= "\n".$id." 0 obj\n<<";
-      foreach($o['info'] as $k=>$v){
-        $res.="\n/".$k.' '.$v;
-      }
-      if ($this->encrypted){
-        $this->encryptInit($id);
-        $tmp = $this->ARC4($tmp);
-      }
-      $res.="\n/Length ".strlen($tmp)." >>\nstream\n".$tmp."\nendstream\nendobj\n";
-      return $res;
-      break;
-  }
-}
-
-/**
-* encryption object.
-*/
-function o_encryption($id,$action,$options=''){
-  if ($action!='new'){
-    $o =& $this->objects[$id];
-  }
-  switch($action){
-    case 'new':
-      // make the new object
-      $this->objects[$id]=array('t'=>'encryption','info'=>$options);
-      $this->arc4_objnum=$id;
-      // figure out the additional paramaters required
-      $pad = chr(0x28).chr(0xBF).chr(0x4E).chr(0x5E).chr(0x4E).chr(0x75).chr(0x8A).chr(0x41).chr(0x64).chr(0x00).chr(0x4E).chr(0x56).chr(0xFF).chr(0xFA).chr(0x01).chr(0x08).chr(0x2E).chr(0x2E).chr(0x00).chr(0xB6).chr(0xD0).chr(0x68).chr(0x3E).chr(0x80).chr(0x2F).chr(0x0C).chr(0xA9).chr(0xFE).chr(0x64).chr(0x53).chr(0x69).chr(0x7A);
-      $len = strlen($options['owner']);
-      if ($len>32){
-        $owner = substr($options['owner'],0,32);
-      } else if ($len<32){
-        $owner = $options['owner'].substr($pad,0,32-$len);
-      } else {
-        $owner = $options['owner'];
-      }
-      $len = strlen($options['user']);
-      if ($len>32){
-        $user = substr($options['user'],0,32);
-      } else if ($len<32){
-        $user = $options['user'].substr($pad,0,32-$len);
-      } else {
-        $user = $options['user'];
-      }
-      $tmp = $this->md5_16($owner);
-      $okey = substr($tmp,0,5);
-      $this->ARC4_init($okey);
-      $ovalue=$this->ARC4($user);
-      $this->objects[$id]['info']['O']=$ovalue;
-      // now make the u value, phew.
-      $tmp = $this->md5_16($user.$ovalue.chr($options['p']).chr(255).chr(255).chr(255).$this->fileIdentifier);
-      $ukey = substr($tmp,0,5);
-
-      $this->ARC4_init($ukey);
-      $this->encryptionKey = $ukey;
-      $this->encrypted=1;
-      $uvalue=$this->ARC4($pad);
-
-      $this->objects[$id]['info']['U']=$uvalue;
-      $this->encryptionKey=$ukey;
-     
-      // initialize the arc4 array
-      break;
-    case 'out':
-      $res= "\n".$id." 0 obj\n<<";
-      $res.="\n/Filter /Standard";
-      $res.="\n/V 1";
-      $res.="\n/R 2";
-      $res.="\n/O (".$this->filterText($o['info']['O']).')';
-      $res.="\n/U (".$this->filterText($o['info']['U']).')';
-      // and the p-value needs to be converted to account for the twos-complement approach
-      $o['info']['p'] = (($o['info']['p']^255)+1)*-1;
-      $res.="\n/P ".($o['info']['p']);
-      $res.="\n>>\nendobj\n";
-      
-      return $res;
-      break;
-  }
-}
-      
-/**
-* ARC4 functions
-* A series of function to implement ARC4 encoding in PHP
-*/
-
-/**
-* calculate the 16 byte version of the 128 bit md5 digest of the string
-*/
-function md5_16($string){
-  $tmp = md5($string);
-  $out='';
-  for ($i=0;$i<=30;$i=$i+2){
-    $out.=chr(hexdec(substr($tmp,$i,2)));
-  }
-  return $out;
-}
-
-/**
-* initialize the encryption for processing a particular object 
-*/
-function encryptInit($id){
-  $tmp = $this->encryptionKey;
-  $hex = dechex($id);
-  if (strlen($hex)<6){
-    $hex = substr('000000',0,6-strlen($hex)).$hex;
-  }
-  $tmp.= chr(hexdec(substr($hex,4,2))).chr(hexdec(substr($hex,2,2))).chr(hexdec(substr($hex,0,2))).chr(0).chr(0);
-  $key = $this->md5_16($tmp);
-  $this->ARC4_init(substr($key,0,10));
-}
-
-/**
-* initialize the ARC4 encryption
-*/
-function ARC4_init($key=''){
-  $this->arc4 = '';
-  // setup the control array
-  if (strlen($key)==0){
-    return;
-  }
-  $k = '';
-  while(strlen($k)<256){
-    $k.=$key;
-  }
-  $k=substr($k,0,256);
-  for ($i=0;$i<256;$i++){
-    $this->arc4 .= chr($i);
-  }
-  $j=0;
-  for ($i=0;$i<256;$i++){
-    $t = $this->arc4[$i];
-    $j = ($j + ord($t) + ord($k[$i]))%256;
-    $this->arc4[$i]=$this->arc4[$j];
-    $this->arc4[$j]=$t;
-  }    
-}
-
-/**
-* ARC4 encrypt a text string
-*/
-function ARC4($text){
-  $len=strlen($text);
-  $a=0;
-  $b=0;
-  $c = $this->arc4;
-  $out='';
-  for ($i=0;$i<$len;$i++){
-    $a = ($a+1)%256;
-    $t= $c[$a];
-    $b = ($b+ord($t))%256;
-    $c[$a]=$c[$b];
-    $c[$b]=$t;
-    $k = ord($c[(ord($c[$a])+ord($c[$b]))%256]);
-    $out.=chr(ord($text[$i]) ^ $k);
-  }
-  
-  return $out;
-}
-
-/**
-* functions which can be called to adjust or add to the document
-*/
-
-/**
-* add a link in the document to an external URL
-*/
-function addLink($url,$x0,$y0,$x1,$y1){
-  $this->numObj++;
-  $info = array('type'=>'link','url'=>$url,'rect'=>array($x0,$y0,$x1,$y1));
-  $this->o_annotation($this->numObj,'new',$info);
-}
-
-/**
-* add a link in the document to an internal destination (ie. within the document)
-*/
-function addInternalLink($label,$x0,$y0,$x1,$y1){
-  $this->numObj++;
-  $info = array('type'=>'ilink','label'=>$label,'rect'=>array($x0,$y0,$x1,$y1));
-  $this->o_annotation($this->numObj,'new',$info);
-}
-
-/**
-* set the encryption of the document
-* can be used to turn it on and/or set the passwords which it will have.
-* also the functions that the user will have are set here, such as print, modify, add
-*/
-function setEncryption($userPass='',$ownerPass='',$pc=array()){
-  $p=bindec(11000000);
-
-  $options = array(
-     'print'=>4
-    ,'modify'=>8
-    ,'copy'=>16
-    ,'add'=>32
-  );
-  foreach($pc as $k=>$v){
-    if ($v && isset($options[$k])){
-      $p+=$options[$k];
-    } else if (isset($options[$v])){
-      $p+=$options[$v];
-    }
-  }
-  // implement encryption on the document
-  if ($this->arc4_objnum == 0){
-    // then the block does not exist already, add it.
-    $this->numObj++;
-    if (strlen($ownerPass)==0){
-      $ownerPass=$userPass;
-    }
-    $this->o_encryption($this->numObj,'new',array('user'=>$userPass,'owner'=>$ownerPass,'p'=>$p));
-  }
-}
-
-/**
-* should be used for internal checks, not implemented as yet
-*/
-function checkAllHere(){
-}
-
-/**
-* return the pdf stream as a string returned from the function
-*/
-function output($debug=0){
-
-  if ($debug){
-    // turn compression off
-    $this->options['compression']=0;
-  }
-
-  if ($this->arc4_objnum){
-    $this->ARC4_init($this->encryptionKey);
-  }
-
-  $this->checkAllHere();
-
-  $xref=array();
-  $content="%PDF-1.3\n%âãÏÓ\n";
-//  $content="%PDF-1.3\n";
-  $pos=strlen($content);
-  foreach($this->objects as $k=>$v){
-    $tmp='o_'.$v['t'];
-    $cont=$this->$tmp($k,'out');
-    $content.=$cont;
-    $xref[]=$pos;
-    $pos+=strlen($cont);
-  }
-  $content.="\nxref\n0 ".(count($xref)+1)."\n0000000000 65535 f \n";
-  foreach($xref as $p){
-    $content.=substr('0000000000',0,10-strlen($p)).$p." 00000 n \n";
-  }
-  $content.="\ntrailer\n  << /Size ".(count($xref)+1)."\n     /Root 1 0 R\n     /Info ".$this->infoObject." 0 R\n";
-  // if encryption has been applied to this document then add the marker for this dictionary
-  if ($this->arc4_objnum > 0){
-    $content .= "/Encrypt ".$this->arc4_objnum." 0 R\n";
-  }
-  if (strlen($this->fileIdentifier)){
-    $content .= "/ID[<".$this->fileIdentifier."><".$this->fileIdentifier.">]\n";
-  }
-  $content .= "  >>\nstartxref\n".$pos."\n%%EOF\n";
-  return $content;
-}
-
-/**
-* intialize a new document
-* if this is called on an existing document results may be unpredictable, but the existing document would be lost at minimum
-* this function is called automatically by the constructor function
-*
-* @access private
-*/
-function newDocument($pageSize=array(0,0,612,792)){
-  $this->numObj=0;
-  $this->objects = array();
-
-  $this->numObj++;
-  $this->o_catalog($this->numObj,'new');
-
-  $this->numObj++;
-  $this->o_outlines($this->numObj,'new');
-
-  $this->numObj++;
-  $this->o_pages($this->numObj,'new');
-
-  $this->o_pages($this->numObj,'mediaBox',$pageSize);
-  $this->currentNode = 3;
-
-  $this->numObj++;
-  $this->o_procset($this->numObj,'new');
-
-  $this->numObj++;
-  $this->o_info($this->numObj,'new');
-
-  $this->numObj++;
-  $this->o_page($this->numObj,'new');
-
-  // need to store the first page id as there is no way to get it to the user during 
-  // startup
-  $this->firstPageId = $this->currentContents;
-}
-
-/**
-* open the font file and return a php structure containing it.
-* first check if this one has been done before and saved in a form more suited to php
-* note that if a php serialized version does not exist it will try and make one, but will
-* require write access to the directory to do it... it is MUCH faster to have these serialized
-* files.
-*
-* @access private
-*/
-function openFont($font){
-  // assume that $font contains both the path and perhaps the extension to the file, split them
-  $pos=strrpos($font,'/');
-  if ($pos===false){
-    $dir = './';
-    $name = $font;
-  } else {
-    $dir=substr($font,0,$pos+1);
-    $name=substr($font,$pos+1);
-  }
-
-  if (substr($name,-4)=='.afm'){
-    $name=substr($name,0,strlen($name)-4);
-  }
-  $this->addMessage('openFont: '.$font.' - '.$name);
-  if (file_exists($dir.'php_'.$name.'.afm')){
-    $this->addMessage('openFont: php file exists '.$dir.'php_'.$name.'.afm');
-    $tmp = file($dir.'php_'.$name.'.afm');
-    $this->fonts[$font]=unserialize($tmp[0]);
-    if (!isset($this->fonts[$font]['_version_']) || $this->fonts[$font]['_version_']<1){
-      // if the font file is old, then clear it out and prepare for re-creation
-      $this->addMessage('openFont: clear out, make way for new version.');
-      unset($this->fonts[$font]);
-    }
-  }
-  if (!isset($this->fonts[$font]) && file_exists($dir.$name.'.afm')){
-    // then rebuild the php_<font>.afm file from the <font>.afm file
-    $this->addMessage('openFont: build php file from '.$dir.$name.'.afm');
-    $data = array();
-    $file = file($dir.$name.'.afm');
-    foreach ($file as $rowA){
-      $row=trim($rowA);
-      $pos=strpos($row,' ');
-      if ($pos){
-        // then there must be some keyword
-        $key = substr($row,0,$pos);
-        switch ($key){
-          case 'FontName':
-          case 'FullName':
-          case 'FamilyName':
-          case 'Weight':
-          case 'ItalicAngle':
-          case 'IsFixedPitch':
-          case 'CharacterSet':
-          case 'UnderlinePosition':
-          case 'UnderlineThickness':
-          case 'Version':
-          case 'EncodingScheme':
-          case 'CapHeight':
-          case 'XHeight':
-          case 'Ascender':
-          case 'Descender':
-          case 'StdHW':
-          case 'StdVW':
-          case 'StartCharMetrics':
-            $data[$key]=trim(substr($row,$pos));
-            break;
-          case 'FontBBox':
-            $data[$key]=explode(' ',trim(substr($row,$pos)));
-            break;
-          case 'C':
-            //C 39 ; WX 222 ; N quoteright ; B 53 463 157 718 ;
-            $bits=explode(';',trim($row));
-            $dtmp=array();
-            foreach($bits as $bit){
-              $bits2 = explode(' ',trim($bit));
-              if (strlen($bits2[0])){
-                if (count($bits2)>2){
-                  $dtmp[$bits2[0]]=array();
-                  for ($i=1;$i<count($bits2);$i++){
-                    $dtmp[$bits2[0]][]=$bits2[$i];
-                  }
-                } else if (count($bits2)==2){
-                  $dtmp[$bits2[0]]=$bits2[1];
-                }
-              }
-            }
-            if ($dtmp['C']>=0){
-              $data['C'][$dtmp['C']]=$dtmp;
-              $data['C'][$dtmp['N']]=$dtmp;
-            } else {
-              $data['C'][$dtmp['N']]=$dtmp;
-            }
-            break;
-          case 'KPX':
-            //KPX Adieresis yacute -40
-            $bits=explode(' ',trim($row));
-            $data['KPX'][$bits[1]][$bits[2]]=$bits[3];
-            break;
-        }
-      }
-    }
-    $data['_version_']=1;
-    $this->fonts[$font]=$data;
-    $fp = fopen($dir.'php_'.$name.'.afm','w');
-    fwrite($fp,serialize($data));
-    fclose($fp);
-  } else if (!isset($this->fonts[$font])){
-    $this->addMessage('openFont: no font file found');
-//    echo 'Font not Found '.$font;
-  }
-}
-
-/**
-* if the font is not loaded then load it and make the required object
-* else just make it the current font
-* the encoding array can contain 'encoding'=> 'none','WinAnsiEncoding','MacRomanEncoding' or 'MacExpertEncoding'
-* note that encoding='none' will need to be used for symbolic fonts
-* and 'differences' => an array of mappings between numbers 0->255 and character names.
-*
-*/
-function selectFont($fontName,$encoding='',$set=1){
-  if (!isset($this->fonts[$fontName])){
-    // load the file
-    $this->openFont($fontName);
-    if (isset($this->fonts[$fontName])){
-      $this->numObj++;
-      $this->numFonts++;
-      $pos=strrpos($fontName,'/');
-//      $dir=substr($fontName,0,$pos+1);
-      $name=substr($fontName,$pos+1);
-      if (substr($name,-4)=='.afm'){
-        $name=substr($name,0,strlen($name)-4);
-      }
-      $options=array('name'=>$name);
-      if (is_array($encoding)){
-        // then encoding and differences might be set
-        if (isset($encoding['encoding'])){
-          $options['encoding']=$encoding['encoding'];
-        }
-        if (isset($encoding['differences'])){
-          $options['differences']=$encoding['differences'];
-        }
-      } else if (strlen($encoding)){
-        // then perhaps only the encoding has been set
-        $options['encoding']=$encoding;
-      }
-      $fontObj = $this->numObj;
-      $this->o_font($this->numObj,'new',$options);
-      $this->fonts[$fontName]['fontNum']=$this->numFonts;
-      // if this is a '.afm' font, and there is a '.pfa' file to go with it ( as there
-      // should be for all non-basic fonts), then load it into an object and put the
-      // references into the font object
-      $basefile = substr($fontName,0,strlen($fontName)-4);
-      if (file_exists($basefile.'.pfb')){
-        $fbtype = 'pfb';
-      } else if (file_exists($basefile.'.ttf')){
-        $fbtype = 'ttf';
-      } else {
-        $fbtype='';
-      }
-      $fbfile = $basefile.'.'.$fbtype;
-      
-//      $pfbfile = substr($fontName,0,strlen($fontName)-4).'.pfb';
-//      $ttffile = substr($fontName,0,strlen($fontName)-4).'.ttf';
-      $this->addMessage('selectFont: checking for - '.$fbfile);
-      if (substr($fontName,-4)=='.afm' && strlen($fbtype) ){
-        $adobeFontName = $this->fonts[$fontName]['FontName'];
-//        $fontObj = $this->numObj;
-        $this->addMessage('selectFont: adding font file - '.$fbfile.' - '.$adobeFontName);
-        // find the array of fond widths, and put that into an object.
-        $firstChar = -1;
-        $lastChar = 0;
-        $widths = array();
-        foreach ($this->fonts[$fontName]['C'] as $num=>$d){
-          if (intval($num)>0 || $num=='0'){
-            if ($lastChar>0 && $num>$lastChar+1){
-              for($i=$lastChar+1;$i<$num;$i++){
-                $widths[] = 0;
-              }
-            }
-            $widths[] = $d['WX'];
-            if ($firstChar==-1){
-              $firstChar = $num;
-            }
-            $lastChar = $num;
-          }
-        }
-        // also need to adjust the widths for the differences array
-        if (isset($options['differences'])){
-          foreach($options['differences'] as $charNum=>$charName){
-            if ($charNum>$lastChar){
-              for($i=$lastChar+1;$i<=$charNum;$i++){
-                $widths[]=0;
-              }
-              $lastChar=$charNum;
-            }
-            if (isset($this->fonts[$fontName]['C'][$charName])){
-              $widths[$charNum-$firstChar]=$this->fonts[$fontName]['C'][$charName]['WX'];
-            }
-          }
-        }
-        $this->addMessage('selectFont: FirstChar='.$firstChar);
-        $this->addMessage('selectFont: LastChar='.$lastChar);
-        $this->numObj++;
-        $this->o_contents($this->numObj,'new','raw');
-        $this->objects[$this->numObj]['c'].='[';
-        foreach($widths as $width){
-          $this->objects[$this->numObj]['c'].=' '.$width;
-        }
-        $this->objects[$this->numObj]['c'].=' ]';
-        $widthid = $this->numObj;
-
-        // load the pfb file, and put that into an object too.
-        // note that pdf supports only binary format type 1 font files, though there is a 
-        // simple utility to convert them from pfa to pfb.
-        $fp = fopen($fbfile,'rb');
-        $tmp = get_magic_quotes_runtime();
-        set_magic_quotes_runtime(0);
-        $data = fread($fp,filesize($fbfile));
-        set_magic_quotes_runtime($tmp);
-        fclose($fp);
-
-        // create the font descriptor
-        $this->numObj++;
-        $fontDescriptorId = $this->numObj;
-        $this->numObj++;
-        $pfbid = $this->numObj;
-        // determine flags (more than a little flakey, hopefully will not matter much)
-        $flags=0;
-        if ($this->fonts[$fontName]['ItalicAngle']!=0){ $flags+=pow(2,6); }
-        if ($this->fonts[$fontName]['IsFixedPitch']=='true'){ $flags+=1; }
-        $flags+=pow(2,5); // assume non-sybolic
-
-        $list = array('Ascent'=>'Ascender','CapHeight'=>'CapHeight','Descent'=>'Descender','FontBBox'=>'FontBBox','ItalicAngle'=>'ItalicAngle');
-        $fdopt = array(
-         'Flags'=>$flags
-         ,'FontName'=>$adobeFontName
-         ,'StemV'=>100  // don't know what the value for this should be!
-        );
-        foreach($list as $k=>$v){
-          if (isset($this->fonts[$fontName][$v])){
-            $fdopt[$k]=$this->fonts[$fontName][$v];
-          }
-        }
-
-        if ($fbtype=='pfb'){
-          $fdopt['FontFile']=$pfbid;
-        } else if ($fbtype=='ttf'){
-          $fdopt['FontFile2']=$pfbid;
-        }
-        $this->o_fontDescriptor($fontDescriptorId,'new',$fdopt);        
-
-        // embed the font program
-        $this->o_contents($this->numObj,'new');
-        $this->objects[$pfbid]['c'].=$data;
-        // determine the cruicial lengths within this file
-        if ($fbtype=='pfb'){
-          $l1 = strpos($data,'eexec')+6;
-          $l2 = strpos($data,'00000000')-$l1;
-          $l3 = strlen($data)-$l2-$l1;
-          $this->o_contents($this->numObj,'add',array('Length1'=>$l1,'Length2'=>$l2,'Length3'=>$l3));
-        } else if ($fbtype=='ttf'){
-          $l1 = strlen($data);
-          $this->o_contents($this->numObj,'add',array('Length1'=>$l1));
-        }
-
-
-        // tell the font object about all this new stuff
-        $tmp = array('BaseFont'=>$adobeFontName,'Widths'=>$widthid
-                                      ,'FirstChar'=>$firstChar,'LastChar'=>$lastChar
-                                      ,'FontDescriptor'=>$fontDescriptorId);
-        if ($fbtype=='ttf'){
-          $tmp['SubType']='TrueType';
-        }
-        $this->addMessage('adding extra info to font.('.$fontObj.')');
-        foreach($tmp as $fk=>$fv){
-          $this->addMessage($fk." : ".$fv);
-        }
-        $this->o_font($fontObj,'add',$tmp);
-
-      } else {
-        $this->addMessage('selectFont: pfb or ttf file not found, ok if this is one of the 14 standard fonts');
-      }
-
-
-      // also set the differences here, note that this means that these will take effect only the 
-      //first time that a font is selected, else they are ignored
-      if (isset($options['differences'])){
-        $this->fonts[$fontName]['differences']=$options['differences'];
-      }
-    }
-  }
-  if ($set && isset($this->fonts[$fontName])){
-    // so if for some reason the font was not set in the last one then it will not be selected
-    $this->currentBaseFont=$fontName;
-    // the next line means that if a new font is selected, then the current text state will be
-    // applied to it as well.
-    $this->setCurrentFont();
-  }
-  return $this->currentFontNum;
-}
-
-/**
-* sets up the current font, based on the font families, and the current text state
-* note that this system is quite flexible, a <b><i> font can be completely different to a
-* <i><b> font, and even <b><b> will have to be defined within the family to have meaning
-* This function is to be called whenever the currentTextState is changed, it will update
-* the currentFont setting to whatever the appropriatte family one is.
-* If the user calls selectFont themselves then that will reset the currentBaseFont, and the currentFont
-* This function will change the currentFont to whatever it should be, but will not change the 
-* currentBaseFont.
-*
-* @access private
-*/
-function setCurrentFont(){
-  if (strlen($this->currentBaseFont)==0){
-    // then assume an initial font
-    $this->selectFont('./fonts/Helvetica.afm');
-  }
-  $cf = substr($this->currentBaseFont,strrpos($this->currentBaseFont,'/')+1);
-  if (strlen($this->currentTextState)
-    && isset($this->fontFamilies[$cf]) 
-      && isset($this->fontFamilies[$cf][$this->currentTextState])){
-    // then we are in some state or another
-    // and this font has a family, and the current setting exists within it
-    // select the font, then return it
-    $nf = substr($this->currentBaseFont,0,strrpos($this->currentBaseFont,'/')+1).$this->fontFamilies[$cf][$this->currentTextState];
-    $this->selectFont($nf,'',0);
-    $this->currentFont = $nf;
-    $this->currentFontNum = $this->fonts[$nf]['fontNum'];
-  } else {
-    // the this font must not have the right family member for the current state
-    // simply assume the base font
-    $this->currentFont = $this->currentBaseFont;
-    $this->currentFontNum = $this->fonts[$this->currentFont]['fontNum'];    
-  }
-}
-
-/**
-* function for the user to find out what the id is of the first page that was created during
-* startup - useful if they wish to add something to it later.
-*/
-function getFirstPageId(){
-  return $this->firstPageId;
-}
-
-/**
-* add content to the currently active object
-*
-* @access private
-*/
-function addContent($content){
-  $this->objects[$this->currentContents]['c'].=$content;
-}
-
-/**
-* sets the colour for fill operations
-*/
-function setColor($r,$g,$b,$force=0){
-  if ($r>=0 && ($force || $r!=$this->currentColour['r'] || $g!=$this->currentColour['g'] || $b!=$this->currentColour['b'])){
-    $this->objects[$this->currentContents]['c'].="\n".sprintf('%.3f',$r).' '.sprintf('%.3f',$g).' '.sprintf('%.3f',$b).' rg';
-    $this->currentColour=array('r'=>$r,'g'=>$g,'b'=>$b);
-  }
-}
-
+/*
+       This class is an extension to the tcpdf class using a syntax that the original reports were written in
+       (the R &OS pdf.php class) - due to easily portation this wrapper class
+       was written to allow the same code base to use the more functional tcpdf.class by Nicola Asuni
+
+*      Wrapper for use R&OSpdf API with tcpdf.org class
+*      Joe Hunt <joe.hunt.consulting@gmail.com> and Janusz Dobrowolski <janusz@iron.from.pl>
+*/
+
+define("K_RE_PATTERN_RTL", "/(
+         \xD6\xBE                                                                                                                                                                                      # R
+       | \xD7[\x80\x83\x86\x90-\xAA\xB0-\xB4]                                                                  # R
+       | \xDF[\x80-\xAA\xB4\xB5\xBA]                                                                                                           # R
+       | \xE2\x80\x8F                                                                                                                                                                  # R
+       | \xEF\xAC[\x9D\x9F\xA0-\xA8\xAA-\xB6\xB8-\xBC\xBE]                     # R
+       | \xEF\xAD[\x80\x81\x83\x84\x86-\x8F]                                                                           # R
+       | \xF0\x90\xA0[\x80-\x85\x88\x8A-\xB5\xB7\xB8\xBC\xBF]  # R
+       | \xF0\x90\xA4[\x80-\x99]                                                                                                                               # R
+       | \xF0\x90\xA8[\x80\x90-\x93\x95-\x97\x99-\xB3]                                 # R
+       | \xF0\x90\xA9[\x80-\x87\x90-\x98]                                                                                      # R
+       | \xE2\x80[\xAB\xAE]                                                                                                                                            # RLE & RLO
+       )/x");
+
+/*
+ * Pattern to test Arabic strings using regular expressions.
+ * source: http://www.w3.org/International/questions/qa-forms-utf-8
+ */
+define("K_RE_PATTERN_ARABIC", "/(
+                         \xD8[\x80-\x83\x8B\x8D\x9B\x9E\x9F\xA1-\xBA]  # AL
+                       | \xD9[\x80-\x8A\xAD-\xAF\xB1-\xBF]                                                     # AL
+                       | \xDA[\x80-\xBF]                                                                                                                               # AL
+                       | \xDB[\x80-\x95\x9D\xA5\xA6\xAE\xAF\xBA-\xBF]  # AL
+                       | \xDC[\x80-\x8D\x90\x92-\xAF]                                                                  # AL
+                       | \xDD[\x8D-\xAD]                                                                                                                               # AL
+                       | \xDE[\x80-\xA5\xB1]                                                                                                           # AL
+                       | \xEF\xAD[\x90-\xBF]                                                                                                           # AL
+                       | \xEF\xAE[\x80-\xB1]                                                                                                           # AL
+                       | \xEF\xAF[\x93-\xBF]                                                                                                           # AL
+                       | \xEF[\xB0-\xB3][\x80-\xBF]                                                                            # AL
+                       | \xEF\xB4[\x80-\xBD]                                                                                                           # AL
+                       | \xEF\xB5[\x90-\xBF]                                                                                                           # AL
+                       | \xEF\xB6[\x80-\x8F\x92-\xBF]                                                                  # AL
+                       | \xEF\xB7[\x80-\x87\xB0-\xBC]                                                                  # AL
+                       | \xEF\xB9[\xB0-\xB4\xB6-\xBF]                                                                  # AL
+                       | \xEF\xBA[\x80-\xBF]                                                                                                           # AL
+                       | \xEF\xBB[\x80-\xBC]                                                                                                           # AL
+                       | \xD9[\xA0-\xA9\xAB\xAC]                                                                                               # AN
+                       )/x");
+
+include_once (dirname(__FILE__).'/tcpdf.php');
+
+class Cpdf extends TCPDF {
+
+       function Cpdf($pageSize='A4', $l=array())
+       {
+               if (!isset($l['a_meta_charset']))
+                       $l = array('a_meta_charset' => 'ISO-8859-1', 'a_meta_dir' => 'ltr', 'a_meta_language' => 'en_GB', 'w_page' => 'page');
+               $enc = $l['a_meta_charset'];
+               $uni = ($enc == 'UTF-8' || $enc == 'GB2312' ? true : false);
+               if ($enc == "GB2312")
+                       ini_set("memory_limit", "25M");
+               $this->TCPDF('P', 'pt', $pageSize, $uni, $enc);
+               $this->setLanguageArray($l);
+               $this->setPrintHeader(false);
+               $this->setPrintFooter(false);
+               $this->setPDFVersion("1.3");
+               $this->setAutoPageBreak(0);
+               $this->AddPage();
+
+               $this->SetLineWidth(1);
+               $this->cMargin = 0;
+       }
+
+       function selectFont($fontname, $style='')
+       {
+               if ($fontname != '')
+                       $fontname = basename($fontname);
+               if ($style == 'italic')
+                       $type = 'i';
+               elseif ($style == 'bold')
+                       $type = 'b';
+               else
+                       $type = '';
+               if ($fontname == '')
+               {
+                       if ($this->isunicode)
+                       {
+                               switch ($this->l['a_meta_language'])
+                               {
+                                       case "ar_EG" :  $fontname = "ae_tholoth";       break;
+                                       case "zh_CN" :  $fontname = "gbsn00lp";         break;
+                                       default :       $fontname = "dejavu";           break;
+                               }
+                       }
+                       elseif ($this->encoding === "ISO-8859-2")
+                       {
+                               switch ($this->l['a_meta_language'])
+                               {
+                                       default :               $fontname = "freesans";         break;
+                               }
+                       }
+                       elseif ($this->encoding === "ISO-8859-5")
+                       {
+                               switch ($this->l['a_meta_language'])
+                               {
+                                       default :               $fontname = "freesans5";        break;
+                               }
+                       }
+                       // else use built-in adobe fonts helvetica.
+               }
+               $this->SetFont($fontname, $type);
+       }
+
+       function Header1()
+       {
+       }
+
+       function Footer()
+       {
+       }
+
+       function newPage()
+       {
+               TCPDF::AddPage();
+       }
+
+       function line($x1,$y1,$x2,$y2)
+       {
+               TCPDF::line($x1, $this->h-$y1, $x2, $this->h-$y2);
+       }
+
+       function rectangle($x, $y, $w, $h, $style='', $border_style=array(), $fill_color=array())
+       {
+               TCPDF::Rect($x, $this->h-$y, $w, $h, $style, $border_style, $fill_color);
+       }
+
+
+       function addText($xb,$yb,$size,$txt)//,$angle=0,$wordSpaceAdjust=0)
+       {
+               if ($this->isunicode && $this->encoding != "UTF-8")
+                       $txt = iconv($this->encoding, "UTF-8", $txt);
+               $this->SetFontSize($size);
+               $this->Text($xb, $this->h-$yb, $txt);
+       }
+
+       function addInfo($label,$value)
+       {
+               if($label=='Title')
+               {
+                       $this->SetTitle($value);
+               }
+               if ($label=='Subject')
+               {
+                       $this->SetSubject($value);
+               }
+               if($label=='Creator')
+               {
+                       // The Creator info in source is not exactly it should be ;)
+                       $value = str_replace( "ros.co.nz", "tcpdf.org", $value );
+                       $value = str_replace( "R&OS", "", $value );
+                       $this->SetCreator( $value );
+               }
+               if($label=='Author')
+               {
+                       $this->SetAuthor($value);
+               }
+       }
+
+       function addJpegFromFile($img,$x,$y,$w=0,$h=0)
+       {
+               $this->Image($img, $x, $this->h-$y-$h, $w, $h);
+       }
+
+       function addPngFromFile($img,$x,$y,$w=0,$h=0)
+       {
+               $this->Image($img, $x, $this->h-$y-$h, $w, $h);
+       }
+       /*
+       * Next Two functions are adopted from R&OS pdf class
+       */
+
+       /**
+       * draw a part of an ellipse
+       */
+       function partEllipse($x0,$y0,$astart,$afinish,$r1,$r2=0,$angle=0,$nSeg=8)
+       {
+               $this->ellipse($x0,$y0,$r1,$r2,$angle,$nSeg,$astart,$afinish,0);
+       }
+
+       /**
+       * draw an ellipse
+       * note that the part and filled ellipse are just special cases of this function
+       *
+       * draws an ellipse in the current line style
+       * centered at $x0,$y0, radii $r1,$r2
+       * if $r2 is not set, then a circle is drawn
+       * nSeg is not allowed to be less than 2, as this will simply draw a line (and will even draw a
+       * pretty crappy shape at 2, as we are approximating with bezier curves.
+       */
+       function ellipse($x0,$y0,$r1,$r2=0,$angle=0,$nSeg=8,$astart=0,$afinish=360,$close=1,$fill=0)
+       {
+               TCPDF::Ellipse($x0, $y0, $r1, $r2, $angle, $astart. $afinish, ($close?'C':''), "", "", $nSeg);
+       }
+       function Stream()
+       {
+               TCPDF::Output('', 'I');
+       }
+
+       function Output()
+       {
+               return TCPDF::Output('','S');
+       }
+
+       function calcTextWrap($txt, $width, $spacebreak=false)
+       {
+               $ret = "";
+               $txt2 = $txt;
+               $w = $this->GetStringWidth($txt);
+               if ($w > $width && $w > 0 && $width != 0)
+               {
+                       $n = strlen($txt);
+                       $k = intval($n * $width / $w);
+                       if ($k > 0 && $k < $n)
+                       {
+                               $txt2 = substr($txt, 0, $k);
+                               if ($spacebreak && (($pos = strrpos($txt2, " ")) !== false))
+                               {
+                                       $txt2 = substr($txt2, 0, $pos);
+                                       $ret = substr($txt, $pos+1);
+                               }
+                               else
+                                       $ret = substr($txt, $k);
+                       }
+               }
+               return array($txt2, $ret);
+       }
+
+       function addTextWrap($xb, $yb, $w, $h, $txt, $align='left', $border=0, $fill=0, $spacebreak=false)
+       {
+               $ret = "";
+               if (!$this->rtl)
+               {
+                       if ($align == 'right')
+                               $align = 'R';
+                       elseif ($align == 'left')
+                               $align = 'L';
+               }
+               else
+                       $align = 'R';
+               $txt = $this->calcTextWrap($txt, $w, $spacebreak);
+               $ret = $txt[1];
+               $txt = $txt[0];
+               $this->SetXY($xb, $this->h - $yb - $h);
+               $txt = TCPDF::unhtmlentities($txt);
+               if ($this->isunicode && $this->encoding != "UTF-8")
+                       $txt = iconv($this->encoding, "UTF-8", $txt);
+               $this->Cell($w, $h, $txt, $border, 0, $align, $fill);
+               return $ret;
+       }
 /**
 * sets the colour for stroke operations
 */
-function setStrokeColor($r,$g,$b,$force=0){
-  if ($r>=0 && ($force || $r!=$this->currentStrokeColour['r'] || $g!=$this->currentStrokeColour['g'] || $b!=$this->currentStrokeColour['b'])){
-    $this->objects[$this->currentContents]['c'].="\n".sprintf('%.3f',$r).' '.sprintf('%.3f',$g).' '.sprintf('%.3f',$b).' RG';
-    $this->currentStrokeColour=array('r'=>$r,'g'=>$g,'b'=>$b);
-  }
-}
-
-/**
-* draw a line from one set of coordinates to another
-*/
-function line($x1,$y1,$x2,$y2){
-  $this->objects[$this->currentContents]['c'].="\n".sprintf('%.3f',$x1).' '.sprintf('%.3f',$y1).' m '.sprintf('%.3f',$x2).' '.sprintf('%.3f',$y2).' l S';
-}
-
-/**
-* draw a bezier curve based on 4 control points
-*/
-function curve($x0,$y0,$x1,$y1,$x2,$y2,$x3,$y3){
-  // in the current line style, draw a bezier curve from (x0,y0) to (x3,y3) using the other two points
-  // as the control points for the curve.
-  $this->objects[$this->currentContents]['c'].="\n".sprintf('%.3f',$x0).' '.sprintf('%.3f',$y0).' m '.sprintf('%.3f',$x1).' '.sprintf('%.3f',$y1);
-  $this->objects[$this->currentContents]['c'].= ' '.sprintf('%.3f',$x2).' '.sprintf('%.3f',$y2).' '.sprintf('%.3f',$x3).' '.sprintf('%.3f',$y3).' c S';
-}
-
-/**
-* draw a part of an ellipse
-*/
-function partEllipse($x0,$y0,$astart,$afinish,$r1,$r2=0,$angle=0,$nSeg=8){
-  $this->ellipse($x0,$y0,$r1,$r2,$angle,$nSeg,$astart,$afinish,0);
-}
-
-/**
-* draw a filled ellipse
-*/
-function filledEllipse($x0,$y0,$r1,$r2=0,$angle=0,$nSeg=8,$astart=0,$afinish=360){
-  return $this->ellipse($x0,$y0,$r1,$r2=0,$angle,$nSeg,$astart,$afinish,1,1);
-}
-
-/**
-* draw an ellipse
-* note that the part and filled ellipse are just special cases of this function
-*
-* draws an ellipse in the current line style
-* centered at $x0,$y0, radii $r1,$r2
-* if $r2 is not set, then a circle is drawn
-* nSeg is not allowed to be less than 2, as this will simply draw a line (and will even draw a 
-* pretty crappy shape at 2, as we are approximating with bezier curves.
-*/
-function ellipse($x0,$y0,$r1,$r2=0,$angle=0,$nSeg=8,$astart=0,$afinish=360,$close=1,$fill=0){
-  if ($r1==0){
-    return;
-  }
-  if ($r2==0){
-    $r2=$r1;
-  }
-  if ($nSeg<2){
-    $nSeg=2;
-  }
-
-  $astart = deg2rad((float)$astart);
-  $afinish = deg2rad((float)$afinish);
-  $totalAngle =$afinish-$astart;
-
-  $dt = $totalAngle/$nSeg;
-  $dtm = $dt/3;
-
-  if ($angle != 0){
-    $a = -1*deg2rad((float)$angle);
-    $tmp = "\n q ";
-    $tmp .= sprintf('%.3f',cos($a)).' '.sprintf('%.3f',(-1.0*sin($a))).' '.sprintf('%.3f',sin($a)).' '.sprintf('%.3f',cos($a)).' ';
-    $tmp .= sprintf('%.3f',$x0).' '.sprintf('%.3f',$y0).' cm';
-    $this->objects[$this->currentContents]['c'].= $tmp;
-    $x0=0;
-    $y0=0;
-  }
-
-  $t1 = $astart;
-  $a0 = $x0+$r1*cos($t1);
-  $b0 = $y0+$r2*sin($t1);
-  $c0 = -$r1*sin($t1);
-  $d0 = $r2*cos($t1);
-
-  $this->objects[$this->currentContents]['c'].="\n".sprintf('%.3f',$a0).' '.sprintf('%.3f',$b0).' m ';
-  for ($i=1;$i<=$nSeg;$i++){
-    // draw this bit of the total curve
-    $t1 = $i*$dt+$astart;
-    $a1 = $x0+$r1*cos($t1);
-    $b1 = $y0+$r2*sin($t1);
-    $c1 = -$r1*sin($t1);
-    $d1 = $r2*cos($t1);
-    $this->objects[$this->currentContents]['c'].="\n".sprintf('%.3f',($a0+$c0*$dtm)).' '.sprintf('%.3f',($b0+$d0*$dtm));
-    $this->objects[$this->currentContents]['c'].= ' '.sprintf('%.3f',($a1-$c1*$dtm)).' '.sprintf('%.3f',($b1-$d1*$dtm)).' '.sprintf('%.3f',$a1).' '.sprintf('%.3f',$b1).' c';
-    $a0=$a1;
-    $b0=$b1;
-    $c0=$c1;
-    $d0=$d1;    
-  }
-  if ($fill){
-    $this->objects[$this->currentContents]['c'].=' f';
-  } else {
-    if ($close){
-      $this->objects[$this->currentContents]['c'].=' s'; // small 's' signifies closing the path as well
-    } else {
-      $this->objects[$this->currentContents]['c'].=' S';
+    function setStrokeColor($r,$g,$b,$force=0)
+    {
+        TCPDF::SetDrawColor($r,$g,$b);
     }
-  }
-  if ($angle !=0){
-    $this->objects[$this->currentContents]['c'].=' Q';
-  }
-}
-
 /**
 * this sets the line drawing style.
 * width, is the thickness of the line in user units
@@ -1785,1291 +276,17 @@ function ellipse($x0,$y0,$r1,$r2=0,$angle=0,$nSeg=8,$astart=0,$afinish=360,$clos
 *   on and off dashes.
 *   (2) represents 2 on, 2 off, 2 on , 2 off ...
 *   (2,1) is 2 on, 1 off, 2 on, 1 off.. etc
-* phase is a modifier on the dash pattern which is used to shift the point at which the pattern starts. 
-*/
-function setLineStyle($width=1,$cap='',$join='',$dash='',$phase=0){
-
-  // this is quite inefficient in that it sets all the parameters whenever 1 is changed, but will fix another day
-  $string = '';
-  if ($width>0){
-    $string.= $width.' w';
-  }
-  $ca = array('butt'=>0,'round'=>1,'square'=>2);
-  if (isset($ca[$cap])){
-    $string.= ' '.$ca[$cap].' J';
-  }
-  $ja = array('miter'=>0,'round'=>1,'bevel'=>2);
-  if (isset($ja[$join])){
-    $string.= ' '.$ja[$join].' j';
-  }
-  if (is_array($dash)){
-    $string.= ' [';
-    foreach ($dash as $len){
-      $string.=' '.$len;
-    }
-    $string.= ' ] '.$phase.' d';
-  }
-  $this->currentLineStyle = $string;
-  $this->objects[$this->currentContents]['c'].="\n".$string;
-}
-
-/**
-* draw a polygon, the syntax for this is similar to the GD polygon command
-*/
-function polygon($p,$np,$f=0){
-  $this->objects[$this->currentContents]['c'].="\n";
-  $this->objects[$this->currentContents]['c'].=sprintf('%.3f',$p[0]).' '.sprintf('%.3f',$p[1]).' m ';
-  for ($i=2;$i<$np*2;$i=$i+2){
-    $this->objects[$this->currentContents]['c'].= sprintf('%.3f',$p[$i]).' '.sprintf('%.3f',$p[$i+1]).' l ';
-  }
-  if ($f==1){
-    $this->objects[$this->currentContents]['c'].=' f';
-  } else {
-    $this->objects[$this->currentContents]['c'].=' S';
-  }
-}
-
-/**
-* a filled rectangle, note that it is the width and height of the rectangle which are the secondary paramaters, not
-* the coordinates of the upper-right corner
-*/
-function filledRectangle($x1,$y1,$width,$height){
-  $this->objects[$this->currentContents]['c'].="\n".sprintf('%.3f',$x1).' '.sprintf('%.3f',$y1).' '.sprintf('%.3f',$width).' '.sprintf('%.3f',$height).' re f';
-}
-
-/**
-* draw a rectangle, note that it is the width and height of the rectangle which are the secondary paramaters, not
-* the coordinates of the upper-right corner
-*/
-function rectangle($x1,$y1,$width,$height){
-  $this->objects[$this->currentContents]['c'].="\n".sprintf('%.3f',$x1).' '.sprintf('%.3f',$y1).' '.sprintf('%.3f',$width).' '.sprintf('%.3f',$height).' re S';
-}
-
-/**
-* add a new page to the document
-* this also makes the new page the current active object
-*/
-function newPage($insert=0,$id=0,$pos='after'){
-
-  // if there is a state saved, then go up the stack closing them
-  // then on the new page, re-open them with the right setings
-  
-  if ($this->nStateStack){
-    for ($i=$this->nStateStack;$i>=1;$i--){
-      $this->restoreState($i);
-    }
-  }
-
-  $this->numObj++;
-  if ($insert){
-    // the id from the ezPdf class is the od of the contents of the page, not the page object itself
-    // query that object to find the parent
-    $rid = $this->objects[$id]['onPage'];
-    $opt= array('rid'=>$rid,'pos'=>$pos);
-    $this->o_page($this->numObj,'new',$opt);
-  } else {
-    $this->o_page($this->numObj,'new');
-  }
-  // if there is a stack saved, then put that onto the page
-  if ($this->nStateStack){
-    for ($i=1;$i<=$this->nStateStack;$i++){
-      $this->saveState($i);
-    }
-  }  
-  // and if there has been a stroke or fill colour set, then transfer them
-  if ($this->currentColour['r']>=0){
-    $this->setColor($this->currentColour['r'],$this->currentColour['g'],$this->currentColour['b'],1);
-  }
-  if ($this->currentStrokeColour['r']>=0){
-    $this->setStrokeColor($this->currentStrokeColour['r'],$this->currentStrokeColour['g'],$this->currentStrokeColour['b'],1);
-  }
-
-  // if there is a line style set, then put this in too
-  if (strlen($this->currentLineStyle)){
-    $this->objects[$this->currentContents]['c'].="\n".$this->currentLineStyle;
-  }
-
-  // the call to the o_page object set currentContents to the present page, so this can be returned as the page id
-  return $this->currentContents;
-}
-
-/**
-* output the pdf code, streaming it to the browser
-* the relevant headers are set so that hopefully the browser will recognise it
-*/
-function stream($options=''){
-  // setting the options allows the adjustment of the headers
-  // values at the moment are:
-  // 'Content-Disposition'=>'filename'  - sets the filename, though not too sure how well this will 
-  //        work as in my trial the browser seems to use the filename of the php file with .pdf on the end
-  // 'Accept-Ranges'=>1 or 0 - if this is not set to 1, then this header is not included, off by default
-  //    this header seems to have caused some problems despite tha fact that it is supposed to solve
-  //    them, so I am leaving it off by default.
-  // 'compress'=> 1 or 0 - apply content stream compression, this is on (1) by default
-  if (!is_array($options)){
-    $options=array();
-  }
-  if ( isset($options['compress']) && $options['compress']==0){
-    $tmp = $this->output(1);
-  } else {
-    $tmp = $this->output();
-  }
-  header("Content-type: application/pdf");
-  header("Content-Length: ".strlen(ltrim($tmp)));
-  $fileName = (isset($options['Content-Disposition'])?$options['Content-Disposition']:'file.pdf');
-  header("Content-Disposition: inline; filename=".$fileName);
-  if (isset($options['Accept-Ranges']) && $options['Accept-Ranges']==1){
-    header("Accept-Ranges: ".strlen(ltrim($tmp))); 
-  }
-  echo ltrim($tmp);
-}
-
-/**
-* return the height in units of the current font in the given size
-*/
-function getFontHeight($size){
-  if (!$this->numFonts){
-    $this->selectFont('./fonts/Helvetica');
-  }
-  // for the current font, and the given size, what is the height of the font in user units
-  $h = $this->fonts[$this->currentFont]['FontBBox'][3]-$this->fonts[$this->currentFont]['FontBBox'][1];
-  return $size*$h/1000;
-}
-
-/**
-* return the font decender, this will normally return a negative number
-* if you add this number to the baseline, you get the level of the bottom of the font
-* it is in the pdf user units
-*/
-function getFontDecender($size){
-  // note that this will most likely return a negative value
-  if (!$this->numFonts){
-    $this->selectFont('./fonts/Helvetica');
-  }
-  $h = $this->fonts[$this->currentFont]['FontBBox'][1];
-  return $size*$h/1000;
-}
-
-/**
-* filter the text, this is applied to all text just before being inserted into the pdf document
-* it escapes the various things that need to be escaped, and so on
-*
-* @access private
-*/
-function filterText($text){
-  $text = str_replace('\\','\\\\',$text);
-  $text = str_replace('(','\(',$text);
-  $text = str_replace(')','\)',$text);
-  $text = str_replace('&lt;','<',$text);
-  $text = str_replace('&gt;','>',$text);
-  $text = str_replace('&#039;','\'',$text);
-  $text = str_replace('&quot;','"',$text);
-  $text = str_replace('&amp;','&',$text);
-
-  return $text;
-}
-
-/**
-* given a start position and information about how text is to be laid out, calculate where 
-* on the page the text will end
-*
-* @access private
-*/
-function PRVTgetTextPosition($x,$y,$angle,$size,$wa,$text){
-  // given this information return an array containing x and y for the end position as elements 0 and 1
-  $w = $this->getTextWidth($size,$text);
-  // need to adjust for the number of spaces in this text
-  $words = explode(' ',$text);
-  $nspaces=count($words)-1;
-  $w += $wa*$nspaces;
-  $a = deg2rad((float)$angle);
-  return array(cos($a)*$w+$x,-sin($a)*$w+$y);
-}
-
-/**
-* wrapper function for PRVTcheckTextDirective1
-*
-* @access private
-*/
-function PRVTcheckTextDirective(&$text,$i,&$f){
-  $x=0;
-  $y=0;
-  return $this->PRVTcheckTextDirective1($text,$i,$f,0,$x,$y);
-}
-
-/**
-* checks if the text stream contains a control directive
-* if so then makes some changes and returns the number of characters involved in the directive
-* this has been re-worked to include everything neccesary to fins the current writing point, so that
-* the location can be sent to the callback function if required
-* if the directive does not require a font change, then $f should be set to 0
-*
-* @access private
-*/
-function PRVTcheckTextDirective1(&$text,$i,&$f,$final,&$x,&$y,$size=0,$angle=0,$wordSpaceAdjust=0){
-  $directive = 0;
-  $j=$i;
-  if ($text[$j]=='<'){
-    $j++;
-    switch($text[$j]){
-      case '/':
-        $j++;
-        if (strlen($text) <= $j){
-          return $directive;
-        }
-        switch($text[$j]){
-          case 'b':
-          case 'i':
-            $j++;
-            if ($text[$j]=='>'){
-              $p = strrpos($this->currentTextState,$text[$j-1]);
-              if ($p !== false){
-                // then there is one to remove
-                $this->currentTextState = substr($this->currentTextState,0,$p).substr($this->currentTextState,$p+1);
-              }
-              $directive=$j-$i+1;
-            }
-            break;
-          case 'c':
-            // this this might be a callback function
-            $j++;
-            $k = strpos($text,'>',$j);
-            if ($k!==false && $text[$j]==':'){
-              // then this will be treated as a callback directive
-              $directive = $k-$i+1;
-              $f=0;
-              // split the remainder on colons to get the function name and the paramater
-              $tmp = substr($text,$j+1,$k-$j-1);
-              $b1 = strpos($tmp,':');
-              if ($b1!==false){
-                $func = substr($tmp,0,$b1);
-                $parm = substr($tmp,$b1+1);
-              } else {
-                $func=$tmp;
-                $parm='';
-              }
-              if (!isset($func) || !strlen(trim($func))){
-                $directive=0;
-              } else {
-                // only call the function if this is the final call
-                if ($final){
-                  // need to assess the text position, calculate the text width to this point
-                  // can use getTextWidth to find the text width I think
-                  $tmp = $this->PRVTgetTextPosition($x,$y,$angle,$size,$wordSpaceAdjust,substr($text,0,$i));
-                  $info = array('x'=>$tmp[0],'y'=>$tmp[1],'angle'=>$angle,'status'=>'end','p'=>$parm,'nCallback'=>$this->nCallback);
-                  $x=$tmp[0];
-                  $y=$tmp[1];
-                  $ret = $this->$func($info);
-                  if (is_array($ret)){
-                    // then the return from the callback function could set the position, to start with, later will do font colour, and font
-                    foreach($ret as $rk=>$rv){
-                      switch($rk){
-                        case 'x':
-                        case 'y':
-                          $$rk=$rv;
-                          break;
-                      }
-                    }
-                  }
-                  // also remove from to the stack
-                  // for simplicity, just take from the end, fix this another day
-                  $this->nCallback--;
-                  if ($this->nCallback<0){
-                    $this->nCallBack=0;
-                  }
-                }
-              }
-            }
-            break;
-        }
-        break;
-      case 'b':
-      case 'i':
-        $j++;
-        if ($text[$j]=='>'){
-          $this->currentTextState.=$text[$j-1];
-          $directive=$j-$i+1;
-        }
-        break;
-      case 'C':
-        $noClose=1;
-      case 'c':
-        // this this might be a callback function
-        $j++;
-        $k = strpos($text,'>',$j);
-        if ($k!==false && $text[$j]==':'){
-          // then this will be treated as a callback directive
-          $directive = $k-$i+1;
-          $f=0;
-          // split the remainder on colons to get the function name and the paramater
-//          $bits = explode(':',substr($text,$j+1,$k-$j-1));
-          $tmp = substr($text,$j+1,$k-$j-1);
-          $b1 = strpos($tmp,':');
-          if ($b1!==false){
-            $func = substr($tmp,0,$b1);
-            $parm = substr($tmp,$b1+1);
-          } else {
-            $func=$tmp;
-            $parm='';
-          }
-          if (!isset($func) || !strlen(trim($func))){
-            $directive=0;
-          } else {
-            // only call the function if this is the final call, ie, the one actually doing printing, not measurement
-            if ($final){
-              // need to assess the text position, calculate the text width to this point
-              // can use getTextWidth to find the text width I think
-              // also add the text height and decender
-              $tmp = $this->PRVTgetTextPosition($x,$y,$angle,$size,$wordSpaceAdjust,substr($text,0,$i));
-              $info = array('x'=>$tmp[0],'y'=>$tmp[1],'angle'=>$angle,'status'=>'start','p'=>$parm,'f'=>$func,'height'=>$this->getFontHeight($size),'decender'=>$this->getFontDecender($size));
-              $x=$tmp[0];
-              $y=$tmp[1];
-              if (!isset($noClose) || !$noClose){
-                // only add to the stack if this is a small 'c', therefore is a start-stop pair
-                $this->nCallback++;
-                $info['nCallback']=$this->nCallback;
-                $this->callback[$this->nCallback]=$info;
-              }
-              $ret = $this->$func($info);
-              if (is_array($ret)){
-                // then the return from the callback function could set the position, to start with, later will do font colour, and font
-                foreach($ret as $rk=>$rv){
-                  switch($rk){
-                    case 'x':
-                    case 'y':
-                      $$rk=$rv;
-                      break;
-                  }
-                }
-              }
-            }
-          }
-        }
-        break;
-    }
-  } 
-  return $directive;
-}
-
-/**
-* add text to the document, at a specified location, size and angle on the page
-*/
-function addText($x,$y,$size,$text,$angle=0,$wordSpaceAdjust=0){
-  if (!$this->numFonts){$this->selectFont('./fonts/Helvetica');}
-
-  // if there are any open callbacks, then they should be called, to show the start of the line
-  if ($this->nCallback>0){
-    for ($i=$this->nCallback;$i>0;$i--){
-      // call each function
-      $info = array('x'=>$x,'y'=>$y,'angle'=>$angle,'status'=>'sol','p'=>$this->callback[$i]['p'],'nCallback'=>$this->callback[$i]['nCallback'],'height'=>$this->callback[$i]['height'],'decender'=>$this->callback[$i]['decender']);
-      $func = $this->callback[$i]['f'];
-      $this->$func($info);
-    }
-  }
-  if ($angle==0){
-    $this->objects[$this->currentContents]['c'].="\n".'BT '.sprintf('%.3f',$x).' '.sprintf('%.3f',$y).' Td';
-  } else {
-    $a = deg2rad((float)$angle);
-    $tmp = "\n".'BT ';
-    $tmp .= sprintf('%.3f',cos($a)).' '.sprintf('%.3f',(-1.0*sin($a))).' '.sprintf('%.3f',sin($a)).' '.sprintf('%.3f',cos($a)).' ';
-    $tmp .= sprintf('%.3f',$x).' '.sprintf('%.3f',$y).' Tm';
-    $this->objects[$this->currentContents]['c'] .= $tmp;
-  }
-  if ($wordSpaceAdjust!=0 || $wordSpaceAdjust != $this->wordSpaceAdjust){
-    $this->wordSpaceAdjust=$wordSpaceAdjust;
-    $this->objects[$this->currentContents]['c'].=' '.sprintf('%.3f',$wordSpaceAdjust).' Tw';
-  }
-  $len=strlen($text);
-  $start=0;
-  for ($i=0;$i<$len;$i++){
-    $f=1;
-    $directive = $this->PRVTcheckTextDirective($text,$i,$f);
-    if ($directive){
-      // then we should write what we need to
-      if ($i>$start){
-        $part = substr($text,$start,$i-$start);
-        $this->objects[$this->currentContents]['c'].=' /F'.$this->currentFontNum.' '.sprintf('%.1f',$size).' Tf ';
-        $this->objects[$this->currentContents]['c'].=' ('.$this->filterText($part).') Tj';
-      }
-      if ($f){
-        // then there was nothing drastic done here, restore the contents
-        $this->setCurrentFont();
-      } else {
-        $this->objects[$this->currentContents]['c'] .= ' ET';
-        $f=1;
-        $xp=$x;
-        $yp=$y;
-        $directive = $this->PRVTcheckTextDirective1($text,$i,$f,1,$xp,$yp,$size,$angle,$wordSpaceAdjust);
-        
-        // restart the text object
-          if ($angle==0){
-            $this->objects[$this->currentContents]['c'].="\n".'BT '.sprintf('%.3f',$xp).' '.sprintf('%.3f',$yp).' Td';
-          } else {
-            $a = deg2rad((float)$angle);
-            $tmp = "\n".'BT ';
-            $tmp .= sprintf('%.3f',cos($a)).' '.sprintf('%.3f',(-1.0*sin($a))).' '.sprintf('%.3f',sin($a)).' '.sprintf('%.3f',cos($a)).' ';
-            $tmp .= sprintf('%.3f',$xp).' '.sprintf('%.3f',$yp).' Tm';
-            $this->objects[$this->currentContents]['c'] .= $tmp;
-          }
-          if ($wordSpaceAdjust!=0 || $wordSpaceAdjust != $this->wordSpaceAdjust){
-            $this->wordSpaceAdjust=$wordSpaceAdjust;
-            $this->objects[$this->currentContents]['c'].=' '.sprintf('%.3f',$wordSpaceAdjust).' Tw';
-          }
-      }
-      // and move the writing point to the next piece of text
-      $i=$i+$directive-1;
-      $start=$i+1;
-    }
-    
-  }
-  if ($start<$len){
-    $part = substr($text,$start);
-    $this->objects[$this->currentContents]['c'].=' /F'.$this->currentFontNum.' '.sprintf('%.1f',$size).' Tf ';
-    $this->objects[$this->currentContents]['c'].=' ('.$this->filterText($part).') Tj';
-  }
-  $this->objects[$this->currentContents]['c'].=' ET';
-
-  // if there are any open callbacks, then they should be called, to show the end of the line
-  if ($this->nCallback>0){
-    for ($i=$this->nCallback;$i>0;$i--){
-      // call each function
-      $tmp = $this->PRVTgetTextPosition($x,$y,$angle,$size,$wordSpaceAdjust,$text);
-      $info = array('x'=>$tmp[0],'y'=>$tmp[1],'angle'=>$angle,'status'=>'eol','p'=>$this->callback[$i]['p'],'nCallback'=>$this->callback[$i]['nCallback'],'height'=>$this->callback[$i]['height'],'decender'=>$this->callback[$i]['decender']);
-      $func = $this->callback[$i]['f'];
-      $this->$func($info);
-    }
-  }
-
-}
-
-/**
-* calculate how wide a given text string will be on a page, at a given size.
-* this can be called externally, but is alse used by the other class functions
-*/
-function getTextWidth($size,$text){
-  // this function should not change any of the settings, though it will need to
-  // track any directives which change during calculation, so copy them at the start
-  // and put them back at the end.
-  $store_currentTextState = $this->currentTextState;
-
-  if (!$this->numFonts){
-    $this->selectFont('./fonts/Helvetica');
-  }
-
-  // converts a number or a float to a string so it can get the width
-  $text = "$text";
-
-  // hmm, this is where it all starts to get tricky - use the font information to
-  // calculate the width of each character, add them up and convert to user units
-  $w=0;
-  $len=strlen($text);
-  $cf = $this->currentFont;
-  for ($i=0;$i<$len;$i++){
-    $f=1;
-    $directive = $this->PRVTcheckTextDirective($text,$i,$f);
-    if ($directive){
-      if ($f){
-        $this->setCurrentFont();
-        $cf = $this->currentFont;
-      }
-      $i=$i+$directive-1;
-    } else {
-      $char=ord($text[$i]);
-      if (isset($this->fonts[$cf]['differences'][$char])){
-        // then this character is being replaced by another
-        $name = $this->fonts[$cf]['differences'][$char];
-        if (isset($this->fonts[$cf]['C'][$name]['WX'])){
-          $w+=$this->fonts[$cf]['C'][$name]['WX'];
-        }
-      } else if (isset($this->fonts[$cf]['C'][$char]['WX'])){
-        $w+=$this->fonts[$cf]['C'][$char]['WX'];
-      }
-    }
-  }
-  
-  $this->currentTextState = $store_currentTextState;
-  $this->setCurrentFont();
-
-  return $w*$size/1000;
-}
-
-/**
-* do a part of the calculation for sorting out the justification of the text
-*
-* @access private
-*/
-function PRVTadjustWrapText($text,$actual,$width,&$x,&$adjust,$justification){
-  switch ($justification){
-    case 'left':
-      return;
-      break;
-    case 'right':
-      $x+=$width-$actual;
-      break;
-    case 'center':
-    case 'centre':
-      $x+=($width-$actual)/2;
-      break;
-    case 'full':
-      // count the number of words
-      $words = explode(' ',$text);
-      $nspaces=count($words)-1;
-      if ($nspaces>0){
-        $adjust = ($width-$actual)/$nspaces;
-      } else {
-        $adjust=0;
-      }
-      break;
-  }
-}
-
-/**
-* add text to the page, but ensure that it fits within a certain width
-* if it does not fit then put in as much as possible, splitting at word boundaries
-* and return the remainder.
-* justification and angle can also be specified for the text
-*/
-function addTextWrap($x,$y,$width,$size,$text,$justification='left',$angle=0,$test=0){
-  // this will display the text, and if it goes beyond the width $width, will backtrack to the 
-  // previous space or hyphen, and return the remainder of the text.
-
-  // $justification can be set to 'left','right','center','centre','full'
-
-  // need to store the initial text state, as this will change during the width calculation
-  // but will need to be re-set before printing, so that the chars work out right
-  $store_currentTextState = $this->currentTextState;
-
-  if (!$this->numFonts){$this->selectFont('./fonts/Helvetica');}
-  if ($width<=0){
-    // error, pretend it printed ok, otherwise risking a loop
-    return '';
-  }
-  $w=0;
-  $break=0;
-  $breakWidth=0;
-  $len=strlen($text);
-  $cf = $this->currentFont;
-  $tw = $width/$size*1000;
-  for ($i=0;$i<$len;$i++){
-    $f=1;
-    $directive = $this->PRVTcheckTextDirective($text,$i,$f);
-    if ($directive){
-      if ($f){
-        $this->setCurrentFont();
-        $cf = $this->currentFont;
-      }
-      $i=$i+$directive-1;
-    } else {
-      $cOrd = ord($text[$i]);
-      if (isset($this->fonts[$cf]['differences'][$cOrd])){
-        // then this character is being replaced by another
-        $cOrd2 = $this->fonts[$cf]['differences'][$cOrd];
-      } else {
-        $cOrd2 = $cOrd;
-      }
-  
-      if (isset($this->fonts[$cf]['C'][$cOrd2]['WX'])){
-        $w+=$this->fonts[$cf]['C'][$cOrd2]['WX'];
-      }
-      if ($w>$tw){
-        // then we need to truncate this line
-        if ($break>0){
-          // then we have somewhere that we can split :)
-          if ($text[$break]==' '){
-            $tmp = substr($text,0,$break);
-          } else {
-            $tmp = substr($text,0,$break+1);
-          }
-          $adjust=0;
-          $this->PRVTadjustWrapText($tmp,$breakWidth,$width,$x,$adjust,$justification);
-
-          // reset the text state
-          $this->currentTextState = $store_currentTextState;
-          $this->setCurrentFont();
-          if (!$test){
-            $this->addText($x,$y,$size,$tmp,$angle,$adjust);
-          }
-          return substr($text,$break+1);
-        } else {
-          // just split before the current character
-          $tmp = substr($text,0,$i);
-          $adjust=0;
-          $ctmp=ord($text[$i]);
-          if (isset($this->fonts[$cf]['differences'][$ctmp])){
-            $ctmp=$this->fonts[$cf]['differences'][$ctmp];
-          }
-          $tmpw=($w-$this->fonts[$cf]['C'][$ctmp]['WX'])*$size/1000;
-          $this->PRVTadjustWrapText($tmp,$tmpw,$width,$x,$adjust,$justification);
-          // reset the text state
-          $this->currentTextState = $store_currentTextState;
-          $this->setCurrentFont();
-          if (!$test){
-            $this->addText($x,$y,$size,$tmp,$angle,$adjust);
-          }
-          return substr($text,$i);
-        }
-      }
-      if ($text[$i]=='-'){
-        $break=$i;
-        $breakWidth = $w*$size/1000;
-      }
-      if ($text[$i]==' '){
-        $break=$i;
-        $ctmp=ord($text[$i]);
-        if (isset($this->fonts[$cf]['differences'][$ctmp])){
-          $ctmp=$this->fonts[$cf]['differences'][$ctmp];
-        }
-        $breakWidth = ($w-$this->fonts[$cf]['C'][$ctmp]['WX'])*$size/1000;
-      }
-    }
-  }
-  // then there was no need to break this line
-  if ($justification=='full'){
-    $justification='left';
-  }
-  $adjust=0;
-  $tmpw=$w*$size/1000;
-  $this->PRVTadjustWrapText($text,$tmpw,$width,$x,$adjust,$justification);
-  // reset the text state
-  $this->currentTextState = $store_currentTextState;
-  $this->setCurrentFont();
-  if (!$test){
-    $this->addText($x,$y,$size,$text,$angle,$adjust,$angle);
-  }
-  return '';
-}
-
-/**
-* this will be called at a new page to return the state to what it was on the 
-* end of the previous page, before the stack was closed down
-* This is to get around not being able to have open 'q' across pages
-*
-*/
-function saveState($pageEnd=0){
-  if ($pageEnd){
-    // this will be called at a new page to return the state to what it was on the 
-    // end of the previous page, before the stack was closed down
-    // This is to get around not being able to have open 'q' across pages
-    $opt = $this->stateStack[$pageEnd]; // ok to use this as stack starts numbering at 1
-    $this->setColor($opt['col']['r'],$opt['col']['g'],$opt['col']['b'],1);
-    $this->setStrokeColor($opt['str']['r'],$opt['str']['g'],$opt['str']['b'],1);
-    $this->objects[$this->currentContents]['c'].="\n".$opt['lin'];
-//    $this->currentLineStyle = $opt['lin'];
-  } else {
-    $this->nStateStack++;
-    $this->stateStack[$this->nStateStack]=array(
-      'col'=>$this->currentColour
-     ,'str'=>$this->currentStrokeColour
-     ,'lin'=>$this->currentLineStyle
-    );
-  }
-  $this->objects[$this->currentContents]['c'].="\nq";
-}
-
-/**
-* restore a previously saved state
-*/
-function restoreState($pageEnd=0){
-  if (!$pageEnd){
-    $n = $this->nStateStack;
-    $this->currentColour = $this->stateStack[$n]['col'];
-    $this->currentStrokeColour = $this->stateStack[$n]['str'];
-    $this->objects[$this->currentContents]['c'].="\n".$this->stateStack[$n]['lin'];
-    $this->currentLineStyle = $this->stateStack[$n]['lin'];
-    unset($this->stateStack[$n]);
-    $this->nStateStack--;
-  }
-  $this->objects[$this->currentContents]['c'].="\nQ";
-}
-
-/**
-* make a loose object, the output will go into this object, until it is closed, then will revert to
-* the current one.
-* this object will not appear until it is included within a page.
-* the function will return the object number
-*/
-function openObject(){
-  $this->nStack++;
-  $this->stack[$this->nStack]=array('c'=>$this->currentContents,'p'=>$this->currentPage);
-  // add a new object of the content type, to hold the data flow
-  $this->numObj++;
-  $this->o_contents($this->numObj,'new');
-  $this->currentContents=$this->numObj;
-  $this->looseObjects[$this->numObj]=1;
-  
-  return $this->numObj;
-}
-
-/**
-* open an existing object for editing
-*/
-function reopenObject($id){
-   $this->nStack++;
-   $this->stack[$this->nStack]=array('c'=>$this->currentContents,'p'=>$this->currentPage);
-   $this->currentContents=$id;
-   // also if this object is the primary contents for a page, then set the current page to its parent
-   if (isset($this->objects[$id]['onPage'])){
-     $this->currentPage = $this->objects[$id]['onPage'];
-   }
-}
-
-/**
-* close an object
-*/
-function closeObject(){
-  // close the object, as long as there was one open in the first place, which will be indicated by
-  // an objectId on the stack.
-  if ($this->nStack>0){
-    $this->currentContents=$this->stack[$this->nStack]['c'];
-    $this->currentPage=$this->stack[$this->nStack]['p'];
-    $this->nStack--;
-    // easier to probably not worry about removing the old entries, they will be overwritten
-    // if there are new ones.
-  }
-}
-
-/**
-* stop an object from appearing on pages from this point on
-*/
-function stopObject($id){
-  // if an object has been appearing on pages up to now, then stop it, this page will
-  // be the last one that could contian it.
-  if (isset($this->addLooseObjects[$id])){
-    $this->addLooseObjects[$id]='';
-  }
-}
-
-/**
-* after an object has been created, it wil only show if it has been added, using this function.
-*/
-function addObject($id,$options='add'){
-  // add the specified object to the page
-  if (isset($this->looseObjects[$id]) && $this->currentContents!=$id){
-    // then it is a valid object, and it is not being added to itself
-    switch($options){
-      case 'all':
-        // then this object is to be added to this page (done in the next block) and 
-        // all future new pages. 
-        $this->addLooseObjects[$id]='all';
-      case 'add':
-        if (isset($this->objects[$this->currentContents]['onPage'])){
-          // then the destination contents is the primary for the page
-          // (though this object is actually added to that page)
-          $this->o_page($this->objects[$this->currentContents]['onPage'],'content',$id);
-        }
-        break;
-      case 'even':
-        $this->addLooseObjects[$id]='even';
-        $pageObjectId=$this->objects[$this->currentContents]['onPage'];
-        if ($this->objects[$pageObjectId]['info']['pageNum']%2==0){
-          $this->addObject($id); // hacky huh :)
-        }
-        break;
-      case 'odd':
-        $this->addLooseObjects[$id]='odd';
-        $pageObjectId=$this->objects[$this->currentContents]['onPage'];
-        if ($this->objects[$pageObjectId]['info']['pageNum']%2==1){
-          $this->addObject($id); // hacky huh :)
-        }
-        break;
-      case 'next':
-        $this->addLooseObjects[$id]='all';
-        break;
-      case 'nexteven':
-        $this->addLooseObjects[$id]='even';
-        break;
-      case 'nextodd':
-        $this->addLooseObjects[$id]='odd';
-        break;
-    }
-  }
-}
-
-/**
-* add content to the documents info object
-*/
-function addInfo($label,$value=0){
-  // this will only work if the label is one of the valid ones.
-  // modify this so that arrays can be passed as well.
-  // if $label is an array then assume that it is key=>value pairs
-  // else assume that they are both scalar, anything else will probably error
-  if (is_array($label)){
-    foreach ($label as $l=>$v){
-      $this->o_info($this->infoObject,$l,$v);
-    }
-  } else {
-    $this->o_info($this->infoObject,$label,$value);
-  }
-}
-
-/**
-* set the viewer preferences of the document, it is up to the browser to obey these.
-*/
-function setPreferences($label,$value=0){
-  // this will only work if the label is one of the valid ones.
-  if (is_array($label)){
-    foreach ($label as $l=>$v){
-      $this->o_catalog($this->catalogId,'viewerPreferences',array($l=>$v));
-    }
-  } else {
-    $this->o_catalog($this->catalogId,'viewerPreferences',array($label=>$value));
-  }
-}
-
-/**
-* extract an integer from a position in a byte stream
-*
-* @access private
-*/
-function PRVT_getBytes(&$data,$pos,$num){
-  // return the integer represented by $num bytes from $pos within $data
-  $ret=0;
-  for ($i=0;$i<$num;$i++){
-    $ret=$ret*256;
-    $ret+=ord($data[$pos+$i]);
-  }
-  return $ret;
-}
-
-/**
-* add a PNG image into the document, from a file
-* this should work with remote files
-*/
-function addPngFromFile($file,$x,$y,$w=0,$h=0){
-  // read in a png file, interpret it, then add to the system
-  $error=0;
-  $tmp = get_magic_quotes_runtime();
-  set_magic_quotes_runtime(0);
-  $fp = @fopen($file,'rb');
-  if ($fp){
-    $data='';
-    while(!feof($fp)){
-      $data .= fread($fp,1024);
-    }
-    fclose($fp);
-  } else {
-    $error = 1;
-    $errormsg = 'trouble opening file: '.$file;
-  }
-  set_magic_quotes_runtime($tmp);
-  
-  if (!$error){
-    $header = chr(137).chr(80).chr(78).chr(71).chr(13).chr(10).chr(26).chr(10);
-    if (substr($data,0,8)!=$header){
-      $error=1;
-      $errormsg = 'this file does not have a valid header';
-    }
-  }
-
-  if (!$error){
-    // set pointer
-    $p = 8;
-    $len = strlen($data);
-    // cycle through the file, identifying chunks
-    $haveHeader=0;
-    $info=array();
-    $idata='';
-    $pdata='';
-    while ($p<$len){
-      $chunkLen = $this->PRVT_getBytes($data,$p,4);
-      $chunkType = substr($data,$p+4,4);
-//      echo $chunkType.' - '.$chunkLen.'<br>';
-    
-      switch($chunkType){
-        case 'IHDR':
-          // this is where all the file information comes from
-          $info['width']=$this->PRVT_getBytes($data,$p+8,4);
-          $info['height']=$this->PRVT_getBytes($data,$p+12,4);
-          $info['bitDepth']=ord($data[$p+16]);
-          $info['colorType']=ord($data[$p+17]);
-          $info['compressionMethod']=ord($data[$p+18]);
-          $info['filterMethod']=ord($data[$p+19]);
-          $info['interlaceMethod']=ord($data[$p+20]);
-//print_r($info);
-          $haveHeader=1;
-          if ($info['compressionMethod']!=0){
-            $error=1;
-            $errormsg = 'unsupported compression method';
-          }
-          if ($info['filterMethod']!=0){
-            $error=1;
-            $errormsg = 'unsupported filter method';
-          }
-          break;
-        case 'PLTE':
-          $pdata.=substr($data,$p+8,$chunkLen);
-          break;
-        case 'IDAT':
-          $idata.=substr($data,$p+8,$chunkLen);
-          break;
-        case 'tRNS': 
-          //this chunk can only occur once and it must occur after the PLTE chunk and before IDAT chunk 
-          //print "tRNS found, color type = ".$info['colorType']."<BR>"; 
-          $transparency = array();
-          if ($info['colorType'] == 3) { // indexed color, rbg 
-          /* corresponding to entries in the plte chunk 
-          Alpha for palette index 0: 1 byte 
-          Alpha for palette index 1: 1 byte 
-          ...etc... 
-          */ 
-            // there will be one entry for each palette entry. up until the last non-opaque entry.
-            // set up an array, stretching over all palette entries which will be o (opaque) or 1 (transparent)
-            $transparency['type']='indexed';
-            $numPalette = strlen($pdata)/3;
-            $trans=0;
-            for ($i=$chunkLen;$i>=0;$i--){
-              if (ord($data[$p+8+$i])==0){
-                $trans=$i;
-              }
-            }
-            $transparency['data'] = $trans;
-            
-          } elseif($info['colorType'] == 0) { // grayscale 
-          /* corresponding to entries in the plte chunk 
-          Gray: 2 bytes, range 0 .. (2^bitdepth)-1 
-          */ 
-//            $transparency['grayscale']=$this->PRVT_getBytes($data,$p+8,2); // g = grayscale 
-            $transparency['type']='indexed';
-            $transparency['data'] = ord($data[$p+8+1]);
-          
-          } elseif($info['colorType'] == 2) { // truecolor 
-          /* corresponding to entries in the plte chunk 
-          Red: 2 bytes, range 0 .. (2^bitdepth)-1 
-          Green: 2 bytes, range 0 .. (2^bitdepth)-1 
-          Blue: 2 bytes, range 0 .. (2^bitdepth)-1 
-          */ 
-            $transparency['r']=$this->PRVT_getBytes($data,$p+8,2); // r from truecolor 
-            $transparency['g']=$this->PRVT_getBytes($data,$p+10,2); // g from truecolor 
-            $transparency['b']=$this->PRVT_getBytes($data,$p+12,2); // b from truecolor 
-          
-          } else { 
-          //unsupported transparency type 
-          } 
-          // KS End new code 
-          break; 
-        default:
-          break;
-      }
-    
-      $p += $chunkLen+12;
-    }
-    
-    if(!$haveHeader){
-      $error = 1;
-      $errormsg = 'information header is missing';
-    }
-    if (isset($info['interlaceMethod']) && $info['interlaceMethod']){
-      $error = 1;
-      $errormsg = 'There appears to be no support for interlaced images in pdf.';
-    }
-  }
-
-  if (!$error && $info['bitDepth'] > 8){
-    $error = 1;
-    $errormsg = 'only bit depth of 8 or less is supported';
-  }
-
-  if (!$error){
-    if ($info['colorType']!=2 && $info['colorType']!=0 && $info['colorType']!=3){
-      $error = 1;
-      $errormsg = 'transparancey alpha channel not supported, transparency only supported for palette images.';
-    } else {
-      switch ($info['colorType']){
-        case 3:
-          $color = 'DeviceRGB';
-          $ncolor=1;
-          break;
-        case 2:
-          $color = 'DeviceRGB';
-          $ncolor=3;
-          break;
-        case 0:
-          $color = 'DeviceGray';
-          $ncolor=1;
-          break;
-      }
-    }
-  }
-  if ($error){
-    $this->addMessage('PNG error - ('.$file.') '.$errormsg);
-    return;
-  }
-  if ($w==0){
-    $w=$h/$info['height']*$info['width'];
-  }
-  if ($h==0){
-    $h=$w*$info['height']/$info['width'];
-  }
-//print_r($info);
-  // so this image is ok... add it in.
-  $this->numImages++;
-  $im=$this->numImages;
-  $label='I'.$im;
-  $this->numObj++;
-//  $this->o_image($this->numObj,'new',array('label'=>$label,'data'=>$idata,'iw'=>$w,'ih'=>$h,'type'=>'png','ic'=>$info['width']));
-  $options = array('label'=>$label,'data'=>$idata,'bitsPerComponent'=>$info['bitDepth'],'pdata'=>$pdata
-                                      ,'iw'=>$info['width'],'ih'=>$info['height'],'type'=>'png','color'=>$color,'ncolor'=>$ncolor);
-  if (isset($transparency)){
-    $options['transparency']=$transparency;
-  }
-  $this->o_image($this->numObj,'new',$options);
-
-  $this->objects[$this->currentContents]['c'].="\nq";
-  $this->objects[$this->currentContents]['c'].="\n".sprintf('%.3f',$w)." 0 0 ".sprintf('%.3f',$h)." ".sprintf('%.3f',$x)." ".sprintf('%.3f',$y)." cm";
-  $this->objects[$this->currentContents]['c'].="\n/".$label.' Do';
-  $this->objects[$this->currentContents]['c'].="\nQ";
-}
-
-/**
-* add a JPEG image into the document, from a file
-*/
-function addJpegFromFile($img,$x,$y,$w=0,$h=0){
-  // attempt to add a jpeg image straight from a file, using no GD commands
-  // note that this function is unable to operate on a remote file.
-
-  if (!file_exists($img)){
-    return;
-  }
-
-  $tmp=getimagesize($img);
-  $imageWidth=$tmp[0];
-  $imageHeight=$tmp[1];
-
-  if (isset($tmp['channels'])){
-    $channels = $tmp['channels'];
-  } else {
-    $channels = 3;
-  }
-
-  if ($w<=0 && $h<=0){
-    $w=$imageWidth;
-  }
-  if ($w==0){
-    $w=$h/$imageHeight*$imageWidth;
-  }
-  if ($h==0){
-    $h=$w*$imageHeight/$imageWidth;
-  }
-
-  $fp=fopen($img,'rb');
-
-  $tmp = get_magic_quotes_runtime();
-  set_magic_quotes_runtime(0);
-  $data = fread($fp,filesize($img));
-  set_magic_quotes_runtime($tmp);
-  
-  fclose($fp);
-
-  $this->addJpegImage_common($data,$x,$y,$w,$h,$imageWidth,$imageHeight,$channels);
-}
-
-/**
-* add an image into the document, from a GD object
-* this function is not all that reliable, and I would probably encourage people to use 
-* the file based functions
-*/
-function addImage(&$img,$x,$y,$w=0,$h=0,$quality=75){
-  // add a new image into the current location, as an external object
-  // add the image at $x,$y, and with width and height as defined by $w & $h
-  
-  // note that this will only work with full colour images and makes them jpg images for display
-  // later versions could present lossless image formats if there is interest.
-  
-  // there seems to be some problem here in that images that have quality set above 75 do not appear
-  // not too sure why this is, but in the meantime I have restricted this to 75.  
-  if ($quality>75){
-    $quality=75;
-  }
-
-  // if the width or height are set to zero, then set the other one based on keeping the image
-  // height/width ratio the same, if they are both zero, then give up :)
-  $imageWidth=imagesx($img);
-  $imageHeight=imagesy($img);
-  
-  if ($w<=0 && $h<=0){
-    return;
-  }
-  if ($w==0){
-    $w=$h/$imageHeight*$imageWidth;
-  }
-  if ($h==0){
-    $h=$w*$imageHeight/$imageWidth;
-  }
-  
-  // gotta get the data out of the img..
-
-  // so I write to a temp file, and then read it back.. soo ugly, my apologies.
-  $tmpDir='/tmp';
-  $tmpName=tempnam($tmpDir,'img');
-  imagejpeg($img,$tmpName,$quality);
-  $fp=fopen($tmpName,'rb');
-
-  $tmp = get_magic_quotes_runtime();
-  set_magic_quotes_runtime(0);
-  $fp = @fopen($tmpName,'rb');
-  if ($fp){
-    $data='';
-    while(!feof($fp)){
-      $data .= fread($fp,1024);
-    }
-    fclose($fp);
-  } else {
-    $error = 1;
-    $errormsg = 'trouble opening file';
-  }
-//  $data = fread($fp,filesize($tmpName));
-  set_magic_quotes_runtime($tmp);
-//  fclose($fp);
-  unlink($tmpName);
-  $this->addJpegImage_common($data,$x,$y,$w,$h,$imageWidth,$imageHeight);
-}
-
-/**
-* common code used by the two JPEG adding functions
-*
-* @access private
-*/
-function addJpegImage_common(&$data,$x,$y,$w=0,$h=0,$imageWidth,$imageHeight,$channels=3){
-  // note that this function is not to be called externally
-  // it is just the common code between the GD and the file options
-  $this->numImages++;
-  $im=$this->numImages;
-  $label='I'.$im;
-  $this->numObj++;
-  $this->o_image($this->numObj,'new',array('label'=>$label,'data'=>$data,'iw'=>$imageWidth,'ih'=>$imageHeight,'channels'=>$channels));
-
-  $this->objects[$this->currentContents]['c'].="\nq";
-  $this->objects[$this->currentContents]['c'].="\n".sprintf('%.3f',$w)." 0 0 ".sprintf('%.3f',$h)." ".sprintf('%.3f',$x)." ".sprintf('%.3f',$y)." cm";
-  $this->objects[$this->currentContents]['c'].="\n/".$label.' Do';
-  $this->objects[$this->currentContents]['c'].="\nQ";
-}
-
-/**
-* specify where the document should open when it first starts
-*/
-function openHere($style,$a=0,$b=0,$c=0){
-  // this function will open the document at a specified page, in a specified style
-  // the values for style, and the required paramters are:
-  // 'XYZ'  left, top, zoom
-  // 'Fit'
-  // 'FitH' top
-  // 'FitV' left
-  // 'FitR' left,bottom,right
-  // 'FitB'
-  // 'FitBH' top
-  // 'FitBV' left
-  $this->numObj++;
-  $this->o_destination($this->numObj,'new',array('page'=>$this->currentPage,'type'=>$style,'p1'=>$a,'p2'=>$b,'p3'=>$c));
-  $id = $this->catalogId;
-  $this->o_catalog($id,'openHere',$this->numObj);
-}
-
-/**
-* create a labelled destination within the document
-*/
-function addDestination($label,$style,$a=0,$b=0,$c=0){
-  // associates the given label with the destination, it is done this way so that a destination can be specified after
-  // it has been linked to
-  // styles are the same as the 'openHere' function
-  $this->numObj++;
-  $this->o_destination($this->numObj,'new',array('page'=>$this->currentPage,'type'=>$style,'p1'=>$a,'p2'=>$b,'p3'=>$c));
-  $id = $this->numObj;
-  // store the label->idf relationship, note that this means that labels can be used only once
-  $this->destinations["$label"]=$id;
-}
-
-/**
-* define font families, this is used to initialize the font families for the default fonts
-* and for the user to add new ones for their fonts. The default bahavious can be overridden should
-* that be desired.
-*/
-function setFontFamily($family,$options=''){
-  if (!is_array($options)){
-    if ($family=='init'){
-      // set the known family groups
-      // these font families will be used to enable bold and italic markers to be included
-      // within text streams. html forms will be used... <b></b> <i></i>
-      $this->fontFamilies['Helvetica.afm']=array(
-         'b'=>'Helvetica-Bold.afm'
-        ,'i'=>'Helvetica-Oblique.afm'
-        ,'bi'=>'Helvetica-BoldOblique.afm'
-        ,'ib'=>'Helvetica-BoldOblique.afm'
-      );
-      $this->fontFamilies['Courier.afm']=array(
-         'b'=>'Courier-Bold.afm'
-        ,'i'=>'Courier-Oblique.afm'
-        ,'bi'=>'Courier-BoldOblique.afm'
-        ,'ib'=>'Courier-BoldOblique.afm'
-      );
-      $this->fontFamilies['Times-Roman.afm']=array(
-         'b'=>'Times-Bold.afm'
-        ,'i'=>'Times-Italic.afm'
-        ,'bi'=>'Times-BoldItalic.afm'
-        ,'ib'=>'Times-BoldItalic.afm'
-      );
-    }
-  } else {
-    // the user is trying to set a font family
-    // note that this can also be used to set the base ones to something else
-    if (strlen($family)){
-      $this->fontFamilies[$family] = $options;
-    }
-  }
-}
-
-/**
-* used to add messages for use in debugging
-*/
-function addMessage($message){
-  $this->messages.=$message."\n";
-}
-
-/**
-* a few functions which should allow the document to be treated transactionally.
+* phase is a modifier on the dash pattern which is used to shift the point at which the pattern starts.
 */
-function transaction($action){
-  switch ($action){
-    case 'start':
-      // store all the data away into the checkpoint variable
-      $data = get_object_vars($this);
-      $this->checkpoint = $data;
-      unset($data);
-      break;
-    case 'commit':
-      if (is_array($this->checkpoint) && isset($this->checkpoint['checkpoint'])){
-        $tmp = $this->checkpoint['checkpoint'];
-        $this->checkpoint = $tmp;
-        unset($tmp);
-      } else {
-        $this->checkpoint='';
-      }
-      break;
-    case 'rewind':
-      // do not destroy the current checkpoint, but move us back to the state then, so that we can try again
-      if (is_array($this->checkpoint)){
-        // can only abort if were inside a checkpoint
-        $tmp = $this->checkpoint;
-        foreach ($tmp as $k=>$v){
-          if ($k != 'checkpoint'){
-            $this->$k=$v;
-          }
-        }
-        unset($tmp);
-      }
-      break;
-    case 'abort':
-      if (is_array($this->checkpoint)){
-        // can only abort if were inside a checkpoint
-        $tmp = $this->checkpoint;
-        foreach ($tmp as $k=>$v){
-          $this->$k=$v;
-        }
-        unset($tmp);
-      }
-      break;
-  }
+       function setLineStyle($width=1,$cap='',$join='',$dash='',$phase=0)
+       {
+               $this->SetLineWidth($width);
+       }
 
-}
+       function Text($x, $y, $txt, $stroke=0, $clip=false)
+       {
+               TCPDF::Text($x,$y, TCPDF::unhtmlentities($txt), $stroke, $clip);
+       }
 
 } // end of class