Location: PHPKode > projects > PHP Pdf creation > pdf-php/class.ezpdf.php
<?php

include_once('class.pdf.php');

class Cezpdf extends Cpdf {
//==============================================================================
// this class will take the basic interaction facilities of the Cpdf class
// and make more useful functions so that the user does not have to 
// know all the ins and outs of pdf presentation to produce something pretty.
//
// IMPORTANT NOTE
// there is no warranty, implied or otherwise with this software.
// 
// version 009 (versioning is linked to class.pdf.php)
//
// released under a public domain licence.
//
// Wayne Munro, R&OS Ltd, http://www.ros.co.nz/pdf
//==============================================================================

var $ez=array('fontSize'=>10); // used for storing most of the page configuration parameters
var $y; // this is the current vertical positon on the page of the writing point, very important
var $ezPages=array(); // keep an array of the ids of the pages, making it easy to go back and add page numbers etc.
var $ezPageCount=0;

// Background color and image stuff added
var $bg_UseSameFile = true;
var $bg_files = array(); /* array('blank.png'=>array('obj'=>8)) */
var $bg_type;
var $bg_color = array();
var $bg_img;
var $bg_img_width;
var $bg_img_height;
var $bg_img_xpos;
var $bg_img_ypos;
var $bg_img_type;
var $bg_img_types_jpg = array('jpg', 'jpeg', 'pjpg', 'pjpeg');
var $bg_img_types_png = array('png');

// ------------------------------------------------------------------------------
function Cezpdf($paper='a4',$orientation='portrait', $type = 'none', $options = array()){
    /****************************************
     *   $type        : { 'none' | 'color' | 'colour' | 'image' }
     *   $options     : if type == 'color' or 'colour':
     *                    $options[0] = red-component   of backgroundcolour ( 0 <= r <= 1)
     *                    $options[1] = green-component of backgroundcolour ( 0 <= g <= 1)
     *                    $options[2] = blue-component  of backgroundcolour ( 0 <= b <= 1)
     *                  if type == 'image':
     *                    $options['img']    = location of image file; URI's are allowed if allow_url_open is enabled in php.ini
     *                    $options['width']  = width of background image; default is width of page
     *                    $options['height'] = height of background image; default is height of page
     *                    $options['xpos']   = horizontal position of background image; default is 0
     *                    $options['ypos']   = vertical position of background image; default is 0
     ****************************************/

	// Assuming that people don't want to specify the paper size using the absolute coordinates
	// allow a couple of options:
	// orientation can be 'portrait' or 'landscape'
	// or, to actually set the coordinates, then pass an array in as the first parameter.
	// the defaults are as shown.
	// 
	// -------------------------
	// 2002-07-24 - Nicola Asuni (hide@address.com):
	// Added new page formats (45 standard ISO paper formats and 4 american common formats)
	// paper cordinates are calculated in this way: (inches * 72) where 1 inch = 2.54 cm
	// 
	// Now you may also pass a 2 values array containing the page width and height in centimeters
	// -------------------------

	if (!is_array($paper)){
		switch (strtoupper($paper)){
			case '4A0': {$size = array(0,0,4767.87,6740.79); break;}
			case '2A0': {$size = array(0,0,3370.39,4767.87); break;}
			case 'A0': {$size = array(0,0,2383.94,3370.39); break;}
			case 'A1': {$size = array(0,0,1683.78,2383.94); break;}
			case 'A2': {$size = array(0,0,1190.55,1683.78); break;}
			case 'A3': {$size = array(0,0,841.89,1190.55); break;}
			case 'A4': default: {$size = array(0,0,595.28,841.89); break;}
			case 'A5': {$size = array(0,0,419.53,595.28); break;}
			case 'A6': {$size = array(0,0,297.64,419.53); break;}
			case 'A7': {$size = array(0,0,209.76,297.64); break;}
			case 'A8': {$size = array(0,0,147.40,209.76); break;}
			case 'A9': {$size = array(0,0,104.88,147.40); break;}
			case 'A10': {$size = array(0,0,73.70,104.88); break;}
			case 'B0': {$size = array(0,0,2834.65,4008.19); break;}
			case 'B1': {$size = array(0,0,2004.09,2834.65); break;}
			case 'B2': {$size = array(0,0,1417.32,2004.09); break;}
			case 'B3': {$size = array(0,0,1000.63,1417.32); break;}
			case 'B4': {$size = array(0,0,708.66,1000.63); break;}
			case 'B5': {$size = array(0,0,498.90,708.66); break;}
			case 'B6': {$size = array(0,0,354.33,498.90); break;}
			case 'B7': {$size = array(0,0,249.45,354.33); break;}
			case 'B8': {$size = array(0,0,175.75,249.45); break;}
			case 'B9': {$size = array(0,0,124.72,175.75); break;}
			case 'B10': {$size = array(0,0,87.87,124.72); break;}
			case 'C0': {$size = array(0,0,2599.37,3676.54); break;}
			case 'C1': {$size = array(0,0,1836.85,2599.37); break;}
			case 'C2': {$size = array(0,0,1298.27,1836.85); break;}
			case 'C3': {$size = array(0,0,918.43,1298.27); break;}
			case 'C4': {$size = array(0,0,649.13,918.43); break;}
			case 'C5': {$size = array(0,0,459.21,649.13); break;}
			case 'C6': {$size = array(0,0,323.15,459.21); break;}
			case 'C7': {$size = array(0,0,229.61,323.15); break;}
			case 'C8': {$size = array(0,0,161.57,229.61); break;}
			case 'C9': {$size = array(0,0,113.39,161.57); break;}
			case 'C10': {$size = array(0,0,79.37,113.39); break;}
			case 'RA0': {$size = array(0,0,2437.80,3458.27); break;}
			case 'RA1': {$size = array(0,0,1729.13,2437.80); break;}
			case 'RA2': {$size = array(0,0,1218.90,1729.13); break;}
			case 'RA3': {$size = array(0,0,864.57,1218.90); break;}
			case 'RA4': {$size = array(0,0,609.45,864.57); break;}
			case 'SRA0': {$size = array(0,0,2551.18,3628.35); break;}
			case 'SRA1': {$size = array(0,0,1814.17,2551.18); break;}
			case 'SRA2': {$size = array(0,0,1275.59,1814.17); break;}
			case 'SRA3': {$size = array(0,0,907.09,1275.59); break;}
			case 'SRA4': {$size = array(0,0,637.80,907.09); break;}
			case 'LETTER': {$size = array(0,0,612.00,792.00); break;}
			case 'LEGAL': {$size = array(0,0,612.00,1008.00); break;}
			case 'EXECUTIVE': {$size = array(0,0,521.86,756.00); break;}
			case 'FOLIO': {$size = array(0,0,612.00,936.00); break;}
		}
		switch (strtolower($orientation)){
			case 'landscape':
				$a=$size[3];
				$size[3]=$size[2];
				$size[2]=$a;
				break;
		}
	} else {
		if (count($paper)>2) {
			// then an array was sent it to set the size
			$size = $paper;
		}
		else { //size in centimeters has been passed
			$size[0] = 0;
			$size[1] = 0;
			$size[2] = ( $paper[0] / 2.54 ) * 72;
			$size[3] = ( $paper[1] / 2.54 ) * 72;
		}
	}
	$this->Cpdf($size);
	$this->ez['pageWidth']=$size[2];
	$this->ez['pageHeight']=$size[3];
	
	// also set the margins to some reasonable defaults
	$this->ez['topMargin']=30;
	$this->ez['bottomMargin']=30;
	$this->ez['leftMargin']=30;
	$this->ez['rightMargin']=30;
	
	// set the current writing position to the top of the first page
	$this->y = $this->ez['pageHeight']-$this->ez['topMargin'];
	// and get the ID of the page that was created during the instancing process.
	$this->ezPages[1]=$this->getFirstPageId();
	$this->ezPageCount=1;

	switch ($type)
	  {
	    case 'color'  :
	    case 'colour' :
            $this->bg_type = 'colour';
            $this->saveState();
            if (is_float($options[0]) && is_float($options[1]) && is_float($options[2]))
            {
              $this->bg_color = $options;
              $this->setColor($this->bg_color[0], $this->bg_color[1], $this->bg_color[2], 1);
            }
            else
              $this->bg_color = array(1, 1, 1);
            $this->filledRectangle(0, 0, $this->ez['pageWidth'], $this->ez['pageHeight']);
            $this->restoreState();
            break;
	    case 'image'  :
            $this->bg_type = 'image';
            if (isset($options['img']))
            {
              $bg_img_types = array_merge($this->bg_img_types_jpg, $this->bg_img_types_png);
              $bg_img_ext = strtolower(substr($options['img'], strpos($options['img'], '.') + 1));

              if (is_array($this->bg_img_types_jpg) && in_array($bg_img_ext, $this->bg_img_types_jpg))
                $this->bg_img_type = 'jpg';
              else if (is_array($this->bg_img_types_png) && in_array($bg_img_ext, $this->bg_img_types_png))
                $this->bg_img_type = 'png';
              else
                $this->bg_img_type = NULL;
            }
            else
              $this->bg_img_type = NULL;

            // Don't continue if image does not exist, or if image has a wrong type
            if (!isset($options['img']) || (!isset($this->bg_img_type)) || !file_exists($options['img']))
            {
            if (!file_exists($options['img']))
              $errormsg="Background Image '".$options['img']."' does not exists";
              $this->bg_type = 'none';
              break;
            }
            $this->bg_img = $options['img'];
            if (is_numeric($options['width']))  $this->bg_img_width  = $options['width'];  else $this->bg_img_width  = $this->ez['pageWidth'];
            if (is_numeric($options['height'])) $this->bg_img_height = $options['height']; else $this->bg_img_height = $this->ez['pageHeight'];
            if (is_numeric($options['xpos']))   $this->bg_img_xpos   = $options['xpos'];   else $this->bg_img_xpos   = 0;
            if (is_numeric($options['ypos']))   $this->bg_img_ypos   = $options['ypos'];   else $this->bg_img_ypos   = 0;
            switch ($this->bg_img_type)
            {
              case 'jpg' : $this->addJpegFromFile($this->bg_img, $this->bg_img_xpos, $this->bg_img_ypos, $this->bg_img_width, $this->bg_img_height); break;
              case 'png' : $this->addPngFromFile($this->bg_img, $this->bg_img_xpos, $this->bg_img_ypos, $this->bg_img_width, $this->bg_img_height);  break;
            }
            break;
	    case 'none'   :
	    default      :
            $this->bg_type = 'none';
            break;
	  }
}

// ------------------------------------------------------------------------------
// 2002-07-24: Nicola Asuni (hide@address.com)
// Set Margins in centimeters
function ezSetCmMargins($top,$bottom,$left,$right){
	$top = ( $top / 2.54 ) * 72;
	$bottom = ( $bottom / 2.54 ) * 72;
	$left = ( $left / 2.54 ) * 72;
	$right = ( $right / 2.54 ) * 72;
	$this->ezSetMargins($top,$bottom,$left,$right);
}
// ------------------------------------------------------------------------------


function ezColumnsStart($options=array()){
  // start from the current y-position, make the set number of columne
  if (isset($this->ez['columns']) && $this->ez['columns']==1){
    // if we are already in a column mode then just return.
    return;
  }
  $def=array('gap'=>10,'num'=>2);
  foreach($def as $k=>$v){
    if (!isset($options[$k])){
      $options[$k]=$v;
    }
  }
  // setup the columns
  $this->ez['columns']=array('on'=>1,'colNum'=>1);

  // store the current margins
  $this->ez['columns']['margins']=array(
     $this->ez['leftMargin']
    ,$this->ez['rightMargin']
    ,$this->ez['topMargin']
    ,$this->ez['bottomMargin']
  );
  // and store the settings for the columns
  $this->ez['columns']['options']=$options;
  // then reset the margins to suit the new columns
  // safe enough to assume the first column here, but start from the current y-position
  $this->ez['topMargin']=$this->ez['pageHeight']-$this->y;
  $width=($this->ez['pageWidth']-$this->ez['leftMargin']-$this->ez['rightMargin']-($options['num']-1)*$options['gap'])/$options['num'];
  $this->ez['columns']['width']=$width;
  $this->ez['rightMargin']=$this->ez['pageWidth']-$this->ez['leftMargin']-$width;
  
}
// ------------------------------------------------------------------------------
function ezColumnsStop(){
  if (isset($this->ez['columns']) && $this->ez['columns']['on']==1){
    $this->ez['columns']['on']=0;
    $this->ez['leftMargin']=$this->ez['columns']['margins'][0];
    $this->ez['rightMargin']=$this->ez['columns']['margins'][1];
    $this->ez['topMargin']=$this->ez['columns']['margins'][2];
    $this->ez['bottomMargin']=$this->ez['columns']['margins'][3];
  }
}
// ------------------------------------------------------------------------------
function ezInsertMode($status=1,$pageNum=1,$pos='before'){
  // puts the document into insert mode. new pages are inserted until this is re-called with status=0
  // by default pages wil be inserted at the start of the document
  switch($status){
    case '1':
      if (isset($this->ezPages[$pageNum])){
        $this->ez['insertMode']=1;
        $this->ez['insertOptions']=array('id'=>$this->ezPages[$pageNum],'pos'=>$pos);
      }
      break;
    case '0':
      $this->ez['insertMode']=0;
      break;
  }
}
// ------------------------------------------------------------------------------

function ezNewPage(){
  $pageRequired=1;
  if (isset($this->ez['columns']) && $this->ez['columns']['on']==1){
    // check if this is just going to a new column
    // increment the column number
//echo 'HERE<br>';
    $this->ez['columns']['colNum']++;
//echo $this->ez['columns']['colNum'].'<br>';
    if ($this->ez['columns']['colNum'] <= $this->ez['columns']['options']['num']){
      // then just reset to the top of the next column
      $pageRequired=0;
    } else {
      $this->ez['columns']['colNum']=1;
      $this->ez['topMargin']=$this->ez['columns']['margins'][2];
    }

    $width = $this->ez['columns']['width'];
    $this->ez['leftMargin']=$this->ez['columns']['margins'][0]+($this->ez['columns']['colNum']-1)*($this->ez['columns']['options']['gap']+$width);
    $this->ez['rightMargin']=$this->ez['pageWidth']-$this->ez['leftMargin']-$width;
  }
//echo 'left='.$this->ez['leftMargin'].'   right='.$this->ez['rightMargin'].'<br>';

  if ($pageRequired){
    // make a new page, setting the writing point back to the top
    $this->y = $this->ez['pageHeight']-$this->ez['topMargin'];
    // make the new page with a call to the basic class.
    $this->ezPageCount++;
    if (isset($this->ez['insertMode']) && $this->ez['insertMode']==1){
      $id = $this->ezPages[$this->ezPageCount] = $this->newPage(1,$this->ez['insertOptions']['id'],$this->ez['insertOptions']['pos']);
      // then manipulate the insert options so that inserted pages follow each other
      $this->ez['insertOptions']['id']=$id;
      $this->ez['insertOptions']['pos']='after';
    } else {
      $this->ezPages[$this->ezPageCount] = $this->newPage();
    }
  } else {
    $this->y = $this->ez['pageHeight']-$this->ez['topMargin'];
  }

	switch ($this->bg_type)
    {
        case 'colour' :
            $this->saveState();
            $this->setColor($this->bg_color[0], $this->bg_color[1], $this->bg_color[2], 1);
            $this->filledRectangle(0, 0, $this->ez['pageWidth'], $this->ez['pageHeight']);
            $this->restoreState();
            break;
        case 'image'  :
            switch ($this->bg_img_type)
            {
              case 'jpg' : $this->addJpegFromFile($this->bg_img, $this->bg_img_xpos, $this->bg_img_ypos, $this->bg_img_width, $this->bg_img_height); break;
              case 'png' : $this->addPngFromFile($this->bg_img, $this->bg_img_xpos, $this->bg_img_ypos, $this->bg_img_width, $this->bg_img_height);  break;
            }
            break;
        case 'none'   :
        default      :
            break;
    }
}

// ------------------------------------------------------------------------------

function ezSetMargins($top,$bottom,$left,$right){
  // sets the margins to new values
  $this->ez['topMargin']=$top;
  $this->ez['bottomMargin']=$bottom;
  $this->ez['leftMargin']=$left;
  $this->ez['rightMargin']=$right;
  // check to see if this means that the current writing position is outside the 
  // writable area
  if ($this->y > $this->ez['pageHeight']-$top){
    // then move y down
    $this->y = $this->ez['pageHeight']-$top;
  }
  if ( $this->y < $bottom){
    // then make a new page
    $this->ezNewPage();
  }
}  

// ------------------------------------------------------------------------------

function ezGetCurrentPageNumber(){
  // return the strict numbering (1,2,3,4..) number of the current page
  return $this->ezPageCount;
}

// ------------------------------------------------------------------------------

function ezStartPageNumbers($x,$y,$size,$pos='left',$pattern='{PAGENUM} of {TOTALPAGENUM}',$num=''){
  // put page numbers on the pages from here.
  // place then on the 'pos' side of the coordinates (x,y).
  // pos can be 'left' or 'right'
  // use the given 'pattern' for display, where (PAGENUM} and {TOTALPAGENUM} are replaced
  // as required.
  // if $num is set, then make the first page this number, the number of total pages will
  // be adjusted to account for this.
  // Adjust this function so that each time you 'start' page numbers then you effectively start a different batch
  // return the number of the batch, so that they can be stopped in a different order if required.
  if (!$pos || !strlen($pos)){
    $pos='left';
  }
  if (!$pattern || !strlen($pattern)){
    $pattern='{PAGENUM} of {TOTALPAGENUM}';
  }
  if (!isset($this->ez['pageNumbering'])){
    $this->ez['pageNumbering']=array();
  }
  $i = count($this->ez['pageNumbering']);
  $this->ez['pageNumbering'][$i][$this->ezPageCount]=array('x'=>$x,'y'=>$y,'pos'=>$pos,'pattern'=>$pattern,'num'=>$num,'size'=>$size);
  return $i;
}

// ------------------------------------------------------------------------------

function ezWhatPageNumber($pageNum,$i=0){
  // given a particular generic page number (ie, document numbered sequentially from beginning),
  // return the page number under a particular page numbering scheme ($i)
  $num=0;
  $start=1;
  $startNum=1;
  if (!isset($this->ez['pageNumbering']))
  {
    $this->addMessage('WARNING: page numbering called for and wasn\'t started with ezStartPageNumbers');
    return 0;
  }
  foreach($this->ez['pageNumbering'][$i] as $k=>$v){
    if ($k<=$pageNum){
      if (is_array($v)){
        // start block
        if (strlen($v['num'])){
          // a start was specified
          $start=$v['num'];
          $startNum=$k;
          $num=$pageNum-$startNum+$start;
        }
      } else {
        // stop block
        $num=0;
      }
    }
  }
  return $num;
}

// ------------------------------------------------------------------------------

function ezStopPageNumbers($stopTotal=0,$next=0,$i=0){
  // if stopTotal=1 then the totalling of pages for this number will stop too
  // if $next=1, then do this page, but not the next, else do not do this page either
  // if $i is set, then stop that particular pagenumbering sequence.
  if (!isset($this->ez['pageNumbering'])){
    $this->ez['pageNumbering']=array();
  }
  if ($next && isset($this->ez['pageNumbering'][$i][$this->ezPageCount]) && is_array($this->ez['pageNumbering'][$i][$this->ezPageCount])){
    // then this has only just been started, this will over-write the start, and nothing will appear
    // add a special command to the start block, telling it to stop as well
    if ($stopTotal){
      $this->ez['pageNumbering'][$i][$this->ezPageCount]['stoptn']=1;
    } else {
      $this->ez['pageNumbering'][$i][$this->ezPageCount]['stopn']=1;
    }
  } else {
    if ($stopTotal){
      $this->ez['pageNumbering'][$i][$this->ezPageCount]='stopt';
    } else {
      $this->ez['pageNumbering'][$i][$this->ezPageCount]='stop';
    }
    if ($next){
      $this->ez['pageNumbering'][$i][$this->ezPageCount].='n';
    }
  }
}

// ------------------------------------------------------------------------------

function ezPRVTpageNumberSearch($lbl,&$tmp){
  foreach($tmp as $i=>$v){
    if (is_array($v)){
      if (isset($v[$lbl])){
        return $i;
      }
    } else {
      if ($v==$lbl){
        return $i;
      }
    }
  }
  return 0;
}

// ------------------------------------------------------------------------------

function ezPRVTaddPageNumbers(){
  // this will go through the pageNumbering array and add the page numbers are required
  if (isset($this->ez['pageNumbering'])){
    $totalPages1 = $this->ezPageCount;
    $tmp1=$this->ez['pageNumbering'];
    $status=0;
    foreach($tmp1 as $i=>$tmp){
      // do each of the page numbering systems
      // firstly, find the total pages for this one
      $k = $this->ezPRVTpageNumberSearch('stopt',$tmp);
      if ($k && $k>0){
        $totalPages = $k-1;
      } else {
        $l = $this->ezPRVTpageNumberSearch('stoptn',$tmp);
        if ($l && $l>0){
          $totalPages = $l;
        } else {
          $totalPages = $totalPages1;
        }
      }
      foreach ($this->ezPages as $pageNum=>$id){
        if (isset($tmp[$pageNum])){
          if (is_array($tmp[$pageNum])){
            // then this must be starting page numbers
            $status=1;
            $info = $tmp[$pageNum];
            $info['dnum']=$info['num']-$pageNum;
            // also check for the special case of the numbering stopping and starting on the same page
            if (isset($info['stopn']) || isset($info['stoptn']) ){
              $status=2;
            }
          } else if ($tmp[$pageNum]=='stop' || $tmp[$pageNum]=='stopt'){
            // then we are stopping page numbers
            $status=0;
          } else if ($status==1 && ($tmp[$pageNum]=='stoptn' || $tmp[$pageNum]=='stopn')){
            // then we are stopping page numbers
            $status=2;
          }
        }
        if ($status){
          // then add the page numbering to this page
          if (strlen($info['num'])){
            $num=$pageNum+$info['dnum'];
          } else {
            $num=$pageNum;
          }
          $total = $totalPages+$num-$pageNum;
          $pat = str_replace('{PAGENUM}',$num,$info['pattern']);
          $pat = str_replace('{TOTALPAGENUM}',$total,$pat);
          $this->reopenObject($id);
          switch($info['pos']){
            case 'right':
              $this->addText($info['x'],$info['y'],$info['size'],$pat);
              break;
            default:
              $w=$this->getTextWidth($info['size'],$pat);
              $this->addText($info['x']-$w,$info['y'],$info['size'],$pat);
              break;
          }
          $this->closeObject();
        }
        if ($status==2){
          $status=0;
        }
      }
    }
  }
}

// ------------------------------------------------------------------------------

function ezPRVTcleanUp(){
  $this->ezPRVTaddPageNumbers();
}

// ------------------------------------------------------------------------------

function ezStream($options=''){
  $this->ezPRVTcleanUp();
  $this->stream($options);
}

// ------------------------------------------------------------------------------

function ezOutput($options=0){
  $this->ezPRVTcleanUp();
  return $this->output($options);
}

// ------------------------------------------------------------------------------

function ezSetY($y){
  // used to change the vertical position of the writing point.
  $this->y = $y;
  if ( $this->y < $this->ez['bottomMargin']){
    // then make a new page
    $this->ezNewPage();
  }
}

// ------------------------------------------------------------------------------

function ezSetDy($dy,$mod=''){
  // used to change the vertical position of the writing point.
  // changes up by a positive increment, so enter a negative number to go
  // down the page
  // if $mod is set to 'makeSpace' and a new page is forced, then the pointed will be moved 
  // down on the new page, this will allow space to be reserved for graphics etc.
  $this->y += $dy;
  if ( $this->y < $this->ez['bottomMargin']){
    // then make a new page
    $this->ezNewPage();
    if ($mod=='makeSpace'){
      $this->y += $dy;
    }
  }
}

// ------------------------------------------------------------------------------

function ezPrvtTableDrawLines($pos,$gap,$x0,$x1,$y0,$y1,$y2,$col,$inner,$outer,$opt=1){
  $x0=1000;
  $x1=0;
  $this->setStrokeColor($col[0],$col[1],$col[2]);
  $cnt=0;
  $n = count($pos);
  foreach($pos as $x){
    $cnt++;
    if ($cnt==1 || $cnt==$n){
      $this->setLineStyle($outer);
    } else {
      $this->setLineStyle($inner);
    }
    $this->line($x-$gap/2,$y0,$x-$gap/2,$y2);
    if ($x>$x1){ $x1=$x; };
    if ($x<$x0){ $x0=$x; };
  }
  $this->setLineStyle($outer);
  $this->line($x0-$gap/2-$outer/2,$y0,$x1-$gap/2+$outer/2,$y0);
  // only do the second line if it is different to the first, AND each row does not have
  // a line on it.
  if ($y0!=$y1 && $opt<2){
    $this->line($x0-$gap/2,$y1,$x1-$gap/2,$y1);
  }
  $this->line($x0-$gap/2-$outer/2,$y2,$x1-$gap/2+$outer/2,$y2);
}

// ------------------------------------------------------------------------------

function ezPrvtTableColumnHeadings($cols,$pos,$maxWidth,$height,$decender,$gap,$size,&$y,$optionsAll=array()){
  // uses ezText to add the text, and returns the height taken by the largest heading
  // this page will move the headings to a new page if they will not fit completely on this one
  // transaction support will be used to implement this

  if (isset($optionsAll['cols'])){
    $options = $optionsAll['cols'];
  } else {
    $options = array();
  }
  
  $mx=0;
  $startPage = $this->ezPageCount;
  $secondGo=0;

  // $y is the position at which the top of the table should start, so the base
  // of the first text, is $y-$height-$gap-$decender, but ezText starts by dropping $height
  
  // the return from this function is the total cell height, including gaps, and $y is adjusted
  // to be the postion of the bottom line
  
  // begin the transaction
  $this->transaction('start');
  $ok=0;
//  $y-=$gap-$decender;
  $y-=$gap;
  while ($ok==0){
    foreach($cols as $colName=>$colHeading){
      $this->ezSetY($y);
      if (isset($options[$colName]) && isset($options[$colName]['justification'])){
        $justification = $options[$colName]['justification'];
      } else {
        $justification = 'left';
      }
      $this->ezText($colHeading,$size,array('aleft'=> $pos[$colName],'aright'=>($maxWidth[$colName]+$pos[$colName]),'justification'=>$justification));
      $dy = $y-$this->y;
      if ($dy>$mx){
        $mx=$dy;
      }
    }
    $y = $y - $mx - $gap + $decender;
//    $y -= $mx-$gap+$decender;
    
    // now, if this has moved to a new page, then abort the transaction, move to a new page, and put it there
    // do not check on the second time around, to avoid an infinite loop
    if ($this->ezPageCount != $startPage && $secondGo==0){
      $this->transaction('rewind');
      $this->ezNewPage();
      $y = $this->y - $gap-$decender;
      $ok=0;
      $secondGo=1;
//      $y = $store_y;
      $mx=0;

    } else {
      $this->transaction('commit');
      $ok=1;
    }
  }

  return $mx+$gap*2-$decender;
}

// ------------------------------------------------------------------------------

function ezPrvtGetTextWidth($size,$text){
  // will calculate the maximum width, taking into account that the text may be broken
  // by line breaks.
  $mx=0;
  $lines = explode("\n",$text);
  foreach ($lines as $line){
    $w = $this->getTextWidth($size,$line);
    if ($w>$mx){
      $mx=$w;
    }
  }
  return $mx;
}

// ------------------------------------------------------------------------------

function ezTable(&$data,$cols='',$title='',$options=''){
// add a table of information to the pdf document
// $data is a two dimensional array
// $cols (optional) is an associative array, the keys are the names of the columns from $data
// to be presented (and in that order), the values are the titles to be given to the columns
// $title (optional) is the title to be put on the top of the table
//
// $options is an associative array which can contain:
// 'showLines'=> 0,1,2, default is 1 (show outside and top lines only), 2=> lines on each row
// 'showHeadings' => 0 or 1
// 'shaded'=> 0,1,2,3 default is 1 (1->alternate lines are shaded, 0->no shading, 2-> both shaded, second uses shadeCol2)
// 'showBgCol'=> 0,1 default is 0 (1->active bg color column setting. if is set to 1, bgcolor attribute ca be used in 'cols' 0->no active bg color columns setting)
// 'shadeCol' => (r,g,b) array, defining the colour of the shading, default is (0.8,0.8,0.8)
// 'shadeCol2' => (r,g,b) array, defining the colour of the shading of the other blocks, default is (0.7,0.7,0.7)
// 'fontSize' => 10
// 'textCol' => (r,g,b) array, text colour
// 'titleFontSize' => 12
// 'rowGap' => 2 , the space added at the top and bottom of each row, between the text and the lines
// 'colGap' => 5 , the space on the left and right sides of each cell
// 'lineCol' => (r,g,b) array, defining the colour of the lines, default, black.
// 'xPos' => 'left','right','center','centre',or coordinate, reference coordinate in the x-direction
// 'xOrientation' => 'left','right','center','centre', position of the table w.r.t 'xPos' 
// 'width'=> <number> which will specify the width of the table, if it turns out to not be this
// wide, then it will stretch the table to fit, if it is wider then each cell will be made
// proportionalty smaller, and the content may have to wrap.
// 'maxWidth'=> <number> similar to 'width', but will only make table smaller than it wants to be
// 'cols' => array(<colname>=>array('justification'=>'left','width'=>100,'link'=>linkDataName,'bgcolor'=>array(r,g,b) ),<colname>=>....) allow the setting of other paramaters for the individual columns
// 'minRowSpace'=> the minimum space between the bottom of each row and the bottom margin, in which a new row will be started
// if it is less, then a new page would be started, default=-100
// 'innerLineThickness'=>1
// 'outerLineThickness'=>1
// 'splitRows'=>0, 0 or 1, whether or not to allow the rows to be split across page boundaries
// 'protectRows'=>number, the number of rows to hold with the heading on page, ie, if there less than this number of rows on the page, then move the whole lot onto the next page, default=1
// 'nextPageY'=> true or false (eg. 0 or 1) Sets the Y Postion of the Table of a newPage to current Table Postion
// note that the user will have had to make a font selection already or this will not // produce a valid pdf file.

	if (!is_array($data)){
		return;
	}

	if (!is_array($cols)){
		// take the columns from the first row of the data set
		reset($data);
		list($k,$v)=each($data);
		if (!is_array($v)){
			return;
		}
		$cols=array();
		foreach($v as $k1=>$v1){
			$cols[$k1]=$k1;
		}
	}
	
	if (!is_array($options)){
		$options=array();
	}

	$defaults = array( 'shaded'=>1,'showBgCol'=>0,'showLines'=>1,'shadeCol'=>array(0.8,0.8,0.8),'shadeCol2'=>array(0.7,0.7,0.7),'fontSize'=>10,'titleFontSize'=>12
	,'titleGap'=>5,'lineCol'=>array(0,0,0),'gap'=>5,'xPos'=>'centre','xOrientation'=>'centre'
	,'showHeadings'=>1,'textCol'=>array(0,0,0),'width'=>0,'maxWidth'=>0,'cols'=>array(),'minRowSpace'=>-100,'rowGap'=>2,'colGap'=>5
	,'innerLineThickness'=>1,'outerLineThickness'=>1,'splitRows'=>0,'protectRows'=>1,'nextPageY'=>0
	);

	foreach($defaults as $key=>$value){
		if (is_array($value)){
			if (!isset($options[$key]) || !is_array($options[$key])){
				$options[$key]=$value;
			}
		} else {
			if (!isset($options[$key])){
				$options[$key]=$value;
			}
		}
	}
	$options['gap']=2*$options['colGap'];
	// Use Y Position of Current Page position in Table
	if($options['nextPageY']) $nextPageY = $this->y;

	$middle = ($this->ez['pageWidth']-$this->ez['rightMargin'])/2+($this->ez['leftMargin'])/2;
	// figure out the maximum widths of the text within each column
	$maxWidth=array();
	foreach($cols as $colName=>$colHeading){
		$maxWidth[$colName]=0;
	}
	// find the maximum cell widths based on the data
	foreach($data as $row){
		foreach($cols as $colName=>$colHeading){
			$w = $this->ezPrvtGetTextWidth($options['fontSize'],(string)$row[$colName])*1.01;
			if ($w > $maxWidth[$colName]){
				$maxWidth[$colName]=$w;
			}
		}
	}
	// and the maximum widths to fit in the headings
	foreach($cols as $colName=>$colTitle){
		$w = $this->ezPrvtGetTextWidth($options['fontSize'],(string)$colTitle)*1.01;
		if ($w > $maxWidth[$colName]){
			$maxWidth[$colName]=$w;
		}
	}

	// calculate the start positions of each of the columns
	$pos=array();
	$x=0;
	$t=$x;
	$adjustmentWidth=0;
	$setWidth=0;
	foreach($maxWidth as $colName => $w){
		$pos[$colName]=$t;
		// if the column width has been specified then set that here, also total the
		// width avaliable for adjustment
		if (isset($options['cols'][$colName]) && isset($options['cols'][$colName]['width']) && $options['cols'][$colName]['width']>0){
			$t=$t+$options['cols'][$colName]['width'];
			$maxWidth[$colName] = $options['cols'][$colName]['width']-$options['gap'];
			$setWidth += $options['cols'][$colName]['width'];
		} else {
			$t=$t+$w+$options['gap'];
			$adjustmentWidth += $w;
			$setWidth += $options['gap'];
		}
	}
	$pos['_end_']=$t;

// if maxWidth is specified, and the table is too wide, and the width has not been set,
// then set the width.
	if ($options['width']==0 && $options['maxWidth'] && ($t-$x)>$options['maxWidth']){
		// then need to make this one smaller
		$options['width']=$options['maxWidth'];
	}

	if ($options['width'] && $adjustmentWidth>0 && $setWidth<$options['width']){
		// first find the current widths of the columns involved in this mystery
		$cols0 = array();
		$cols1 = array();
		$xq=0;
		$presentWidth=0;
		$last='';
		foreach($pos as $colName=>$p){
			if (!isset($options['cols'][$last]) || !isset($options['cols'][$last]['width']) || $options['cols'][$last]['width']<=0){
				if (strlen($last)){
					$cols0[$last]=$p-$xq -$options['gap'];
					$presentWidth += ($p-$xq - $options['gap']);
				}
			} else {
				$cols1[$last]=$p-$xq;
			}
			$last=$colName;
			$xq=$p;
		}
		// $cols0 contains the widths of all the columns which are not set
		$neededWidth = $options['width']-$setWidth;
		// if needed width is negative then add it equally to each column, else get more tricky
		if ($presentWidth<$neededWidth){
			foreach($cols0 as $colName=>$w){
				$cols0[$colName]+= ($neededWidth-$presentWidth)/count($cols0);
			}
		} else {
			
			$cnt=0;
			while ($presentWidth>$neededWidth && $cnt<100){
				$cnt++; // insurance policy
				// find the widest columns, and the next to widest width
				$aWidest = array();
				$nWidest=0;
				$widest=0;
				foreach($cols0 as $colName=>$w){
					if ($w>$widest){
						$aWidest=array($colName);
						$nWidest = $widest;
						$widest=$w;
					} else if ($w==$widest){
						$aWidest[]=$colName;
					}
				}
				// then figure out what the width of the widest columns would have to be to take up all the slack
				$newWidestWidth = $widest - ($presentWidth-$neededWidth)/count($aWidest);
				if ($newWidestWidth > $nWidest){
				// then there is space to set them to this
					foreach($aWidest as $colName){
						$cols0[$colName] = $newWidestWidth;
					}
					$presentWidth=$neededWidth;
				} else {
					// there is not space, reduce the size of the widest ones down to the next size down, and we
					// will go round again
					foreach($aWidest as $colName){
						$cols0[$colName] = $nWidest;
					}
					$presentWidth=$presentWidth-($widest-$nWidest)*count($aWidest);
				}
			}
		}
		// $cols0 now contains the new widths of the constrained columns.
		// now need to update the $pos and $maxWidth arrays
		$xq=0;
		foreach($pos as $colName=>$p){
			$pos[$colName]=$xq;
			if (!isset($options['cols'][$colName]) || !isset($options['cols'][$colName]['width']) || $options['cols'][$colName]['width']<=0){
				if (isset($cols0[$colName])){
					$xq += $cols0[$colName] + $options['gap'];
					$maxWidth[$colName]=$cols0[$colName];
				}
			} else {
				if (isset($cols1[$colName])){
					$xq += $cols1[$colName];
				}
			}
		}

		$t=$x+$options['width'];
		$pos['_end_']=$t;
	}

	// now adjust the table to the correct location across the page
	switch ($options['xPos']){
		case 'left':
			$xref = $this->ez['leftMargin'];
			break;
		case 'right':
			$xref = $this->ez['pageWidth'] - $this->ez['rightMargin'];
			break;
		case 'centre':
		case 'center':
			$xref = $middle;
			break;
		default:
			$xref = $options['xPos'];
			break;
	}
	switch ($options['xOrientation']){
		case 'left':
			$dx = $xref-$t;
			break;
		case 'right':
			$dx = $xref;
			break;
		case 'centre':
		case 'center':
			$dx = $xref-$t/2;
			break;
	}


	foreach($pos as $k=>$v){
		$pos[$k]=$v+$dx;
	}
	$x0=$x+$dx;
	$x1=$t+$dx;

	$baseLeftMargin = $this->ez['leftMargin'];
	$basePos = $pos;
	$baseX0 = $x0;
	$baseX1 = $x1;
	// ok, just about ready to make me a table
	$this->setColor($options['textCol'][0],$options['textCol'][1],$options['textCol'][2]);
	$this->setStrokeColor($options['shadeCol'][0],$options['shadeCol'][1],$options['shadeCol'][2]);
	
	$middle = ($x1+$x0)/2;
	
	// start a transaction which will be used to regress the table, if there are not enough rows protected
	if ($options['protectRows']>0){
		$this->transaction('start');
		$movedOnce=0;
	}
	$abortTable = 1;
	while ($abortTable){
		$abortTable=0;
		$dm = $this->ez['leftMargin']-$baseLeftMargin;
		foreach($basePos as $k=>$v){
			$pos[$k]=$v+$dm;
		}
		$x0=$baseX0+$dm;
		$x1=$baseX1+$dm;
		$middle = ($x1+$x0)/2;


		// if the title is set, then do that
		if (strlen($title)){
			$w = $this->getTextWidth($options['titleFontSize'],$title);
			$this->y -= $this->getFontHeight($options['titleFontSize']);
			if ($this->y < $this->ez['bottomMargin']){
				$this->ezNewPage();
				// margins may have changed on the newpage
				$dm = $this->ez['leftMargin']-$baseLeftMargin;
				foreach($basePos as $k=>$v){
					$pos[$k]=$v+$dm;
				}
				$x0=$baseX0+$dm;
				$x1=$baseX1+$dm;
				$middle = ($x1+$x0)/2;
				$this->y -= $this->getFontHeight($options['titleFontSize']);
			}
			$this->addText($middle-$w/2,$this->y,$options['titleFontSize'],$title);
			$this->y -= $options['titleGap'];
		}
		// margins may have changed on the newpage
		$dm = $this->ez['leftMargin']-$baseLeftMargin;
		foreach($basePos as $k=>$v){
			$pos[$k]=$v+$dm;
		}
		$x0=$baseX0+$dm;
		$x1=$baseX1+$dm;

		$y=$this->y; // to simplify the code a bit

		// make the table
		$height = $this->getFontHeight($options['fontSize']);
		$decender = $this->getFontDecender($options['fontSize']);



		$y0=$y+$decender;
		$dy=0;
		if ($options['showHeadings']){
			// this function will move the start of the table to a new page if it does not fit on this one
			$headingHeight = $this->ezPrvtTableColumnHeadings($cols,$pos,$maxWidth,$height,$decender,$options['rowGap'],$options['fontSize'],$y,$options);
			$y0 = $y+$headingHeight;
			$y1 = $y;

			$dm = $this->ez['leftMargin']-$baseLeftMargin;
			foreach($basePos as $k=>$v){
				$pos[$k]=$v+$dm;
			}
			$x0=$baseX0+$dm;
			$x1=$baseX1+$dm;
		} else {
			$y1 = $y0;
		}
		$firstLine=1;

		// open an object here so that the text can be put in over the shading
		if ($options['shaded'] || $options['showBgCol']){
			$this->saveState();
			$textObjectId = $this->openObject();
			$this->closeObject();
			$this->addObject($textObjectId);
			$this->reopenObject($textObjectId);
		}

		$cnt=0;
		$newPage=0;
		foreach($data as $row){
			$cnt++;
			// the transaction support will be used to prevent rows being split
			if ($options['splitRows']==0){
				$pageStart = $this->ezPageCount;
				if (isset($this->ez['columns']) && $this->ez['columns']['on']==1){
					$columnStart = $this->ez['columns']['colNum'];
				}
				$this->transaction('start');
				$row_orig = $row;
				$y_orig = $y;
				$y0_orig = $y0;
				$y1_orig = $y1;
			}
			$ok=0;
			$secondTurn=0;
			while(!$abortTable && $ok == 0){

				$mx=0;
				$newRow=1;
				while(!$abortTable && ($newPage || $newRow)){

					$y-=$height;
					if ($newPage || $y<$this->ez['bottomMargin'] || (isset($options['minRowSpace']) && $y<($this->ez['bottomMargin']+$options['minRowSpace'])) ){
						// check that enough rows are with the heading
						if ($options['protectRows']>0 && $movedOnce==0 && $cnt<=$options['protectRows']){
							// then we need to move the whole table onto the next page
							$movedOnce = 1;
							$abortTable = 1;
						}

						$y2=$y-$mx+2*$height+$decender-$newRow*$height;
						if ($options['showLines']){
							if (!$options['showHeadings']){
								$y0=$y1;
							}
							if($options['showLines'] > 2){
								$this->SetStrokeColor($options['lineCol'][0],$options['lineCol'][1],$options['lineCol'][2],1);
								$this->line($x0,$y1,$x1,$y1);
							}else{
								$this->ezPrvtTableDrawLines($pos,$options['gap'],$x0,$x1,$y0,$y1,$y2,$options['lineCol'],$options['innerLineThickness'],$options['outerLineThickness'],$options['showLines']);
							}
						}
						if ($options['shaded'] || $options['showBgCol']){
							$this->closeObject();
							$this->restoreState();
						}
						$this->ezNewPage();
						// and the margins may have changed, this is due to the possibility of the columns being turned on
						// as the columns are managed by manipulating the margins
						$dm	= $this->ez['leftMargin']-$baseLeftMargin;
						foreach($basePos as $k=>$v){
							$pos[$k]=$v+$dm;
						}
						// $x0=$x0+$dm;
						// $x1=$x1+$dm;
						$x0=$baseX0+$dm;
						$x1=$baseX1+$dm;
						if ($options['shaded'] || $options['showBgCol']){
							$this->saveState();
							$textObjectId = $this->openObject();
							$this->closeObject();
							$this->addObject($textObjectId);
							$this->reopenObject($textObjectId);
						}
						$this->setColor($options['textCol'][0],$options['textCol'][1],$options['textCol'][2],1);
						$y = ($options['nextPageY'])?$nextPageY:($this->ez['pageHeight']-$this->ez['topMargin']);
						$y0=$y+$decender;
						$mx=0;
						if ($options['showHeadings']){
							$this->ezPrvtTableColumnHeadings($cols,$pos,$maxWidth,$height,$decender,$options['rowGap'],$options['fontSize'],$y,$options);
							$y1=$y;
						} else {
							$y1=$y0;
						}
						$firstLine=1;
						$y -= $height;
					}
					$newRow=0;
					// write the actual data
					// if these cells need to be split over a page, then $newPage will be set, and the remaining
					// text will be placed in $leftOvers
					$newPage=0;
					$leftOvers=array();

					foreach($cols as $colName=>$colTitle){
						$this->ezSetY($y+$height);
						$colNewPage=0;
						if (isset($row[$colName])){
							if (isset($options['cols'][$colName]) && isset($options['cols'][$colName]['link']) && strlen($options['cols'][$colName]['link'])){

								$lines = explode("\n",$row[$colName]);
								if (isset($row[$options['cols'][$colName]['link']]) && strlen($row[$options['cols'][$colName]['link']])){
									foreach($lines as $k=>$v){
										$lines[$k]='<c:alink:'.$row[$options['cols'][$colName]['link']].'>'.$v.'</c:alink>';
									}
								}
							} else {
								$lines = explode("\n",$row[$colName]);
							}
						} else {
							$lines = array();
						}
						$this->y -= $options['rowGap'];
						foreach ($lines as $line){
							$line = $this->ezProcessText($line);
							$start=1;

							while (strlen($line) || $start){
								$start=0;
								if (!$colNewPage){
									$this->y=$this->y-$height;
								}
								if ($this->y < $this->ez['bottomMargin']){
									// $this->ezNewPage();
									$newPage=1; // whether a new page is required for any of the columns
									$colNewPage=1; // whether a new page is required for this column
								}
								if ($colNewPage){
									if (isset($leftOvers[$colName])){
										$leftOvers[$colName].="\n".$line;
									} else {
										$leftOvers[$colName] = $line;
									}
									$line='';
								} else {
									if (isset($options['cols'][$colName]) && isset($options['cols'][$colName]['justification']) ){
										$just = $options['cols'][$colName]['justification'];
									} else {
										$just='left';
									}

								$line=$this->addTextWrap($pos[$colName],$this->y,$maxWidth[$colName],$options['fontSize'],$line,$just);
								}
							}
						}

						$dy=$y+$height-$this->y+$options['rowGap'];
						if ($dy-$height*$newPage>$mx){
							$mx=$dy-$height*$newPage;
						}
					}
					// set $row to $leftOvers so that they will be processed onto the new page
					$row = $leftOvers;
					// now add the shading underneath
					if ($options['shaded'] && $cnt%2==0){
						$this->closeObject();
						$this->setColor($options['shadeCol'][0],$options['shadeCol'][1],$options['shadeCol'][2],1);
						$this->filledRectangle($x0-$options['gap']/2,$y+$decender+$height-$mx,$x1-$x0,$mx);
						$this->reopenObject($textObjectId);
					}

					if ($options['shaded']==2 && $cnt%2==1){
						$this->closeObject();
						$this->setColor($options['shadeCol2'][0],$options['shadeCol2'][1],$options['shadeCol2'][2],1);
						$this->filledRectangle($x0-$options['gap']/2,$y+$decender+$height-$mx,$x1-$x0,$mx);
						$this->reopenObject($textObjectId);
					}

					// if option showColColor is set,  then can draw filledrectangle column
					if ($options['showBgCol'] == 1) {
						foreach($cols as $colName=>$colTitle){
							if ( isset($options['cols'][$colName]) && isset($options['cols'][$colName]['bgcolor'])) {
								$arrColColor = $options['cols'][$colName]['bgcolor'];
								$this->closeObject();
								$this->setColor($arrColColor[0],$arrColColor[1],$arrColColor[2],1);
								$this->filledRectangle($pos[$colName]-$options['gap']/2,$y+$decender+$height-$mx,$maxWidth[$colName]+$options['gap'],$mx);
								$this->reopenObject($textObjectId);
							}
						}
					}
					if ($options['showLines']>1){
						// then draw a line on the top of each block
						// $this->closeObject();
						$this->saveState();
						$this->setStrokeColor($options['lineCol'][0],$options['lineCol'][1],$options['lineCol'][2],1);
						// $this->line($x0-$options['gap']/2,$y+$decender+$height-$mx,$x1-$x0,$mx);
						if ($firstLine){
							$this->setLineStyle($options['outerLineThickness']);
							$firstLine=0;
						} else {
							$this->setLineStyle($options['innerLineThickness']);
						}
						if($options['showLines'] < 3){
							$this->line($x0-$options['gap']/2,$y+$decender+$height,$x1-$options['gap']/2,$y+$decender+$height);
						}
						$this->restoreState();
						// $this->reopenObject($textObjectId);
					}
				} // end of while 
				$y=$y-$mx+$height;

				// checking row split over pages
				if ($options['splitRows']==0){
					if ( ( ($this->ezPageCount != $pageStart) || (isset($this->ez['columns']) && $this->ez['columns']['on']==1 && $columnStart != $this->ez['columns']['colNum'] )) && $secondTurn==0){
						// then we need to go back and try that again !
						$newPage=1;
						$secondTurn=1;
						$this->transaction('rewind');
						$row = $row_orig;
						$y = $y_orig;
						$y0 = $y0_orig;
						$y1 = $y1_orig;
						$ok=0;
						// MARKIERT
						$dm = $this->ez['leftMargin']-$baseLeftMargin;
						foreach($basePos as $k=>$v){
							$pos[$k]=$v+$dm;
						}
						$x0=$baseX0+$dm;
						$x1=$baseX1+$dm;

					} else {
						$this->transaction('commit');
						$ok=1;
					}
				} else {
					$ok=1; // don't go round the loop if splitting rows is allowed
				}
			} // end of while to check for row splitting
			if ($abortTable){
				if ($ok==0){
					$this->transaction('abort');
			}
			// only the outer transaction should be operational
			$this->transaction('rewind');
			$this->ezNewPage();
			break;
		}

	} // end of foreach ($data as $row)

	} // end of while ($abortTable)

	// table has been put on the page, the rows guarded as required, commit.
	$this->transaction('commit');

	$y2=$y+$decender;
	if ($options['showLines']){
		if (!$options['showHeadings']){
			$y0=$y1;
		}
		if($options['showLines'] > 2){
			$this->SetStrokeColor($options['lineCol'][0],$options['lineCol'][1],$options['lineCol'][2],1);
			$this->line($x0,$y1,$x1,$y1);
		}else{
			$this->ezPrvtTableDrawLines($pos,$options['gap'],$x0,$x1,$y0,$y1,$y2,$options['lineCol'],$options['innerLineThickness'],$options['outerLineThickness'],$options['showLines']);
		}
	}
	// close the object for drawing the text on top
	if ($options['shaded'] || $options['showBgCol']){
		$this->closeObject();
		$this->restoreState();
	}


	$this->y=$y;
	return $y;
}

// ------------------------------------------------------------------------------
function ezProcessText($text){
  // this function will intially be used to implement underlining support, but could be used for a range of other
  // purposes
  $search = array('<u>','<U>','</u>','</U>');
  $replace = array('<c:uline>','<c:uline>','</c:uline>','</c:uline>');
  return str_replace($search,$replace,$text);
}

// ------------------------------------------------------------------------------

function ezText($text,$size=0,$options=array(),$test=0){
  // this will add a string of text to the document, starting at the current drawing
  // position.
  // it will wrap to keep within the margins, including optional offsets from the left
  // and the right, if $size is not specified, then it will be the last one used, or
  // the default value (12 I think).
  // the text will go to the start of the next line when a return code "\n" is found.
  // possible options are:
  // 'left'=> number, gap to leave from the left margin
  // 'right'=> number, gap to leave from the right margin
  // 'aleft'=> number, absolute left position (overrides 'left')
  // 'aright'=> number, absolute right position (overrides 'right')
  // 'justification' => 'left','right','center','centre','full'

  // only set one of the next two items (leading overrides spacing)
  // 'leading' => number, defines the total height taken by the line, independent of the font height.
  // 'spacing' => a real number, though usually set to one of 1, 1.5, 2 (line spacing as used in word processing)
  
  // if $test is set then this should just check if the text is going to flow onto a new page or not, returning true or false
  
  // apply the filtering which will make the underlining function.
  $text = $this->ezProcessText($text);
  
  $newPage=false;
  $store_y = $this->y;
  
  if (is_array($options) && isset($options['aleft'])){
    $left=$options['aleft'];
  } else {
    $left = $this->ez['leftMargin'] + ((is_array($options) && isset($options['left']))?$options['left']:0);
  }
  if (is_array($options) && isset($options['aright'])){
    $right=$options['aright'];
  } else {
    $right = $this->ez['pageWidth'] - $this->ez['rightMargin'] - ((is_array($options) && isset($options['right']))?$options['right']:0);
  }
  if ($size<=0){
    $size = $this->ez['fontSize'];
  } else {
    $this->ez['fontSize']=$size;
  }
  
  if (is_array($options) && isset($options['justification'])){
    $just = $options['justification'];
  } else {
    $just = 'left';
  }
  
  // modifications to give leading and spacing based on those given by Craig Heydenburg 1/1/02
  if (is_array($options) && isset($options['leading'])) { ## use leading instead of spacing
    $height = $options['leading'];
	} else if (is_array($options) && isset($options['spacing'])) {
    $height = $this->getFontHeight($size) * $options['spacing'];
	} else {
		$height = $this->getFontHeight($size);
	}

  
  $lines = explode("\n",$text);
  foreach ($lines as $line){
    $start=1;
    while (strlen($line) || $start){
      $start=0;
      $this->y=$this->y-$height;
      if ($this->y < $this->ez['bottomMargin']){
        if ($test){
          $newPage=true;
        } else {
          $this->ezNewPage();
          // and then re-calc the left and right, in case they have changed due to columns
        }
      }
      if (is_array($options) && isset($options['aleft'])){
        $left=$options['aleft'];
      } else {
        $left = $this->ez['leftMargin'] + ((is_array($options) && isset($options['left']))?$options['left']:0);
      }
      if (is_array($options) && isset($options['aright'])){
        $right=$options['aright'];
      } else {
        $right = $this->ez['pageWidth'] - $this->ez['rightMargin'] - ((is_array($options) && isset($options['right']))?$options['right']:0);
      }
      $line=$this->addTextWrap($left,$this->y,$right-$left,$size,$line,$just,0,$test);
    }
  }

  if ($test){
    $this->y=$store_y;
    return $newPage;
  } else {
    return $this->y;
  }
}

// ------------------------------------------------------------------------------

function ezImage($image,$pad = 5,$width = 0,$resize = 'full',$just = 'center',$border = ''){
	//beta ezimage function
	if (stristr($image,'://'))//copy to temp file
	{
		$fp = @fopen($image,"rb");
		while(!feof($fp))
   		{
      			$cont.= fread($fp,1024);
   		}
   		fclose($fp);
		$image = tempnam ("/tmp", "php-pdf");
		$fp2 = @fopen($image,"w");
   		fwrite($fp2,$cont);
  		fclose($fp2);
		$temp = true;
	}

	if (!(file_exists($image))) return false; //return immediately if image file does not exist
	$imageInfo = getimagesize($image);
	switch ($imageInfo[2]){
		case 2:
			$type = "jpeg";
			break;
		case 3:
			$type = "png";
			break;
		default:
			return false; //return if file is not jpg or png
	}
	if ($width == 0) $width = $imageInfo[0]; //set width
	$ratio = $imageInfo[0]/$imageInfo[1];

	//get maximum width of image
	if (isset($this->ez['columns']) && $this->ez['columns']['on'] == 1)
	{
		$bigwidth = $this->ez['columns']['width'] - ($pad * 2);
	}
	else
	{
		$bigwidth = $this->ez['pageWidth'] - ($pad * 2);
	}
	//fix width if larger than maximum or if $resize=full
	if ($resize == 'full' || $resize == 'width' || $width > $bigwidth)
	{
		$width = $bigwidth;

	}

	$height = ($width/$ratio); //set height

	//fix size if runs off page
	if ($height > ($this->y - $this->ez['bottomMargin'] - ($pad * 2)))
	{
		if ($resize != 'full')
		{
			$this->ezNewPage();
		}
		else
		{
			$height = ($this->y - $this->ez['bottomMargin'] - ($pad * 2)); //shrink height
			$width = ($height*$ratio); //fix width
		}
	}

	//fix x-offset if image smaller than bigwidth
	if ($width < $bigwidth)
	{
		//center if justification=center
		if ($just == 'center')
		{
			$offset = ($bigwidth - $width) / 2;
		}
		//move to right if justification=right
		if ($just == 'right')
		{
			$offset = ($bigwidth - $width);
		}
		//leave at left if justification=left
		if ($just == 'left')
		{
			$offset = 0;
		}
	}


	//call appropriate function
	if ($type == "jpeg"){
		$this->addJpegFromFile($image,$this->ez['leftMargin'] + $pad + $offset, $this->y + $this->getFontHeight($this->ez['fontSize']) - $pad - $height,$width);
	}

	if ($type == "png"){
		$this->addPngFromFile($image,$this->ez['leftMargin'] + $pad + $offset, $this->y + $this->getFontHeight($this->ez['fontSize']) - $pad - $height,$width);
	}
	//draw border
	if ($border != '')
	{
	if (!(isset($border['color'])))
	{
		$border['color']['red'] = .5;
		$border['color']['blue'] = .5;
		$border['color']['green'] = .5;
	}
	if (!(isset($border['width']))) $border['width'] = 1;
	if (!(isset($border['cap']))) $border['cap'] = 'round';
	if (!(isset($border['join']))) $border['join'] = 'round';
	

	$this->setStrokeColor($border['color']['red'],$border['color']['green'],$border['color']['blue']);
	$this->setLineStyle($border['width'],$border['cap'],$border['join']);
	$this->rectangle($this->ez['leftMargin'] + $pad + $offset, $this->y + $this->getFontHeight($this->ez['fontSize']) - $pad - $height,$width,$height);

	}
	// move y below image
	$this->y = $this->y - $pad - $height;
	//remove tempfile for remote images
	if ($temp == true) unlink($image);

}
// ------------------------------------------------------------------------------

// note that templating code is still considered developmental - have not really figured
// out a good way of doing this yet.
function loadTemplate($templateFile){
  // this function will load the requested template ($file includes full or relative pathname)
  // the code for the template will be modified to make it name safe, and then stored in 
  // an array for later use
  // The id of the template will be returned for the user to operate on it later
  if (!file_exists($templateFile)){
    return -1;
  }

  $code = implode('',file($templateFile));
  if (!strlen($code)){
    return;
  }

  $code = trim($code);
  if (substr($code,0,5)=='<?php'){
    $code = substr($code,5);
  }
  if (substr($code,-2)=='?>'){
    $code = substr($code,0,strlen($code)-2);
  }
  if (isset($this->ez['numTemplates'])){
    $newNum = $this->ez['numTemplates'];
    $this->ez['numTemplates']++;
  } else {
    $newNum=0;
    $this->ez['numTemplates']=1;
    $this->ez['templates']=array();
  }

  $this->ez['templates'][$newNum]['code']=$code;

  return $newNum;
}

// ------------------------------------------------------------------------------

function execTemplate($id,$data=array(),$options=array()){
  // execute the given template on the current document.
  if (!isset($this->ez['templates'][$id])){
    return;
  }
  eval($this->ez['templates'][$id]['code']);
}

// ------------------------------------------------------------------------------
function ilink($info){
  $this->alink($info,1);
}

function alink($info,$internal=0){
  // a callback function to support the formation of clickable links within the document
  $lineFactor=0.05; // the thickness of the line as a proportion of the height. also the drop of the line.
  switch($info['status']){
    case 'start':
    case 'sol':
      // the beginning of the link
      // this should contain the URl for the link as the 'p' entry, and will also contain the value of 'nCallback'
      if (!isset($this->ez['links'])){
        $this->ez['links']=array();
      }
      $i = $info['nCallback'];
      $this->ez['links'][$i] = array('x'=>$info['x'],'y'=>$info['y'],'angle'=>$info['angle'],'decender'=>$info['decender'],'height'=>$info['height'],'url'=>$info['p']);
      if ($internal==0){
        $this->saveState();
        $this->setColor(0,0,1);
        $this->setStrokeColor(0,0,1);
        $thick = $info['height']*$lineFactor;
        $this->setLineStyle($thick);
      }
      break;
    case 'end':
    case 'eol':
      // the end of the link
      // assume that it is the most recent opening which has closed
      $i = $info['nCallback'];
      $start = $this->ez['links'][$i];
      // add underlining
      if ($internal){
        $this->addInternalLink($start['url'],$start['x'],$start['y']+$start['decender'],$info['x'],$start['y']+$start['decender']+$start['height']);
      } else {
        $a = deg2rad((float)$start['angle']-90.0);
        $drop = $start['height']*$lineFactor*1.5;
        $dropx = cos($a)*$drop;
        $dropy = -sin($a)*$drop;
        $this->line($start['x']-$dropx,$start['y']-$dropy,$info['x']-$dropx,$info['y']-$dropy);
        $this->addLink($start['url'],$start['x'],$start['y']+$start['decender'],$info['x'],$start['y']+$start['decender']+$start['height']);
        $this->restoreState();
      }
      break;
  }
}

// ------------------------------------------------------------------------------

function uline($info){
  // a callback function to support underlining
  $lineFactor=0.05; // the thickness of the line as a proportion of the height. also the drop of the line.
  switch($info['status']){
    case 'start':
    case 'sol':
    
      // the beginning of the underline zone
      if (!isset($this->ez['links'])){
        $this->ez['links']=array();
      }
      $i = $info['nCallback'];
      $this->ez['links'][$i] = array('x'=>$info['x'],'y'=>$info['y'],'angle'=>$info['angle'],'decender'=>$info['decender'],'height'=>$info['height']);
      $this->saveState();
      $thick = $info['height']*$lineFactor;
      $this->setLineStyle($thick);
      break;
    case 'end':
    case 'eol':
      // the end of the link
      // assume that it is the most recent opening which has closed
      $i = $info['nCallback'];
      $start = $this->ez['links'][$i];
      // add underlining
      $a = deg2rad((float)$start['angle']-90.0);
      $drop = $start['height']*$lineFactor*1.5;
      $dropx = cos($a)*$drop;
      $dropy = -sin($a)*$drop;
      $this->line($start['x']-$dropx,$start['y']-$dropy,$info['x']-$dropx,$info['y']-$dropy);
      $this->restoreState();
      break;
  }
}

// ------------------------------------------------------------------------------

}
?>
Return current item: PHP Pdf creation