1#@!#!123s

: / opt / lampp / lib / php /
Filename : Cezpdf.php
back
<?php
/**
 * Helper class to create pdf documents
 *
 * 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.
 *
 * @package Cpdf
 * @version 0.11.6
 * @license released under a public domain licence.
 * @link http://www.sourceforge.net/p/pdf-php/
 * @author Wayne Munro, R&OS Ltd, http://www.ros.co.nz/pdf
 * @author 2002-07-24: Nicola Asuni (info@tecnick.com)
 * @author Ole K <ole1986@users.sourceforge.net>
 */
include_once 'Cpdf.php';

class Cezpdf extends Cpdf {

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

    // Background color and image stuff added
    protected $ezBackground = 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
     *           *new*    $options['repeat']  = repeat image horizontally (1), repeat image vertically (2) or full in both directions (3); default is 0
     *                                          highly recommend to set this->hashed to true when using repeat function
	 *
     * 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 (info@tecnick.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
     *
     * @param $paper
     * @param $orientation
     * @param $type
     * @param $options
     * @return unknown_type
     */
    public function __construct($paper='a4',$orientation='portrait', $type = 'none', $options = array()){
        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;
            }
        }
        parent::__construct($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->ezBackground['type'] = 'color';
            	$this->ezBackground['color'] = $options;
                break;
            case 'image'  :
            	if(!isset($options['img']))
            	{
            		$errormsg="Background Image not set.";
                	break;
            	}
            	
                if (!file_exists($options['img']))
                {
                	$errormsg="Background Image does not exists: '".$options['img']."'";
                	break;
            	}
            	
            	$im = getimagesize($options['img']);
            	if($im === false){
            		$errormsg="Background Image is invalid: '".$options['img']."'";
            		break;
            	}
            	
            	$this->ezBackground['type'] = 'image';
            	$this->ezBackground['image'] = $options['img'];
            	$this->ezBackground['format'] = $im[2];
            	$this->ezBackground['repeat'] = $options['repeat'];
            	
            	if (isset($options['width']) && is_numeric($options['width']))  $this->ezBackground['width'] = $options['width'];  else $this->ezBackground['width']  = $this->ez['pageWidth'];
            	if (isset($options['height']) && is_numeric($options['height'])) $this->ezBackground['height'] = $options['height']; else $this->ezBackground['height'] = $this->ez['pageHeight'];
            	if (isset($options['xpos']) && is_numeric($options['xpos']))   $this->ezBackground['xpos']  = $options['xpos'];   else $this->ezBackground['xpos'] = 0;
            	if (isset($options['ypos']) && is_numeric($options['ypos']))   $this->ezBackground['ypos']  = $options['ypos'];   else $this->ezBackground['ypos']   = 0;
                break;
            case 'none':
            default:
                $this->ezBackground['type'] = 'none';
                break;
        }
        
        $this->setBackground();
    }
    
    /**
     * Set the background image or color on all pages
     * gets executed in constructor and in ezNewPage
     * @access protected
     */
	protected function setBackground(){
		if(isset($this->ezBackground['type'])){
	        switch ($this->ezBackground['type'])
	        {
	            case 'color':
	            	if (isset($this->ezBackground['color']) && count(array_filter( array_map( function($_){ return is_numeric($_)&&0<=$_&&$_<=1; }, $this->ezBackground['color']))) == 3)
	            	{
	                	$this->saveState();
	                	$this->setColor($this->ezBackground['color'][0], $this->ezBackground['color'][1], $this->ezBackground['color'][2], 1);
	                	$this->filledRectangle(0, 0, $this->ez['pageWidth'], $this->ez['pageHeight']);
	                	$this->restoreState();
	            	}
	                break;
	            case 'image':
	            	$ypos = 0;
	            	if($this->ezBackground['repeat'] == 1){
	            		$ypos = $this->ezBackground['ypos'];
	            	}
	        		
	        		$xpos = 0;
	            	if($this->ezBackground['repeat'] == 2){
	            		$xpos = $this->ezBackground['xpos'];;
	            	}
	            	
	            	$this->addBackgroundImage($xpos, $ypos);
	            	
	            	if($this->ezBackground['repeat'] & 1){ // repeat-x
	            		$numX = ceil($this->ez['pageWidth'] / $this->ezBackground['width']);
	            		for($i = 1; $i <= $numX; $i++){
	            			$xpos = ($this->ezBackground['width'] * $i);
	            			$this->addBackgroundImage($xpos,$ypos);
	            		}
	            	}
	            	
	            	$xpos = 0;
	            	if($this->ezBackground['repeat'] & 2){ // repeat-y
	            		$numY = ceil($this->ez['pageHeight'] / $this->ezBackground['height']);
        				for($i = 1; $i <= $numY; $i++){
        					$ypos = ($this->ezBackground['height'] * $i);
        					$this->addBackgroundImage($xpos,$ypos);
        				}
        			}
        			
        			if($this->ezBackground['repeat'] == 3){ // repeat all
	            		$numX = ceil($this->ez['pageWidth'] / $this->ezBackground['width']);
	            		$numY = ceil($this->ez['pageHeight'] / $this->ezBackground['height']);
	            		
	            		for($i = 1; $i <= $numX; $i++){
	            			$xpos = ($this->ezBackground['width'] * $i);
	            			for($j = 1; $j <= $numY; $j++){
	            				$ypos = ($this->ezBackground['height'] * $j);
	            				$this->addBackgroundImage($xpos,$ypos);
	            			}
	            		}
	            	}
        			
	                break;
	            case 'none':
	            default:
	                break;
	        }
        }
	}
	
	/**
	 * adds background image for JPEG and PNG file format
	 * Especially used for repeating function
	 * @access private
	 */
	private function addBackgroundImage($xOffset = 0, $yOffset = 0){
		switch ($this->ezBackground['format']) {
            case IMAGETYPE_JPEG:
            	$this->addJpegFromFile($this->ezBackground['image'], $xOffset, $yOffset, $this->ezBackground['width'], $this->ezBackground['height']);
            break;
            case IMAGETYPE_PNG:
            	$this->addPngFromFile($this->ezBackground['image'], $xOffset, $yOffset, $this->ezBackground['width'], $this->ezBackground['height']);
            break;
        }
	}

    /**
     *
     * @param $top
     * @param $bottom
     * @param $left
     * @param $right
     * @return unknown_type
     * @access public
     */
    public 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();
        }
    }

    /**
     * Set Margins in centimeters
     * @author 2002-07-24: Nicola Asuni (info@tecnick.com)
     *
     * @param $top
     * @param $bottom
     * @param $left
     * @param $right
     * @return unknown_type
     * @access public
     */
    public 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);
    }

	/**
     * creates a new Page
     * @return unknown_type
     * @access public
     */
    public 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;
        }

        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'];
        }
        
        $this->setBackground();
    }

    /**
     * starts to flow text into columns
     * @param $options array with option for gaps and no of columns
     * @return unknown_type
     * @access public
     */
    public 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;

    }

    /**
     * stops the multi column mode
     * @return unknown_type
     * @access public
     */
    public 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];
        }
    }

    /**
     * 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
     *
     * @param $status
     * @param $pageNum
     * @param $pos
     * @return unknown_type
     * @access public
     */
    public function ezInsertMode($status=1,$pageNum=1,$pos='before'){
        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;
        }
    }

	/**
     * sets the Y position of the document
     * @param $y
     * @return unknown_type
     * @access public
     */
    public 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();
        }
    }

    /**
     * changes the Y position of the document by writing positive or negative numbers
     * @param $dy
     * @param $mod
     * @return unknown_type
     * @access public
     */
    public 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;
            }
        }
    }

    /**
     * put page numbers on the pages from here.
     * place then on the 'pos' side of the coordinates (x,y).
     * use the given 'pattern' for display, where (PAGENUM} and {TOTALPAGENUM} are replaced
     * as required.
     * 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.
	 *
     * @param integer $x X-coordinate
     * @param integer $y Y-coordinate
     * @param $size
     * @param string $pos use right or left
     * @param $pattern
     * @param integer $num optional. make the first page this number, the number of total pages will
     * be adjusted to account for this.
     *
     * @access public
     * @return unknown_type
     */
    public function ezStartPageNumbers($x,$y,$size,$pos='left',$pattern='{PAGENUM} of {TOTALPAGENUM}',$num=''){
        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;
    }

    /**
     * returns the number of a page within the specified page numbering system
     * @param $pageNum
     * @param $i
     * @access public
     * @return integer page number
     */
    public 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;
    }
    
	/**
     * returns the current page number
     * @access public
     * @return integer page number
     */
    public function ezGetCurrentPageNumber(){
        // return the strict numbering (1,2,3,4..) number of the current page
        return $this->ezPageCount;
    }

    /**
     * stops the custom page numbering
     * @param $stopTotal
     * @param $next
     * @param $i
     * @access public
     * @return unknown_type
     */
    public 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';
            }
        }
    }

    /**
     *
     * @param $lbl
     * @param $tmp
     * @access private
     * @return unknown_type
     */
    private function ezPageNumberSearch($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;
    }

    /**
     * @access private
     */
    private function addPageNumbers(){
        // 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->ezPageNumberSearch('stopt',$tmp);
                if ($k && $k>0){
                    $totalPages = $k-1;
                } else {
                    $l = $this->ezPageNumberSearch('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;
                    }
                }
            }
        }
    }

    /**
     * @access private
     * @return unknown_type
     */
    private function cleanUp(){
        $this->addPageNumbers();
    }

    /**
     *
     * @param $pos
     * @param $gap
     * @param $x0
     * @param $x1
     * @param $y0
     * @param $y1
     * @param $y2
     * @param $col
     * @param $inner
     * @param $outer
     * @param $opt
     * @access protected
     * @return unknown_type
     */
    protected function ezTableDrawLines($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);

            if ($opt != 3) $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);
    }

    /**
     *
     * @param $cols
     * @param $pos
     * @param $maxWidth
     * @param $height
     * @param $decender
     * @param $gap
     * @param $size
     * @param $y
     * @param $optionsAll
     * @access protected
     * @return unknown_type
     */
    protected function ezTableColumnHeadings($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;
    }

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

    /**
     *  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,3,4 default is 1 (show outside and top lines only), 2=> lines on each row, 3=> lines for only rowa (excl. headline), 4=> HEAD LINE only
	 * '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.
  	 *
     * @param $data
     * @param $cols
     * @param $title
     * @param $options
     * @access public
     * @return unknown_type
     */
    public function ezTable(&$data,$cols='',$title='',$options=''){
        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->ezGetTextWidth($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->ezGetTextWidth($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->ezTableColumnHeadings($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'] > 3){
                                    $this->SetStrokeColor($options['lineCol'][0],$options['lineCol'][1],$options['lineCol'][2],1);
                                    $this->line($x0,$y1,$x1,$y1);
                                }else if ($options['showLines'] < 3){
                                    $this->ezTableDrawLines($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->ezTableColumnHeadings($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'] < 4){
                                $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'] > 3){
                $this->SetStrokeColor($options['lineCol'][0],$options['lineCol'][1],$options['lineCol'][2],1);
                $this->line($x0,$y1,$x1,$y1);
            } else if ($options['showLines'] < 3){
                $this->ezTableDrawLines($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;
    }

    /**
     *
     * @param $text
     * @access protected
     * @return unknown_type
     */
    protected 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);
    }

    /**
     * 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
	 *
     *
     * @param $text
     * @param $size
     * @param $options
     * @param $test
     * @access public
     * @return unknown_type
     */
    public function ezText($text,$size=0,$options=array(),$test=0){
        // 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
                        $this->y= $this->y - $height;
                    }
                }
                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;
        }
    }

    /**
     * Used to display image
     * supported images are:
     *  - JPEG
     *  - PNG (transparent)
     *  - GIF (but internally converted into JPEG)
     * @param $image
     * @param $pad
     * @param $width
     * @param $resize
     * @param $just
     * @param $border
     * @access public
     * @return unknown_type
     */
    public function ezImage($image, $pad = 5, $width = 0, $resize = 'full', $just = 'center', $border = '') {
    	$temp = false;
        //beta ezimage function
        if (stristr($image, '://')) { //copy to temp file
        	$cont = file_get_contents($image);
        	
            $image = tempnam($this->tempPath, "ezImg");
            $fp2 = @ fopen($image, "w");
            fwrite($fp2, $cont);
            fclose($fp2);
            $temp = true;
        }

		
        if (!(file_exists($image))){
        	$this->debug("ezImage: Could not find image '$image'", E_USER_WARNING);
            return false; //return immediately if image file does not exist
        }
        
        $imageInfo = getimagesize($image);
        
        
        if($imageInfo === false){
        	$this->debug("ezImage: Could not get image info for '$image'", E_USER_ERROR);
        }
        
        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 - $this->ez['leftMargin'] - $this->ez['rightMargin'];
        }

        $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) - $this->ez['leftMargin'];
            }
            //move to right if justification=right
            if ($just == 'right') {
                $offset = ($bigwidth - $width) - $this->ez['leftMargin'] - $this->ez['rightMargin'];
            }
            //leave at left if justification=left
            if ($just == 'left') {
                $offset = 0;
            }
        }

        //call appropriate function
        switch ($imageInfo[2]) {
            case IMAGETYPE_JPEG:
            	$this->addJpegFromFile($image, $this->ez['leftMargin'] + $pad + $offset, $this->y + $this->getFontHeight($this->ez['fontSize']) - $pad - $height, $width);
                break;
            case IMAGETYPE_PNG:
            	$this->addPngFromFile($image, $this->ez['leftMargin'] + $pad + $offset, $this->y + $this->getFontHeight($this->ez['fontSize']) - $pad - $height, $width);
                break;
            case IMAGETYPE_GIF:
            	// use GD to convert the GIF image to PNG and allow transparency
            	$this->addGifFromFile($image, $this->ez['leftMargin'] + $pad + $offset, $this->y + $this->getFontHeight($this->ez['fontSize']) - $pad - $height, $width);
            	break;
            default:
            	$this->debug("ezImage: Unsupported image type".$imageInfo[2], E_USER_WARNING);
                return false; //return if file is not jpg or png
        }
        
        //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);
    }

    /**
     * Outputs the PDF content as stream
     * $options
     * 	'compress' => 0/1 to enable compression. For compression level please use $this->options['compression'] = <level> at the very first point. Default: 1 
     *  'download' => 0/1 to display inline (in browser) or as download. Default: 0
     * 
     * @param $options
     * @access public
     * @return unknown_type
     */
    public function ezStream($options=''){
        $this->cleanUp();
        $this->stream($options);
    }

    /**
     * returns the PDF as "string"
     * @param $options
     * @access public
     * @return unknown_type
     */
    public function ezOutput($options=0){
        $this->cleanUp();
        return $this->output($options);
    }

    /**
     * note that templating code is still considered developmental - have not really figured
     * out a good way of doing this yet.
     *
     * 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
     *
     * @param $templateFile
     * @access public
     * @return unknown_type
     * @deprecated method deprecated in 0.12.0
     */
    public function loadTemplate($templateFile){
        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;
    }

    /**
     * executes the template
     * @param $id
     * @param $data
     * @param $options
     * @access public
     * @return unknown_type
     * @deprecated method deprecated in 0.12.0
     */
    public 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']);
    }

    /**
     * callback function for internal links
     * @param $info
     * @access public
     * @return unknown_type
     */
    public function ilink($info){
        $this->alink($info,1);
    }

    /**
     * callback function for external links 
     * @param $info
     * @param $internal
     * @access public
     * @return unknown_type
     */
    public 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;
        }
    }

    /**
     * a callback function to support underlining
     * @param $info
     * @access public
     * @return unknown_type
     */
    public function uline($info){
        $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;
        }
    }
}