[ Index ]

PHP Cross Reference of osCMax 2.0.4

title

Body

[close]

/admin/includes/modules/batch_print/ -> class.ezpdf.php (source)

   1  <?php
   2  
   3  include_once(BATCH_PRINT_INC . 'class.pdf.php');
   4  
   5  class Cezpdf extends Cpdf {
   6  //==============================================================================
   7  // this class will take the basic interaction facilities of the Cpdf class
   8  // and make more useful functions so that the user does not have to 
   9  // know all the ins and outs of pdf presentation to produce something pretty.
  10  //
  11  // IMPORTANT NOTE
  12  // there is no warranty, implied or otherwise with this software.
  13  // 
  14  // version 009 (versioning is linked to class.pdf.php)
  15  //
  16  // released under a public domain licence.
  17  //
  18  // Wayne Munro, R&OS Ltd, http://www.ros.co.nz/pdf
  19  //==============================================================================
  20  
  21  var $ez=array('fontSize'=>10); // used for storing most of the page configuration parameters
  22  var $y; // this is the current vertical positon on the page of the writing point, very important
  23  var $ezPages=array(); // keep an array of the ids of the pages, making it easy to go back and add page numbers etc.
  24  var $ezPageCount=0;
  25  
  26  // ------------------------------------------------------------------------------
  27  
  28  function Cezpdf($paper='a4',$orientation='portrait'){
  29      // Assuming that people don't want to specify the paper size using the absolute coordinates
  30      // allow a couple of options:
  31      // orientation can be 'portrait' or 'landscape'
  32      // or, to actually set the coordinates, then pass an array in as the first parameter.
  33      // the defaults are as shown.
  34      // 
  35      // -------------------------
  36      // 2002-07-24 - Nicola Asuni ([email protected]):
  37      // Added new page formats (45 standard ISO paper formats and 4 american common formats)
  38      // paper cordinates are calculated in this way: (inches * 72) where 1 inch = 2.54 cm
  39      // 
  40      // Now you may also pass a 2 values array containing the page width and height in centimeters
  41      // -------------------------
  42  
  43      if (!is_array($paper)){
  44          switch (strtoupper($paper)){
  45              case '4A0': {$size = array(0,0,4767.87,6740.79); break;}
  46              case '2A0': {$size = array(0,0,3370.39,4767.87); break;}
  47              case 'A0': {$size = array(0,0,2383.94,3370.39); break;}
  48              case 'A1': {$size = array(0,0,1683.78,2383.94); break;}
  49              case 'A2': {$size = array(0,0,1190.55,1683.78); break;}
  50              case 'A3': {$size = array(0,0,841.89,1190.55); break;}
  51              case 'A4': default: {$size = array(0,0,595.28,841.89); break;}
  52              case 'A5': {$size = array(0,0,419.53,595.28); break;}
  53              case 'A6': {$size = array(0,0,297.64,419.53); break;}
  54              case 'A7': {$size = array(0,0,209.76,297.64); break;}
  55              case 'A8': {$size = array(0,0,147.40,209.76); break;}
  56              case 'A9': {$size = array(0,0,104.88,147.40); break;}
  57              case 'A10': {$size = array(0,0,73.70,104.88); break;}
  58              case 'B0': {$size = array(0,0,2834.65,4008.19); break;}
  59              case 'B1': {$size = array(0,0,2004.09,2834.65); break;}
  60              case 'B2': {$size = array(0,0,1417.32,2004.09); break;}
  61              case 'B3': {$size = array(0,0,1000.63,1417.32); break;}
  62              case 'B4': {$size = array(0,0,708.66,1000.63); break;}
  63              case 'B5': {$size = array(0,0,498.90,708.66); break;}
  64              case 'B6': {$size = array(0,0,354.33,498.90); break;}
  65              case 'B7': {$size = array(0,0,249.45,354.33); break;}
  66              case 'B8': {$size = array(0,0,175.75,249.45); break;}
  67              case 'B9': {$size = array(0,0,124.72,175.75); break;}
  68              case 'B10': {$size = array(0,0,87.87,124.72); break;}
  69              case 'C0': {$size = array(0,0,2599.37,3676.54); break;}
  70              case 'C1': {$size = array(0,0,1836.85,2599.37); break;}
  71              case 'C2': {$size = array(0,0,1298.27,1836.85); break;}
  72              case 'C3': {$size = array(0,0,918.43,1298.27); break;}
  73              case 'C4': {$size = array(0,0,649.13,918.43); break;}
  74              case 'C5': {$size = array(0,0,459.21,649.13); break;}
  75              case 'C6': {$size = array(0,0,323.15,459.21); break;}
  76              case 'C7': {$size = array(0,0,229.61,323.15); break;}
  77              case 'C8': {$size = array(0,0,161.57,229.61); break;}
  78              case 'C9': {$size = array(0,0,113.39,161.57); break;}
  79              case 'C10': {$size = array(0,0,79.37,113.39); break;}
  80              case 'RA0': {$size = array(0,0,2437.80,3458.27); break;}
  81              case 'RA1': {$size = array(0,0,1729.13,2437.80); break;}
  82              case 'RA2': {$size = array(0,0,1218.90,1729.13); break;}
  83              case 'RA3': {$size = array(0,0,864.57,1218.90); break;}
  84              case 'RA4': {$size = array(0,0,609.45,864.57); break;}
  85              case 'SRA0': {$size = array(0,0,2551.18,3628.35); break;}
  86              case 'SRA1': {$size = array(0,0,1814.17,2551.18); break;}
  87              case 'SRA2': {$size = array(0,0,1275.59,1814.17); break;}
  88              case 'SRA3': {$size = array(0,0,907.09,1275.59); break;}
  89              case 'SRA4': {$size = array(0,0,637.80,907.09); break;}
  90              case 'LETTER': {$size = array(0,0,612.00,792.00); break;}
  91              case 'LEGAL': {$size = array(0,0,612.00,1008.00); break;}
  92              case 'EXECUTIVE': {$size = array(0,0,521.86,756.00); break;}
  93              case 'FOLIO': {$size = array(0,0,612.00,936.00); break;}
  94          }
  95          switch (strtolower($orientation)){
  96              case 'landscape':
  97                  $a=$size[3];
  98                  $size[3]=$size[2];
  99                  $size[2]=$a;
 100                  break;
 101          }
 102      } else {
 103          if (count($paper)>2) {
 104              // then an array was sent it to set the size
 105              $size = $paper;
 106          }
 107          else { //size in centimeters has been passed
 108              $size[0] = 0;
 109              $size[1] = 0;
 110              $size[2] = ( $paper[0] / 2.54 ) * 72;
 111              $size[3] = ( $paper[1] / 2.54 ) * 72;
 112          }
 113      }
 114      $this->Cpdf($size);
 115      $this->ez['pageWidth']=$size[2];
 116      $this->ez['pageHeight']=$size[3];
 117      
 118      // also set the margins to some reasonable defaults
 119      $this->ez['topMargin']=30;
 120      $this->ez['bottomMargin']=30;
 121      $this->ez['leftMargin']=30;
 122      $this->ez['rightMargin']=30;
 123      
 124      // set the current writing position to the top of the first page
 125      $this->y = $this->ez['pageHeight']-$this->ez['topMargin'];
 126      // and get the ID of the page that was created during the instancing process.
 127      $this->ezPages[1]=$this->getFirstPageId();
 128      $this->ezPageCount=1;
 129  }
 130  
 131  // ------------------------------------------------------------------------------
 132  // 2002-07-24: Nicola Asuni ([email protected])
 133  // Set Margins in centimeters
 134  function ezSetCmMargins($top,$bottom,$left,$right){
 135      $top = ( $top / 2.54 ) * 72;
 136      $bottom = ( $bottom / 2.54 ) * 72;
 137      $left = ( $left / 2.54 ) * 72;
 138      $right = ( $right / 2.54 ) * 72;
 139      $this->ezSetMargins($top,$bottom,$left,$right);
 140  }
 141  // ------------------------------------------------------------------------------
 142  
 143  
 144  function ezColumnsStart($options=array()){
 145    // start from the current y-position, make the set number of columne
 146    if (isset($this->ez['columns']) && $this->ez['columns']==1){
 147      // if we are already in a column mode then just return.
 148      return;
 149    }
 150    $def=array('gap'=>10,'num'=>2);
 151    foreach($def as $k=>$v){
 152      if (!isset($options[$k])){
 153        $options[$k]=$v;
 154      }
 155    }
 156    // setup the columns
 157    $this->ez['columns']=array('on'=>1,'colNum'=>1);
 158  
 159    // store the current margins
 160    $this->ez['columns']['margins']=array(
 161       $this->ez['leftMargin']
 162      ,$this->ez['rightMargin']
 163      ,$this->ez['topMargin']
 164      ,$this->ez['bottomMargin']
 165    );
 166    // and store the settings for the columns
 167    $this->ez['columns']['options']=$options;
 168    // then reset the margins to suit the new columns
 169    // safe enough to assume the first column here, but start from the current y-position
 170    $this->ez['topMargin']=$this->ez['pageHeight']-$this->y;
 171    $width=($this->ez['pageWidth']-$this->ez['leftMargin']-$this->ez['rightMargin']-($options['num']-1)*$options['gap'])/$options['num'];
 172    $this->ez['columns']['width']=$width;
 173    $this->ez['rightMargin']=$this->ez['pageWidth']-$this->ez['leftMargin']-$width;
 174    
 175  }
 176  // ------------------------------------------------------------------------------
 177  function ezColumnsStop(){
 178    if (isset($this->ez['columns']) && $this->ez['columns']['on']==1){
 179      $this->ez['columns']['on']=0;
 180      $this->ez['leftMargin']=$this->ez['columns']['margins'][0];
 181      $this->ez['rightMargin']=$this->ez['columns']['margins'][1];
 182      $this->ez['topMargin']=$this->ez['columns']['margins'][2];
 183      $this->ez['bottomMargin']=$this->ez['columns']['margins'][3];
 184    }
 185  }
 186  // ------------------------------------------------------------------------------
 187  function ezInsertMode($status=1,$pageNum=1,$pos='before'){
 188    // puts the document into insert mode. new pages are inserted until this is re-called with status=0
 189    // by default pages wil be inserted at the start of the document
 190    switch($status){
 191      case '1':
 192        if (isset($this->ezPages[$pageNum])){
 193          $this->ez['insertMode']=1;
 194          $this->ez['insertOptions']=array('id'=>$this->ezPages[$pageNum],'pos'=>$pos);
 195        }
 196        break;
 197      case '0':
 198        $this->ez['insertMode']=0;
 199        break;
 200    }
 201  }
 202  // ------------------------------------------------------------------------------
 203  
 204  function ezNewPage(){
 205    $pageRequired=1;
 206    if (isset($this->ez['columns']) && $this->ez['columns']['on']==1){
 207      // check if this is just going to a new column
 208      // increment the column number
 209  //echo 'HERE<br>';
 210      $this->ez['columns']['colNum']++;
 211  //echo $this->ez['columns']['colNum'].'<br>';
 212      if ($this->ez['columns']['colNum'] <= $this->ez['columns']['options']['num']){
 213        // then just reset to the top of the next column
 214        $pageRequired=0;
 215      } else {
 216        $this->ez['columns']['colNum']=1;
 217        $this->ez['topMargin']=$this->ez['columns']['margins'][2];
 218      }
 219  
 220      $width = $this->ez['columns']['width'];
 221      $this->ez['leftMargin']=$this->ez['columns']['margins'][0]+($this->ez['columns']['colNum']-1)*($this->ez['columns']['options']['gap']+$width);
 222      $this->ez['rightMargin']=$this->ez['pageWidth']-$this->ez['leftMargin']-$width;
 223    }
 224  //echo 'left='.$this->ez['leftMargin'].'   right='.$this->ez['rightMargin'].'<br>';
 225  
 226    if ($pageRequired){
 227      // make a new page, setting the writing point back to the top
 228      $this->y = $this->ez['pageHeight']-$this->ez['topMargin'];
 229      // make the new page with a call to the basic class.
 230      $this->ezPageCount++;
 231      if (isset($this->ez['insertMode']) && $this->ez['insertMode']==1){
 232        $id = $this->ezPages[$this->ezPageCount] = $this->newPage(1,$this->ez['insertOptions']['id'],$this->ez['insertOptions']['pos']);
 233        // then manipulate the insert options so that inserted pages follow each other
 234        $this->ez['insertOptions']['id']=$id;
 235        $this->ez['insertOptions']['pos']='after';
 236      } else {
 237        $this->ezPages[$this->ezPageCount] = $this->newPage();
 238      }
 239    } else {
 240      $this->y = $this->ez['pageHeight']-$this->ez['topMargin'];
 241    }
 242  }
 243  
 244  // ------------------------------------------------------------------------------
 245  
 246  function ezSetMargins($top,$bottom,$left,$right){
 247    // sets the margins to new values
 248    $this->ez['topMargin']=$top;
 249    $this->ez['bottomMargin']=$bottom;
 250    $this->ez['leftMargin']=$left;
 251    $this->ez['rightMargin']=$right;
 252    // check to see if this means that the current writing position is outside the 
 253    // writable area
 254    if ($this->y > $this->ez['pageHeight']-$top){
 255      // then move y down
 256      $this->y = $this->ez['pageHeight']-$top;
 257    }
 258    if ( $this->y < $bottom){
 259      // then make a new page
 260      $this->ezNewPage();
 261    }
 262  }  
 263  
 264  // ------------------------------------------------------------------------------
 265  
 266  function ezGetCurrentPageNumber(){
 267    // return the strict numbering (1,2,3,4..) number of the current page
 268    return $this->ezPageCount;
 269  }
 270  
 271  // ------------------------------------------------------------------------------
 272  
 273  function ezStartPageNumbers($x,$y,$size,$pos='left',$pattern='{PAGENUM} of {TOTALPAGENUM}',$num=''){
 274    // put page numbers on the pages from here.
 275    // place then on the 'pos' side of the coordinates (x,y).
 276    // pos can be 'left' or 'right'
 277    // use the given 'pattern' for display, where (PAGENUM} and {TOTALPAGENUM} are replaced
 278    // as required.
 279    // if $num is set, then make the first page this number, the number of total pages will
 280    // be adjusted to account for this.
 281    // Adjust this function so that each time you 'start' page numbers then you effectively start a different batch
 282    // return the number of the batch, so that they can be stopped in a different order if required.
 283    if (!$pos || !strlen($pos)){
 284      $pos='left';
 285    }
 286    if (!$pattern || !strlen($pattern)){
 287      $pattern='{PAGENUM} of {TOTALPAGENUM}';
 288    }
 289    if (!isset($this->ez['pageNumbering'])){
 290      $this->ez['pageNumbering']=array();
 291    }
 292    $i = count($this->ez['pageNumbering']);
 293    $this->ez['pageNumbering'][$i][$this->ezPageCount]=array('x'=>$x,'y'=>$y,'pos'=>$pos,'pattern'=>$pattern,'num'=>$num,'size'=>$size);
 294    return $i;
 295  }
 296  
 297  // ------------------------------------------------------------------------------
 298  
 299  function ezWhatPageNumber($pageNum,$i=0){
 300    // given a particular generic page number (ie, document numbered sequentially from beginning),
 301    // return the page number under a particular page numbering scheme ($i)
 302    $num=0;
 303    $start=1;
 304    $startNum=1;
 305    if (!isset($this->ez['pageNumbering']))
 306    {
 307      $this->addMessage('WARNING: page numbering called for and wasn\'t started with ezStartPageNumbers');
 308      return 0;
 309    }
 310    foreach($this->ez['pageNumbering'][$i] as $k=>$v){
 311      if ($k<=$pageNum){
 312        if (is_array($v)){
 313          // start block
 314          if (strlen($v['num'])){
 315            // a start was specified
 316            $start=$v['num'];
 317            $startNum=$k;
 318            $num=$pageNum-$startNum+$start;
 319          }
 320        } else {
 321          // stop block
 322          $num=0;
 323        }
 324      }
 325    }
 326    return $num;
 327  }
 328  
 329  // ------------------------------------------------------------------------------
 330  
 331  function ezStopPageNumbers($stopTotal=0,$next=0,$i=0){
 332    // if stopTotal=1 then the totalling of pages for this number will stop too
 333    // if $next=1, then do this page, but not the next, else do not do this page either
 334    // if $i is set, then stop that particular pagenumbering sequence.
 335    if (!isset($this->ez['pageNumbering'])){
 336      $this->ez['pageNumbering']=array();
 337    }
 338    if ($next && isset($this->ez['pageNumbering'][$i][$this->ezPageCount]) && is_array($this->ez['pageNumbering'][$i][$this->ezPageCount])){
 339      // then this has only just been started, this will over-write the start, and nothing will appear
 340      // add a special command to the start block, telling it to stop as well
 341      if ($stopTotal){
 342        $this->ez['pageNumbering'][$i][$this->ezPageCount]['stoptn']=1;
 343      } else {
 344        $this->ez['pageNumbering'][$i][$this->ezPageCount]['stopn']=1;
 345      }
 346    } else {
 347      if ($stopTotal){
 348        $this->ez['pageNumbering'][$i][$this->ezPageCount]='stopt';
 349      } else {
 350        $this->ez['pageNumbering'][$i][$this->ezPageCount]='stop';
 351      }
 352      if ($next){
 353        $this->ez['pageNumbering'][$i][$this->ezPageCount].='n';
 354      }
 355    }
 356  }
 357  
 358  // ------------------------------------------------------------------------------
 359  
 360  function ezPRVTpageNumberSearch($lbl,&$tmp){
 361    foreach($tmp as $i=>$v){
 362      if (is_array($v)){
 363        if (isset($v[$lbl])){
 364          return $i;
 365        }
 366      } else {
 367        if ($v==$lbl){
 368          return $i;
 369        }
 370      }
 371    }
 372    return 0;
 373  }
 374  
 375  // ------------------------------------------------------------------------------
 376  
 377  function ezPRVTaddPageNumbers(){
 378    // this will go through the pageNumbering array and add the page numbers are required
 379    if (isset($this->ez['pageNumbering'])){
 380      $totalPages1 = $this->ezPageCount;
 381      $tmp1=$this->ez['pageNumbering'];
 382      $status=0;
 383      foreach($tmp1 as $i=>$tmp){
 384        // do each of the page numbering systems
 385        // firstly, find the total pages for this one
 386        $k = $this->ezPRVTpageNumberSearch('stopt',$tmp);
 387        if ($k && $k>0){
 388          $totalPages = $k-1;
 389        } else {
 390          $l = $this->ezPRVTpageNumberSearch('stoptn',$tmp);
 391          if ($l && $l>0){
 392            $totalPages = $l;
 393          } else {
 394            $totalPages = $totalPages1;
 395          }
 396        }
 397        foreach ($this->ezPages as $pageNum=>$id){
 398          if (isset($tmp[$pageNum])){
 399            if (is_array($tmp[$pageNum])){
 400              // then this must be starting page numbers
 401              $status=1;
 402              $info = $tmp[$pageNum];
 403              $info['dnum']=$info['num']-$pageNum;
 404              // also check for the special case of the numbering stopping and starting on the same page
 405              if (isset($info['stopn']) || isset($info['stoptn']) ){
 406                $status=2;
 407              }
 408            } else if ($tmp[$pageNum]=='stop' || $tmp[$pageNum]=='stopt'){
 409              // then we are stopping page numbers
 410              $status=0;
 411            } else if ($status==1 && ($tmp[$pageNum]=='stoptn' || $tmp[$pageNum]=='stopn')){
 412              // then we are stopping page numbers
 413              $status=2;
 414            }
 415          }
 416          if ($status){
 417            // then add the page numbering to this page
 418            if (strlen($info['num'])){
 419              $num=$pageNum+$info['dnum'];
 420            } else {
 421              $num=$pageNum;
 422            }
 423            $total = $totalPages+$num-$pageNum;
 424            $pat = str_replace('{PAGENUM}',$num,$info['pattern']);
 425            $pat = str_replace('{TOTALPAGENUM}',$total,$pat);
 426            $this->reopenObject($id);
 427            switch($info['pos']){
 428              case 'right':
 429                $this->addText($info['x'],$info['y'],$info['size'],$pat);
 430                break;
 431              default:
 432                $w=$this->getTextWidth($info['size'],$pat);
 433                $this->addText($info['x']-$w,$info['y'],$info['size'],$pat);
 434                break;
 435            }
 436            $this->closeObject();
 437          }
 438          if ($status==2){
 439            $status=0;
 440          }
 441        }
 442      }
 443    }
 444  }
 445  
 446  // ------------------------------------------------------------------------------
 447  
 448  function ezPRVTcleanUp(){
 449    $this->ezPRVTaddPageNumbers();
 450  }
 451  
 452  // ------------------------------------------------------------------------------
 453  
 454  function ezStream($options=''){
 455    $this->ezPRVTcleanUp();
 456    $this->stream($options);
 457  }
 458  
 459  // ------------------------------------------------------------------------------
 460  
 461  function ezOutput($options=0){
 462    $this->ezPRVTcleanUp();
 463    return $this->output($options);
 464  }
 465  
 466  // ------------------------------------------------------------------------------
 467  
 468  function ezSetY($y){
 469    // used to change the vertical position of the writing point.
 470    $this->y = $y;
 471    if ( $this->y < $this->ez['bottomMargin']){
 472      // then make a new page
 473      $this->ezNewPage();
 474    }
 475  }
 476  
 477  // ------------------------------------------------------------------------------
 478  
 479  function ezSetDy($dy,$mod=''){
 480    // used to change the vertical position of the writing point.
 481    // changes up by a positive increment, so enter a negative number to go
 482    // down the page
 483    // if $mod is set to 'makeSpace' and a new page is forced, then the pointed will be moved 
 484    // down on the new page, this will allow space to be reserved for graphics etc.
 485    $this->y += $dy;
 486    if ( $this->y < $this->ez['bottomMargin']){
 487      // then make a new page
 488      $this->ezNewPage();
 489      if ($mod=='makeSpace'){
 490        $this->y += $dy;
 491      }
 492    }
 493  }
 494  
 495  // ------------------------------------------------------------------------------
 496  
 497  function ezPrvtTableDrawLines($pos,$gap,$x0,$x1,$y0,$y1,$y2,$col,$inner,$outer,$opt=1){
 498    $x0=1000;
 499    $x1=0;
 500    $this->setStrokeColor($col[0],$col[1],$col[2]);
 501    $cnt=0;
 502    $n = count($pos);
 503    foreach($pos as $x){
 504      $cnt++;
 505      if ($cnt==1 || $cnt==$n){
 506        $this->setLineStyle($outer);
 507      } else {
 508        $this->setLineStyle($inner);
 509      }
 510      $this->line($x-$gap/2,$y0,$x-$gap/2,$y2);
 511      if ($x>$x1){ $x1=$x; };
 512      if ($x<$x0){ $x0=$x; };
 513    }
 514    $this->setLineStyle($outer);
 515    $this->line($x0-$gap/2-$outer/2,$y0,$x1-$gap/2+$outer/2,$y0);
 516    // only do the second line if it is different to the first, AND each row does not have
 517    // a line on it.
 518    if ($y0!=$y1 && $opt<2){
 519      $this->line($x0-$gap/2,$y1,$x1-$gap/2,$y1);
 520    }
 521    $this->line($x0-$gap/2-$outer/2,$y2,$x1-$gap/2+$outer/2,$y2);
 522  }
 523  
 524  // ------------------------------------------------------------------------------
 525  
 526  function ezPrvtTableColumnHeadings($cols,$pos,$maxWidth,$height,$decender,$gap,$size,&$y,$optionsAll=array()){
 527    // uses ezText to add the text, and returns the height taken by the largest heading
 528    // this page will move the headings to a new page if they will not fit completely on this one
 529    // transaction support will be used to implement this
 530  
 531    if (isset($optionsAll['cols'])){
 532      $options = $optionsAll['cols'];
 533    } else {
 534      $options = array();
 535    }
 536    
 537    $mx=0;
 538    $startPage = $this->ezPageCount;
 539    $secondGo=0;
 540  
 541    // $y is the position at which the top of the table should start, so the base
 542    // of the first text, is $y-$height-$gap-$decender, but ezText starts by dropping $height
 543    
 544    // the return from this function is the total cell height, including gaps, and $y is adjusted
 545    // to be the postion of the bottom line
 546    
 547    // begin the transaction
 548    $this->transaction('start');
 549    $ok=0;
 550  //  $y-=$gap-$decender;
 551    $y-=$gap;
 552    while ($ok==0){
 553      foreach($cols as $colName=>$colHeading){
 554        $this->ezSetY($y);
 555        if (isset($options[$colName]) && isset($options[$colName]['justification'])){
 556          $justification = $options[$colName]['justification'];
 557        } else {
 558          $justification = 'left';
 559        }
 560        $this->ezText($colHeading,$size,array('aleft'=> $pos[$colName],'aright'=>($maxWidth[$colName]+$pos[$colName]),'justification'=>$justification));
 561        $dy = $y-$this->y;
 562        if ($dy>$mx){
 563          $mx=$dy;
 564        }
 565      }
 566      $y = $y - $mx - $gap + $decender;
 567  //    $y -= $mx-$gap+$decender;
 568      
 569      // now, if this has moved to a new page, then abort the transaction, move to a new page, and put it there
 570      // do not check on the second time around, to avoid an infinite loop
 571      if ($this->ezPageCount != $startPage && $secondGo==0){
 572        $this->transaction('rewind');
 573        $this->ezNewPage();
 574        $y = $this->y - $gap-$decender;
 575        $ok=0;
 576        $secondGo=1;
 577  //      $y = $store_y;
 578        $mx=0;
 579  
 580      } else {
 581        $this->transaction('commit');
 582        $ok=1;
 583      }
 584    }
 585  
 586    return $mx+$gap*2-$decender;
 587  }
 588  
 589  // ------------------------------------------------------------------------------
 590  
 591  function ezPrvtGetTextWidth($size,$text){
 592    // will calculate the maximum width, taking into account that the text may be broken
 593    // by line breaks.
 594    $mx=0;
 595    $lines = explode("\n",$text);
 596    foreach ($lines as $line){
 597      $w = $this->getTextWidth($size,$line);
 598      if ($w>$mx){
 599        $mx=$w;
 600      }
 601    }
 602    return $mx;
 603  }
 604  
 605  // ------------------------------------------------------------------------------
 606  
 607  function ezTable(&$data,$cols='',$title='',$options=''){
 608    // add a table of information to the pdf document
 609    // $data is a two dimensional array
 610    // $cols (optional) is an associative array, the keys are the names of the columns from $data
 611    // to be presented (and in that order), the values are the titles to be given to the columns
 612    // $title (optional) is the title to be put on the top of the table
 613    //
 614    // $options is an associative array which can contain:
 615    // 'showLines'=> 0,1,2, default is 1 (show outside and top lines only), 2=> lines on each row
 616    // 'showHeadings' => 0 or 1
 617    // 'shaded'=> 0,1,2,3 default is 1 (1->alternate lines are shaded, 0->no shading, 2-> both shaded, second uses shadeCol2)
 618    // 'shadeCol' => (r,g,b) array, defining the colour of the shading, default is (0.8,0.8,0.8)
 619    // 'shadeCol2' => (r,g,b) array, defining the colour of the shading of the other blocks, default is (0.7,0.7,0.7)
 620    // 'fontSize' => 10
 621    // 'textCol' => (r,g,b) array, text colour
 622    // 'titleFontSize' => 12
 623    // 'rowGap' => 2 , the space added at the top and bottom of each row, between the text and the lines
 624    // 'colGap' => 5 , the space on the left and right sides of each cell
 625    // 'lineCol' => (r,g,b) array, defining the colour of the lines, default, black.
 626    // 'xPos' => 'left','right','center','centre',or coordinate, reference coordinate in the x-direction
 627    // 'xOrientation' => 'left','right','center','centre', position of the table w.r.t 'xPos' 
 628    // 'width'=> <number> which will specify the width of the table, if it turns out to not be this
 629    //    wide, then it will stretch the table to fit, if it is wider then each cell will be made
 630    //    proportionalty smaller, and the content may have to wrap.
 631    // 'maxWidth'=> <number> similar to 'width', but will only make table smaller than it wants to be
 632    // 'options' => array(<colname>=>array('justification'=>'left','width'=>100,'link'=>linkDataName),<colname>=>....)
 633    //             allow the setting of other paramaters for the individual columns
 634    // 'minRowSpace'=> the minimum space between the bottom of each row and the bottom margin, in which a new row will be started
 635    //                  if it is less, then a new page would be started, default=-100
 636    // 'innerLineThickness'=>1
 637    // 'outerLineThickness'=>1
 638    // 'splitRows'=>0, 0 or 1, whether or not to allow the rows to be split across page boundaries
 639    // 'protectRows'=>number, the number of rows to hold with the heading on page, ie, if there less than this number of
 640    //                rows on the page, then move the whole lot onto the next page, default=1
 641    //
 642    // note that the user will have had to make a font selection already or this will not 
 643    // produce a valid pdf file.
 644    
 645    if (!is_array($data)){
 646      return;
 647    }
 648    
 649    if (!is_array($cols)){
 650      // take the columns from the first row of the data set
 651      reset($data);
 652      list($k,$v)=each($data);
 653      if (!is_array($v)){
 654        return;
 655      }
 656      $cols=array();
 657      foreach($v as $k1=>$v1){
 658        $cols[$k1]=$k1;
 659      }
 660    }
 661    
 662    if (!is_array($options)){
 663      $options=array();
 664    }
 665  
 666    $defaults = array(
 667      'shaded'=>1,'showLines'=>1,'shadeCol'=>array(0.8,0.8,0.8),'shadeCol2'=>array(0.7,0.7,0.7),'fontSize'=>10,'titleFontSize'=>12
 668      ,'titleGap'=>5,'lineCol'=>array(0,0,0),'gap'=>5,'xPos'=>'centre','xOrientation'=>'centre'
 669      ,'showHeadings'=>1,'textCol'=>array(0,0,0),'width'=>0,'maxWidth'=>0,'cols'=>array(),'minRowSpace'=>-100,'rowGap'=>2,'colGap'=>5
 670      ,'innerLineThickness'=>1,'outerLineThickness'=>1,'splitRows'=>0,'protectRows'=>1
 671      );
 672  
 673    foreach($defaults as $key=>$value){
 674      if (is_array($value)){
 675        if (!isset($options[$key]) || !is_array($options[$key])){
 676          $options[$key]=$value;
 677        }
 678      } else {
 679        if (!isset($options[$key])){
 680          $options[$key]=$value;
 681        }
 682      }
 683    }
 684    $options['gap']=2*$options['colGap'];
 685    
 686    $middle = ($this->ez['pageWidth']-$this->ez['rightMargin'])/2+($this->ez['leftMargin'])/2;
 687    // figure out the maximum widths of the text within each column
 688    $maxWidth=array();
 689    foreach($cols as $colName=>$colHeading){
 690      $maxWidth[$colName]=0;
 691    }
 692    // find the maximum cell widths based on the data
 693    foreach($data as $row){
 694      foreach($cols as $colName=>$colHeading){
 695        $w = $this->ezPrvtGetTextWidth($options['fontSize'],(string)$row[$colName])*1.01;
 696        if ($w > $maxWidth[$colName]){
 697          $maxWidth[$colName]=$w;
 698        }
 699      }
 700    }
 701    // and the maximum widths to fit in the headings
 702    foreach($cols as $colName=>$colTitle){
 703      $w = $this->ezPrvtGetTextWidth($options['fontSize'],(string)$colTitle)*1.01;
 704      if ($w > $maxWidth[$colName]){
 705        $maxWidth[$colName]=$w;
 706      }
 707    }
 708    
 709    // calculate the start positions of each of the columns
 710    $pos=array();
 711    $x=0;
 712    $t=$x;
 713    $adjustmentWidth=0;
 714    $setWidth=0;
 715    foreach($maxWidth as $colName => $w){
 716      $pos[$colName]=$t;
 717      // if the column width has been specified then set that here, also total the
 718      // width avaliable for adjustment
 719      if (isset($options['cols'][$colName]) && isset($options['cols'][$colName]['width']) && $options['cols'][$colName]['width']>0){
 720        $t=$t+$options['cols'][$colName]['width'];
 721        $maxWidth[$colName] = $options['cols'][$colName]['width']-$options['gap'];
 722        $setWidth += $options['cols'][$colName]['width'];
 723      } else {
 724        $t=$t+$w+$options['gap'];
 725        $adjustmentWidth += $w;
 726        $setWidth += $options['gap'];
 727      }
 728    }
 729    $pos['_end_']=$t;
 730  
 731    // if maxWidth is specified, and the table is too wide, and the width has not been set,
 732    // then set the width.
 733    if ($options['width']==0 && $options['maxWidth'] && ($t-$x)>$options['maxWidth']){
 734      // then need to make this one smaller
 735      $options['width']=$options['maxWidth'];
 736    }
 737  
 738    if ($options['width'] && $adjustmentWidth>0 && $setWidth<$options['width']){
 739      // first find the current widths of the columns involved in this mystery
 740      $cols0 = array();
 741      $cols1 = array();
 742      $xq=0;
 743      $presentWidth=0;
 744      $last='';
 745      foreach($pos as $colName=>$p){
 746        if (!isset($options['cols'][$last]) || !isset($options['cols'][$last]['width']) || $options['cols'][$last]['width']<=0){
 747          if (strlen($last)){
 748            $cols0[$last]=$p-$xq -$options['gap'];
 749            $presentWidth += ($p-$xq - $options['gap']);
 750          }
 751        } else {
 752          $cols1[$last]=$p-$xq;
 753        }
 754        $last=$colName;
 755        $xq=$p;
 756      }
 757      // $cols0 contains the widths of all the columns which are not set
 758      $neededWidth = $options['width']-$setWidth;
 759      // if needed width is negative then add it equally to each column, else get more tricky
 760      if ($presentWidth<$neededWidth){
 761        foreach($cols0 as $colName=>$w){
 762          $cols0[$colName]+= ($neededWidth-$presentWidth)/count($cols0);
 763        }
 764      } else {
 765      
 766        $cnt=0;
 767        while ($presentWidth>$neededWidth && $cnt<100){
 768          $cnt++; // insurance policy
 769          // find the widest columns, and the next to widest width
 770          $aWidest = array();
 771          $nWidest=0;
 772          $widest=0;
 773          foreach($cols0 as $colName=>$w){
 774            if ($w>$widest){
 775              $aWidest=array($colName);
 776              $nWidest = $widest;
 777              $widest=$w;
 778            } else if ($w==$widest){
 779              $aWidest[]=$colName;
 780            }
 781          }
 782          // then figure out what the width of the widest columns would have to be to take up all the slack
 783          $newWidestWidth = $widest - ($presentWidth-$neededWidth)/count($aWidest);
 784          if ($newWidestWidth > $nWidest){
 785            // then there is space to set them to this
 786            foreach($aWidest as $colName){
 787              $cols0[$colName] = $newWidestWidth;
 788            }
 789            $presentWidth=$neededWidth;
 790          } else {
 791            // there is not space, reduce the size of the widest ones down to the next size down, and we
 792            // will go round again
 793            foreach($aWidest as $colName){
 794              $cols0[$colName] = $nWidest;
 795            }
 796            $presentWidth=$presentWidth-($widest-$nWidest)*count($aWidest);
 797          }
 798        }
 799      }
 800      // $cols0 now contains the new widths of the constrained columns.
 801      // now need to update the $pos and $maxWidth arrays
 802      $xq=0;
 803      foreach($pos as $colName=>$p){
 804        $pos[$colName]=$xq;
 805        if (!isset($options['cols'][$colName]) || !isset($options['cols'][$colName]['width']) || $options['cols'][$colName]['width']<=0){
 806          if (isset($cols0[$colName])){
 807            $xq += $cols0[$colName] + $options['gap'];
 808            $maxWidth[$colName]=$cols0[$colName];
 809          }
 810        } else {
 811          if (isset($cols1[$colName])){
 812            $xq += $cols1[$colName];
 813          }
 814        }
 815      }
 816  
 817      $t=$x+$options['width'];
 818      $pos['_end_']=$t;
 819    }
 820  
 821    // now adjust the table to the correct location across the page
 822    switch ($options['xPos']){
 823      case 'left':
 824        $xref = $this->ez['leftMargin'];
 825        break;
 826      case 'right':
 827        $xref = $this->ez['pageWidth'] - $this->ez['rightMargin'];
 828        break;
 829      case 'centre':
 830      case 'center':
 831        $xref = $middle;
 832        break;
 833      default:
 834        $xref = $options['xPos'];
 835        break;
 836    }
 837    switch ($options['xOrientation']){
 838      case 'left':
 839        $dx = $xref-$t;
 840        break;
 841      case 'right':
 842        $dx = $xref;
 843        break;
 844      case 'centre':
 845      case 'center':
 846        $dx = $xref-$t/2;
 847        break;
 848    }
 849  
 850  
 851    foreach($pos as $k=>$v){
 852      $pos[$k]=$v+$dx;
 853    }
 854    $x0=$x+$dx;
 855    $x1=$t+$dx;
 856  
 857    $baseLeftMargin = $this->ez['leftMargin'];
 858    $basePos = $pos;
 859    $baseX0 = $x0;
 860    $baseX1 = $x1;
 861    
 862    // ok, just about ready to make me a table
 863    $this->setColor($options['textCol'][0],$options['textCol'][1],$options['textCol'][2]);
 864    $this->setStrokeColor($options['shadeCol'][0],$options['shadeCol'][1],$options['shadeCol'][2]);
 865  
 866    $middle = ($x1+$x0)/2;
 867  
 868    // start a transaction which will be used to regress the table, if there are not enough rows protected
 869    if ($options['protectRows']>0){
 870      $this->transaction('start');
 871      $movedOnce=0;
 872    }
 873    $abortTable = 1;
 874    while ($abortTable){
 875    $abortTable=0;
 876  
 877    $dm = $this->ez['leftMargin']-$baseLeftMargin;
 878    foreach($basePos as $k=>$v){
 879      $pos[$k]=$v+$dm;
 880    }
 881    $x0=$baseX0+$dm;
 882    $x1=$baseX1+$dm;
 883    $middle = ($x1+$x0)/2;
 884  
 885  
 886    // if the title is set, then do that
 887    if (strlen($title)){
 888      $w = $this->getTextWidth($options['titleFontSize'],$title);
 889      $this->y -= $this->getFontHeight($options['titleFontSize']);
 890      if ($this->y < $this->ez['bottomMargin']){
 891        $this->ezNewPage();
 892          // margins may have changed on the newpage
 893          $dm = $this->ez['leftMargin']-$baseLeftMargin;
 894          foreach($basePos as $k=>$v){
 895            $pos[$k]=$v+$dm;
 896          }
 897          $x0=$baseX0+$dm;
 898          $x1=$baseX1+$dm;
 899          $middle = ($x1+$x0)/2;
 900        $this->y -= $this->getFontHeight($options['titleFontSize']);
 901      }
 902      $this->addText($middle-$w/2,$this->y,$options['titleFontSize'],$title);
 903      $this->y -= $options['titleGap'];
 904    }
 905  
 906          // margins may have changed on the newpage
 907          $dm = $this->ez['leftMargin']-$baseLeftMargin;
 908          foreach($basePos as $k=>$v){
 909            $pos[$k]=$v+$dm;
 910          }
 911          $x0=$baseX0+$dm;
 912          $x1=$baseX1+$dm;
 913    
 914    $y=$this->y; // to simplify the code a bit
 915    
 916    // make the table
 917    $height = $this->getFontHeight($options['fontSize']);
 918    $decender = $this->getFontDecender($options['fontSize']);
 919  
 920    
 921    
 922    $y0=$y+$decender;
 923    $dy=0;
 924    if ($options['showHeadings']){
 925      // this function will move the start of the table to a new page if it does not fit on this one
 926      $headingHeight = $this->ezPrvtTableColumnHeadings($cols,$pos,$maxWidth,$height,$decender,$options['rowGap'],$options['fontSize'],$y,$options);
 927      $y0 = $y+$headingHeight;
 928      $y1 = $y;
 929  
 930  
 931      $dm = $this->ez['leftMargin']-$baseLeftMargin;
 932      foreach($basePos as $k=>$v){
 933        $pos[$k]=$v+$dm;
 934      }
 935      $x0=$baseX0+$dm;
 936      $x1=$baseX1+$dm;
 937  
 938    } else {
 939      $y1 = $y0;
 940    }
 941    $firstLine=1;
 942  
 943    
 944    // open an object here so that the text can be put in over the shading
 945    if ($options['shaded']){
 946      $this->saveState();
 947      $textObjectId = $this->openObject();
 948      $this->closeObject();
 949      $this->addObject($textObjectId);
 950      $this->reopenObject($textObjectId);
 951    }
 952    
 953    $cnt=0;
 954    $newPage=0;
 955    foreach($data as $row){
 956      $cnt++;
 957      // the transaction support will be used to prevent rows being split
 958      if ($options['splitRows']==0){
 959        $pageStart = $this->ezPageCount;
 960        if (isset($this->ez['columns']) && $this->ez['columns']['on']==1){
 961          $columnStart = $this->ez['columns']['colNum'];
 962        }
 963        $this->transaction('start');
 964        $row_orig = $row;
 965        $y_orig = $y;
 966        $y0_orig = $y0;
 967        $y1_orig = $y1;
 968      }
 969      $ok=0;
 970      $secondTurn=0;
 971      while(!$abortTable && $ok == 0){
 972  
 973      $mx=0;
 974      $newRow=1;
 975      while(!$abortTable && ($newPage || $newRow)){
 976        
 977        $y-=$height;
 978        if ($newPage || $y<$this->ez['bottomMargin'] || (isset($options['minRowSpace']) && $y<($this->ez['bottomMargin']+$options['minRowSpace'])) ){
 979          // check that enough rows are with the heading
 980          if ($options['protectRows']>0 && $movedOnce==0 && $cnt<=$options['protectRows']){
 981            // then we need to move the whole table onto the next page
 982            $movedOnce = 1;
 983            $abortTable = 1;
 984          }
 985        
 986          $y2=$y-$mx+2*$height+$decender-$newRow*$height;
 987          if ($options['showLines']){
 988            if (!$options['showHeadings']){
 989              $y0=$y1;
 990            }
 991            $this->ezPrvtTableDrawLines($pos,$options['gap'],$x0,$x1,$y0,$y1,$y2,$options['lineCol'],$options['innerLineThickness'],$options['outerLineThickness'],$options['showLines']);
 992          }
 993          if ($options['shaded']){
 994            $this->closeObject();
 995            $this->restoreState();
 996          }
 997          $this->ezNewPage();
 998          // and the margins may have changed, this is due to the possibility of the columns being turned on
 999          // as the columns are managed by manipulating the margins
1000  
1001          $dm = $this->ez['leftMargin']-$baseLeftMargin;
1002          foreach($basePos as $k=>$v){
1003            $pos[$k]=$v+$dm;
1004          }
1005  //        $x0=$x0+$dm;
1006  //        $x1=$x1+$dm;
1007          $x0=$baseX0+$dm;
1008          $x1=$baseX1+$dm;
1009    
1010          if ($options['shaded']){
1011            $this->saveState();
1012            $textObjectId = $this->openObject();
1013            $this->closeObject();
1014            $this->addObject($textObjectId);
1015            $this->reopenObject($textObjectId);
1016          }
1017          $this->setColor($options['textCol'][0],$options['textCol'][1],$options['textCol'][2],1);
1018          $y = $this->ez['pageHeight']-$this->ez['topMargin'];
1019          $y0=$y+$decender;
1020          $mx=0;
1021          if ($options['showHeadings']){
1022            $this->ezPrvtTableColumnHeadings($cols,$pos,$maxWidth,$height,$decender,$options['rowGap'],$options['fontSize'],$y,$options);
1023            $y1=$y;
1024          } else {
1025            $y1=$y0;
1026          }
1027          $firstLine=1;
1028          $y -= $height;
1029        }
1030        $newRow=0;
1031        // write the actual data
1032        // if these cells need to be split over a page, then $newPage will be set, and the remaining
1033        // text will be placed in $leftOvers
1034        $newPage=0;
1035        $leftOvers=array();
1036  
1037        foreach($cols as $colName=>$colTitle){
1038          $this->ezSetY($y+$height);
1039          $colNewPage=0;
1040          if (isset($row[$colName])){
1041            if (isset($options['cols'][$colName]) && isset($options['cols'][$colName]['link']) && strlen($options['cols'][$colName]['link'])){
1042              
1043              $lines = explode("\n",$row[$colName]);
1044              if (isset($row[$options['cols'][$colName]['link']]) && strlen($row[$options['cols'][$colName]['link']])){
1045                foreach($lines as $k=>$v){
1046                  $lines[$k]='<c:alink:'.$row[$options['cols'][$colName]['link']].'>'.$v.'</c:alink>';
1047                }
1048              }
1049            } else {
1050              $lines = explode("\n",$row[$colName]);
1051            }
1052          } else {
1053            $lines = array();
1054          }
1055          $this->y -= $options['rowGap'];
1056          foreach ($lines as $line){
1057            $line = $this->ezProcessText($line);
1058            $start=1;
1059  
1060            while (strlen($line) || $start){
1061              $start=0;
1062              if (!$colNewPage){
1063                $this->y=$this->y-$height;
1064              }
1065              if ($this->y < $this->ez['bottomMargin']){
1066    //            $this->ezNewPage();
1067                $newPage=1;  // whether a new page is required for any of the columns
1068                $colNewPage=1; // whether a new page is required for this column
1069              }
1070              if ($colNewPage){
1071                if (isset($leftOvers[$colName])){
1072                  $leftOvers[$colName].="\n".$line;
1073                } else {
1074                  $leftOvers[$colName] = $line;
1075                }
1076                $line='';
1077              } else {
1078                if (isset($options['cols'][$colName]) && isset($options['cols'][$colName]['justification']) ){
1079                  $just = $options['cols'][$colName]['justification'];
1080                } else {
1081                  $just='left';
1082                }
1083  
1084                $line=$this->addTextWrap($pos[$colName],$this->y,$maxWidth[$colName],$options['fontSize'],$line,$just);
1085              }
1086            }
1087          }
1088    
1089          $dy=$y+$height-$this->y+$options['rowGap'];
1090          if ($dy-$height*$newPage>$mx){
1091            $mx=$dy-$height*$newPage;
1092          }
1093        }
1094        // set $row to $leftOvers so that they will be processed onto the new page
1095        $row = $leftOvers;
1096        // now add the shading underneath
1097        if ($options['shaded'] && $cnt%2==0){
1098          $this->closeObject();
1099          $this->setColor($options['shadeCol'][0],$options['shadeCol'][1],$options['shadeCol'][2],1);
1100          $this->filledRectangle($x0-$options['gap']/2,$y+$decender+$height-$mx,$x1-$x0,$mx);
1101          $this->reopenObject($textObjectId);
1102        }
1103  
1104        if ($options['shaded']==2 && $cnt%2==1){
1105          $this->closeObject();
1106          $this->setColor($options['shadeCol2'][0],$options['shadeCol2'][1],$options['shadeCol2'][2],1);
1107          $this->filledRectangle($x0-$options['gap']/2,$y+$decender+$height-$mx,$x1-$x0,$mx);
1108          $this->reopenObject($textObjectId);
1109        }
1110  
1111        if ($options['showLines']>1){
1112          // then draw a line on the top of each block
1113  //        $this->closeObject();
1114          $this->saveState();
1115          $this->setStrokeColor($options['lineCol'][0],$options['lineCol'][1],$options['lineCol'][2],1);
1116  //        $this->line($x0-$options['gap']/2,$y+$decender+$height-$mx,$x1-$x0,$mx);
1117          if ($firstLine){
1118            $this->setLineStyle($options['outerLineThickness']);
1119            $firstLine=0;
1120          } else {
1121            $this->setLineStyle($options['innerLineThickness']);
1122          }
1123          $this->line($x0-$options['gap']/2,$y+$decender+$height,$x1-$options['gap']/2,$y+$decender+$height);
1124          $this->restoreState();
1125  //        $this->reopenObject($textObjectId);
1126        }
1127      } // end of while 
1128      $y=$y-$mx+$height;
1129      
1130      // checking row split over pages
1131      if ($options['splitRows']==0){
1132        if ( ( ($this->ezPageCount != $pageStart) || (isset($this->ez['columns']) && $this->ez['columns']['on']==1 && $columnStart != $this->ez['columns']['colNum'] ))  && $secondTurn==0){
1133          // then we need to go back and try that again !
1134          $newPage=1;
1135          $secondTurn=1;
1136          $this->transaction('rewind');
1137          $row = $row_orig;
1138          $y = $y_orig;
1139          $y0 = $y0_orig;
1140          $y1 = $y1_orig;
1141          $ok=0;
1142  
1143          $dm = $this->ez['leftMargin']-$baseLeftMargin;
1144          foreach($basePos as $k=>$v){
1145            $pos[$k]=$v+$dm;
1146          }
1147          $x0=$baseX0+$dm;
1148          $x1=$baseX1+$dm;
1149  
1150        } else {
1151          $this->transaction('commit');
1152          $ok=1;
1153        }
1154      } else {
1155        $ok=1;  // don't go round the loop if splitting rows is allowed
1156      }
1157      
1158      }  // end of while to check for row splitting
1159      if ($abortTable){
1160        if ($ok==0){
1161          $this->transaction('abort');
1162        }
1163        // only the outer transaction should be operational
1164        $this->transaction('rewind');
1165        $this->ezNewPage();
1166        break;
1167      }
1168      
1169    } // end of foreach ($data as $row)
1170    
1171    } // end of while ($abortTable)
1172  
1173    // table has been put on the page, the rows guarded as required, commit.
1174    $this->transaction('commit');
1175  
1176    $y2=$y+$decender;
1177    if ($options['showLines']){
1178      if (!$options['showHeadings']){
1179        $y0=$y1;
1180      }
1181      $this->ezPrvtTableDrawLines($pos,$options['gap'],$x0,$x1,$y0,$y1,$y2,$options['lineCol'],$options['innerLineThickness'],$options['outerLineThickness'],$options['showLines']);
1182    }
1183  
1184    // close the object for drawing the text on top
1185    if ($options['shaded']){
1186      $this->closeObject();
1187      $this->restoreState();
1188    }
1189    
1190    $this->y=$y;
1191    return $y;
1192  }
1193  
1194  // ------------------------------------------------------------------------------
1195  function ezProcessText($text){
1196    // this function will intially be used to implement underlining support, but could be used for a range of other
1197    // purposes
1198    $search = array('<u>','<U>','</u>','</U>');
1199    $replace = array('<c:uline>','<c:uline>','</c:uline>','</c:uline>');
1200    return str_replace($search,$replace,$text);
1201  }
1202  
1203  // ------------------------------------------------------------------------------
1204  
1205  function ezText($text,$size=0,$options=array(),$test=0){
1206    // this will add a string of text to the document, starting at the current drawing
1207    // position.
1208    // it will wrap to keep within the margins, including optional offsets from the left
1209    // and the right, if $size is not specified, then it will be the last one used, or
1210    // the default value (12 I think).
1211    // the text will go to the start of the next line when a return code "\n" is found.
1212    // possible options are:
1213    // 'left'=> number, gap to leave from the left margin
1214    // 'right'=> number, gap to leave from the right margin
1215    // 'aleft'=> number, absolute left position (overrides 'left')
1216    // 'aright'=> number, absolute right position (overrides 'right')
1217    // 'justification' => 'left','right','center','centre','full'
1218  
1219    // only set one of the next two items (leading overrides spacing)
1220    // 'leading' => number, defines the total height taken by the line, independent of the font height.
1221    // 'spacing' => a real number, though usually set to one of 1, 1.5, 2 (line spacing as used in word processing)
1222    
1223    // 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
1224    
1225    // apply the filtering which will make the underlining function.
1226    $text = $this->ezProcessText($text);
1227    
1228    $newPage=false;
1229    $store_y = $this->y;
1230    
1231    if (is_array($options) && isset($options['aleft'])){
1232      $left=$options['aleft'];
1233    } else {
1234      $left = $this->ez['leftMargin'] + ((is_array($options) && isset($options['left']))?$options['left']:0);
1235    }
1236    if (is_array($options) && isset($options['aright'])){
1237      $right=$options['aright'];
1238    } else {
1239      $right = $this->ez['pageWidth'] - $this->ez['rightMargin'] - ((is_array($options) && isset($options['right']))?$options['right']:0);
1240    }
1241    if ($size<=0){
1242      $size = $this->ez['fontSize'];
1243    } else {
1244      $this->ez['fontSize']=$size;
1245    }
1246    
1247    if (is_array($options) && isset($options['justification'])){
1248      $just = $options['justification'];
1249    } else {
1250      $just = 'left';
1251    }
1252    
1253    // modifications to give leading and spacing based on those given by Craig Heydenburg 1/1/02
1254    if (is_array($options) && isset($options['leading'])) { ## use leading instead of spacing
1255      $height = $options['leading'];
1256      } else if (is_array($options) && isset($options['spacing'])) {
1257      $height = $this->getFontHeight($size) * $options['spacing'];
1258      } else {
1259          $height = $this->getFontHeight($size);
1260      }
1261  
1262    
1263    $lines = explode("\n",$text);
1264    foreach ($lines as $line){
1265      $start=1;
1266      while (strlen($line) || $start){
1267        $start=0;
1268        $this->y=$this->y-$height;
1269        if ($this->y < $this->ez['bottomMargin']){
1270          if ($test){
1271            $newPage=true;
1272          } else {
1273            $this->ezNewPage();
1274            // and then re-calc the left and right, in case they have changed due to columns
1275          }
1276        }
1277        if (is_array($options) && isset($options['aleft'])){
1278          $left=$options['aleft'];
1279        } else {
1280          $left = $this->ez['leftMargin'] + ((is_array($options) && isset($options['left']))?$options['left']:0);
1281        }
1282        if (is_array($options) && isset($options['aright'])){
1283          $right=$options['aright'];
1284        } else {
1285          $right = $this->ez['pageWidth'] - $this->ez['rightMargin'] - ((is_array($options) && isset($options['right']))?$options['right']:0);
1286        }
1287        $line=$this->addTextWrap($left,$this->y,$right-$left,$size,$line,$just,0,$test);
1288      }
1289    }
1290  
1291    if ($test){
1292      $this->y=$store_y;
1293      return $newPage;
1294    } else {
1295      return $this->y;
1296    }
1297  }
1298  
1299  // ------------------------------------------------------------------------------
1300  
1301  function ezImage($image,$pad = 5,$width = 0,$resize = 'full',$just = 'center',$border = ''){
1302      //beta ezimage function
1303      if (stristr($image,'://'))//copy to temp file
1304      {
1305          $fp = @fopen($image,"rb");
1306          while(!feof($fp))
1307             {
1308                    $cont.= fread($fp,1024);
1309             }
1310             fclose($fp);
1311          $image = tempnam ("/tmp", "php-pdf");
1312          $fp2 = @fopen($image,"w");
1313             fwrite($fp2,$cont);
1314            fclose($fp2);
1315          $temp = true;
1316      }
1317  
1318      if (!(file_exists($image))) return false; //return immediately if image file does not exist
1319      $imageInfo = getimagesize($image);
1320      switch ($imageInfo[2]){
1321          case 2:
1322              $type = "jpeg";
1323              break;
1324          case 3:
1325              $type = "png";
1326              break;
1327          default:
1328              return false; //return if file is not jpg or png
1329      }
1330      if ($width == 0) $width = $imageInfo[0]; //set width
1331      $ratio = $imageInfo[0]/$imageInfo[1];
1332  
1333      //get maximum width of image
1334      if (isset($this->ez['columns']) && $this->ez['columns']['on'] == 1)
1335      {
1336          $bigwidth = $this->ez['columns']['width'] - ($pad * 2);
1337      }
1338      else
1339      {
1340          $bigwidth = $this->ez['pageWidth'] - ($pad * 2);
1341      }
1342      //fix width if larger than maximum or if $resize=full
1343      if ($resize == 'full' || $resize == 'width' || $width > $bigwidth)
1344      {
1345          $width = $bigwidth;
1346  
1347      }
1348  
1349      $height = ($width/$ratio); //set height
1350  
1351      //fix size if runs off page
1352      if ($height > ($this->y - $this->ez['bottomMargin'] - ($pad * 2)))
1353      {
1354          if ($resize != 'full')
1355          {
1356              $this->ezNewPage();
1357          }
1358          else
1359          {
1360              $height = ($this->y - $this->ez['bottomMargin'] - ($pad * 2)); //shrink height
1361              $width = ($height*$ratio); //fix width
1362          }
1363      }
1364  
1365      //fix x-offset if image smaller than bigwidth
1366      if ($width < $bigwidth)
1367      {
1368          //center if justification=center
1369          if ($just == 'center')
1370          {
1371              $offset = ($bigwidth - $width) / 2;
1372          }
1373          //move to right if justification=right
1374          if ($just == 'right')
1375          {
1376              $offset = ($bigwidth - $width);
1377          }
1378          //leave at left if justification=left
1379          if ($just == 'left')
1380          {
1381              $offset = 0;
1382          }
1383      }
1384  
1385  
1386      //call appropriate function
1387      if ($type == "jpeg"){
1388          $this->addJpegFromFile($image,$this->ez['leftMargin'] + $pad + $offset, $this->y + $this->getFontHeight($this->ez['fontSize']) - $pad - $height,$width);
1389      }
1390  
1391      if ($type == "png"){
1392          $this->addPngFromFile($image,$this->ez['leftMargin'] + $pad + $offset, $this->y + $this->getFontHeight($this->ez['fontSize']) - $pad - $height,$width);
1393      }
1394      //draw border
1395      if ($border != '')
1396      {
1397      if (!(isset($border['color'])))
1398      {
1399          $border['color']['red'] = .5;
1400          $border['color']['blue'] = .5;
1401          $border['color']['green'] = .5;
1402      }
1403      if (!(isset($border['width']))) $border['width'] = 1;
1404      if (!(isset($border['cap']))) $border['cap'] = 'round';
1405      if (!(isset($border['join']))) $border['join'] = 'round';
1406      
1407  
1408      $this->setStrokeColor($border['color']['red'],$border['color']['green'],$border['color']['blue']);
1409      $this->setLineStyle($border['width'],$border['cap'],$border['join']);
1410      $this->rectangle($this->ez['leftMargin'] + $pad + $offset, $this->y + $this->getFontHeight($this->ez['fontSize']) - $pad - $height,$width,$height);
1411  
1412      }
1413      // move y below image
1414      $this->y = $this->y - $pad - $height;
1415      //remove tempfile for remote images
1416      if ($temp == true) unlink($image);
1417  
1418  }
1419  // ------------------------------------------------------------------------------
1420  
1421  // note that templating code is still considered developmental - have not really figured
1422  // out a good way of doing this yet.
1423  function loadTemplate($templateFile){
1424    // this function will load the requested template ($file includes full or relative pathname)
1425    // the code for the template will be modified to make it name safe, and then stored in 
1426    // an array for later use
1427    // The id of the template will be returned for the user to operate on it later
1428    if (!file_exists($templateFile)){
1429      return -1;
1430    }
1431  
1432    $code = implode('',file($templateFile));
1433    if (!strlen($code)){
1434      return;
1435    }
1436  
1437    $code = trim($code);
1438    if (substr($code,0,5)=='<?php'){
1439      $code = substr($code,5);
1440    }
1441    if (substr($code,-2)=='?>'){
1442      $code = substr($code,0,strlen($code)-2);
1443    }
1444    if (isset($this->ez['numTemplates'])){
1445      $newNum = $this->ez['numTemplates'];
1446      $this->ez['numTemplates']++;
1447    } else {
1448      $newNum=0;
1449      $this->ez['numTemplates']=1;
1450      $this->ez['templates']=array();
1451    }
1452  
1453    $this->ez['templates'][$newNum]['code']=$code;
1454  
1455    return $newNum;
1456  }
1457  
1458  // ------------------------------------------------------------------------------
1459  
1460  function execTemplate($id,$data=array(),$options=array()){
1461    // execute the given template on the current document.
1462    if (!isset($this->ez['templates'][$id])){
1463      return;
1464    }
1465    eval($this->ez['templates'][$id]['code']);
1466  }
1467  
1468  // ------------------------------------------------------------------------------
1469  function ilink($info){
1470    $this->alink($info,1);
1471  }
1472  
1473  function alink($info,$internal=0){
1474    // a callback function to support the formation of clickable links within the document
1475    $lineFactor=0.05; // the thickness of the line as a proportion of the height. also the drop of the line.
1476    switch($info['status']){
1477      case 'start':
1478      case 'sol':
1479        // the beginning of the link
1480        // this should contain the URl for the link as the 'p' entry, and will also contain the value of 'nCallback'
1481        if (!isset($this->ez['links'])){
1482          $this->ez['links']=array();
1483        }
1484        $i = $info['nCallback'];
1485        $this->ez['links'][$i] = array('x'=>$info['x'],'y'=>$info['y'],'angle'=>$info['angle'],'decender'=>$info['decender'],'height'=>$info['height'],'url'=>$info['p']);
1486        if ($internal==0){
1487          $this->saveState();
1488          $this->setColor(0,0,1);
1489          $this->setStrokeColor(0,0,1);
1490          $thick = $info['height']*$lineFactor;
1491          $this->setLineStyle($thick);
1492        }
1493        break;
1494      case 'end':
1495      case 'eol':
1496        // the end of the link
1497        // assume that it is the most recent opening which has closed
1498        $i = $info['nCallback'];
1499        $start = $this->ez['links'][$i];
1500        // add underlining
1501        if ($internal){
1502          $this->addInternalLink($start['url'],$start['x'],$start['y']+$start['decender'],$info['x'],$start['y']+$start['decender']+$start['height']);
1503        } else {
1504          $a = deg2rad((float)$start['angle']-90.0);
1505          $drop = $start['height']*$lineFactor*1.5;
1506          $dropx = cos($a)*$drop;
1507          $dropy = -sin($a)*$drop;
1508          $this->line($start['x']-$dropx,$start['y']-$dropy,$info['x']-$dropx,$info['y']-$dropy);
1509          $this->addLink($start['url'],$start['x'],$start['y']+$start['decender'],$info['x'],$start['y']+$start['decender']+$start['height']);
1510          $this->restoreState();
1511        }
1512        break;
1513    }
1514  }
1515  
1516  // ------------------------------------------------------------------------------
1517  
1518  function uline($info){
1519    // a callback function to support underlining
1520    $lineFactor=0.05; // the thickness of the line as a proportion of the height. also the drop of the line.
1521    switch($info['status']){
1522      case 'start':
1523      case 'sol':
1524      
1525        // the beginning of the underline zone
1526        if (!isset($this->ez['links'])){
1527          $this->ez['links']=array();
1528        }
1529        $i = $info['nCallback'];
1530        $this->ez['links'][$i] = array('x'=>$info['x'],'y'=>$info['y'],'angle'=>$info['angle'],'decender'=>$info['decender'],'height'=>$info['height']);
1531        $this->saveState();
1532        $thick = $info['height']*$lineFactor;
1533        $this->setLineStyle($thick);
1534        break;
1535      case 'end':
1536      case 'eol':
1537        // the end of the link
1538        // assume that it is the most recent opening which has closed
1539        $i = $info['nCallback'];
1540        $start = $this->ez['links'][$i];
1541        // add underlining
1542        $a = deg2rad((float)$start['angle']-90.0);
1543        $drop = $start['height']*$lineFactor*1.5;
1544        $dropx = cos($a)*$drop;
1545        $dropy = -sin($a)*$drop;
1546        $this->line($start['x']-$dropx,$start['y']-$dropy,$info['x']-$dropx,$info['y']-$dropy);
1547        $this->restoreState();
1548        break;
1549    }
1550  }
1551  
1552  // ------------------------------------------------------------------------------
1553  
1554  /** 
1555  * draws a rounded rectangle 
1556  * similar to rectangle, but rounds the corners of the rectangle using the given radius 
1557  * the last parameter, if set to 1, will fill the path rather than stroke it 
1558  */ 
1559  function roundedRectangle($x1,$y1,$width,$height,$rad,$f=0) { 
1560  $x2 = $x1+$width; 
1561  $y2 = $y1+$height; 
1562  $rad2 = $rad/2; 
1563  $string = sprintf("%.3f %.3f m ", $x1+$rad, $y1); 
1564  $string.= sprintf("%.3f %.3f l ", $x2-$rad, $y1); 
1565  $string.= sprintf("%.3f %.3f %.3f %.3f %.3f %.3f c ", $x2-$rad2, $y1, $x2, $y1+$rad2, $x2, $y1+$rad); 
1566  $string.= sprintf("%.3f %.3f l ", $x2, $y2-$rad); 
1567  $string.= sprintf("%.3f %.3f %.3f %.3f %.3f %.3f c ", $x2, $y2-$rad2, $x2-$rad2, $y2, $x2-$rad, $y2); 
1568  $string.= sprintf("%.3f %.3f l ", $x1+$rad, $y2); 
1569  $string.= sprintf("%.3f %.3f %.3f %.3f %.3f %.3f c ", $x1+$rad2, $y2, $x1, $y2-$rad2, $x1, $y2-$rad); 
1570  $string.= sprintf("%.3f %.3f l ", $x1, $y1+$rad); 
1571  $string.= sprintf("%.3f %.3f %.3f %.3f %.3f %.3f c ", $x1, $y1+$rad2, $x1+$rad2, $y1, $x1+$rad, $y1); 
1572  $string.= ($f==1 ? 'f' : 'S'); 
1573  $this->addContent("\n".$string); 
1574  } 
1575  
1576  
1577  
1578  
1579  
1580  
1581  
1582  
1583  
1584  
1585  
1586  }
1587  ?>


Generated: Fri Jan 1 13:43:16 2010 Cross-referenced by PHPXref 0.7