<?php
//
// Created on: <26-Aug-2003 15:15:32 kk>
//
// SOFTWARE NAME: eZ Publish
// SOFTWARE RELEASE: 4.1.3
// BUILD VERSION: 23650
// COPYRIGHT NOTICE: Copyright (C) 1999-2009 eZ Systems AS
// SOFTWARE LICENSE: GNU General Public License v2.0
// NOTICE: >
//   This program is free software; you can redistribute it and/or
//   modify it under the terms of version 2.0  of the GNU General
//   Public License as published by the Free Software Foundation.
//
//   This program is distributed in the hope that it will be useful,
//   but WITHOUT ANY WARRANTY; without even the implied warranty of
//   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//   GNU General Public License for more details.
//
//   You should have received a copy of version 2.0 of the GNU General
//   Public License along with this program; if not, write to the Free
//   Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
//   MA 02110-1301, USA.
//
//

/*! \file
*/

/*!
  \class Cpdf class.pdf.php
  \ingroup eZPDF
  \brief Cpdf provides
*/

class Cpdf
{

    /**
     * the current number of pdf objects in the document
     */
    public $numObj = 0;

    /**
     * this array contains all of the pdf objects, ready for final assembly
     */
    public $objects = array();

    /**
     * the objectId (number within the objects array) of the document catalog
     */
    public $catalogId;

    /**
     * array carrying information about the fonts that the system currently knows about
     * used to ensure that a font is not loaded twice, among other things
     */
    public $fonts = array();

    /**
     * a record of the current font
     */
    public $currentFont = '';

    /**
     * the current base font
     */
    public $currentBaseFont = '';

    /**
     * the number of the current font within the font array
     */
    public $currentFontNum = 0;

    /**
     *
     */
    public $currentNode;

    /**
     * object number of the current page
     */
    public $currentPage;

    /**
     * object number of the currently active contents block
     */
    public $currentContents;

    /**
     * number of fonts within the system
     */
    public $numFonts = 0;

    /**
     * current colour for fill operations, defaults to inactive value, all three components should be between 0 and 1 inclusive when active
     */
    public $currentColour;

    /**
     * current colour for stroke operations (lines etc.)
     */
    public $currentStrokeColour;

    /**
     * current style that lines are drawn in
     */
    public $currentLineStyle = '';

    /**
     * an array which is used to save the state of the document, mainly the colours and styles
     * it is used to temporarily change to another state, the change back to what it was before
     */
    public $stateStack = array();

    /**
     * number of elements within the state stack
     */
    public $nStateStack = 0;

    /**
     * number of page objects within the document
     */
    public $numPages = 0;

    /**
     * object Id storage stack
     */
    public $stack = array();

    /**
     * number of elements within the object Id storage stack
     */
    public $nStack = 0;

    /**
     * an array which contains information about the objects which are not firmly attached to pages
     * these have been added with the addObject function
     */
    public $looseObjects = array();

    /**
     * array contains infomation about how the loose objects are to be added to the document
     */
    public $addLooseObjects = array();

    /**
     * the objectId of the information object for the document
     * this contains authorship, title etc.
     */
    public $infoObject = 0;

    /**
     * number of images being tracked within the document
     */
    public $numImages = 0;

    /**
     * an array containing options about the document
     * it defaults to turning on the compression of the objects
     */
    public $options = array( 'compression' => 1 );

    /**
     * the objectId of the first page of the document
     */
    public $firstPageId;

    /**
     * used to track the last used value of the inter-word spacing, this is so that it is known
     * when the spacing is changed.
     */
    public $wordSpaceAdjust = 0;

    /**
     * the object Id of the procset object
     */
    public $procsetObjectId;

    /**
     * store the information about the relationship between font families
     * this used so that the code knows which font is the bold version of another font, etc.
     * the value of this array is initialised in the constuctor function.
     */
    public $fontFamilies = array();

    /**
     * track if the current font is bolded or italicised
     */
    public $currentTextState = '';

    /**
     * messages are stored here during processing, these can be selected afterwards to give some useful debug information
     */
    public $messages = '';

    /**
     * the ancryption array for the document encryption is stored here
     */
    public $arc4 = '';

    /**
     * the object Id of the encryption information
     */
    public $arc4_objnum = 0;

    /**
     * the file identifier, used to uniquely identify a pdf document
     */
    public $fileIdentifier = '';

    /**
     * a flag to say if a document is to be encrypted or not
     */
    public $encrypted = 0;

    /**
     * the ancryption key for the encryption of all the document content (structure is not encrypted)
     */
    public $encryptionKey = '';

    /**
     * array which forms a stack to keep track of nested callback functions
     */
    public $callback = array();

    /**
     * the number of callback functions in the callback array
     */
    public $nCallback = 0;

    /**
     * store label->id pairs for named destinations, these will be used to replace internal links
     * done this way so that destinations can be defined after the location that links to them
     */
    public $destinations = array();

    /**
     * store the stack for the transaction commands, each item in here is a record of the values of all the
     * variables within the class, so that the user can rollback at will (from each 'start' command)
     * note that this includes the objects array, so these can be large.
     */
    public $checkpoint = '';

    /**
     * class constructor
     * this will start a new document
     * @var array array of 4 numbers, defining the bottom left and upper right corner of the page. first two are normally zero.
     */
    function Cpdf ( $pageSize = array( 0, 0, 612, 792 ) )
    {
        $this->currentColour = eZMath::rgbToCMYK( array( 'r' => -1,
                                                         'g' => -1,
                                                         'b' => -1 ) );
        $this->currentStrokeColour = eZMath::rgbToCMYK( array( 'r' => -1,
                                                               'g' => -1,
                                                               'b' => -1 ) );

        $this->newDocument( $pageSize );

        // also initialize the font families that are known about already
        $this->setFontFamily( 'init' );
        //  $this->fileIdentifier = md5('xxxxxxxx'.time());

    }

    /**
     * Document object methods (internal use only)
     *
     * There is about one object method for each type of object in the pdf document
     * Each function has the same call list ($id,$action,$options).
     * $id = the object ID of the object, or what it is to be if it is being created
     * $action = a string specifying the action to be performed, though ALL must support:
     *           'new' - create the object with the id $id
     *           'out' - produce the output for the pdf object
     * $options = optional, a string or array containing the various parameters for the object
     *
     * These, in conjunction with the output function are the ONLY way for output to be produced
     * within the pdf 'file'.
     */

    /**
     *destination object, used to specify the location for the user to jump to, presently on opening
     */
    function o_destination( $id, $action, $options = '' )
    {
        if ( $action != 'new' )
        {
            $o =& $this->objects[$id];
        }
        switch ( $action )
        {
            case 'new':
                $this->objects[$id] = array( 't' => 'destination', 'info' => array() );
                $tmp = '';
                switch ( $options['type'] )
                {
                case 'XYZ':
                case 'FitR':
                    $tmp =  ' ' . sprintf( '%.3F', $options['p3'] ) . $tmp;
                case 'FitV':
                case 'FitBH':
                case 'FitBV':
                    $tmp =  ' ' . sprintf( '%.3F', $options['p2'] ) . $tmp;
                case 'Fit':
                case 'FitH':
                    $tmp =  ' ' . sprintf( '%.3F', $options['p1'] ) . $tmp;
                case 'FitB':
                    $tmp = $options['type'] . $tmp;
                    $this->objects[$id]['info']['string'] = $tmp;
                    $this->objects[$id]['info']['page'] = $options['page'];
                }break;

            case 'out':
                $tmp = $o['info'];
                $res = "\n" . $id . " 0 obj\n" . '[' . $tmp['page'] . ' 0 R /' . $tmp['string'] . "]\nendobj\n";
                return $res;
                break;
        }
    }

    /**
     * set the viewer preferences
     */
    function o_viewerPreferences( $id, $action, $options = '' )
    {
        if ( $action != 'new' )
        {
            $o =& $this->objects[$id];
        }
        switch ( $action )
        {
        case 'new':
            $this->objects[$id] = array( 't' => 'viewerPreferences', 'info' => array() );
            break;
        case 'add':
            foreach ( $options as $k => $v )
            {
                switch ( $k )
                {
                case 'HideToolbar':
                case 'HideMenubar':
                case 'HideWindowUI':
                case 'FitWindow':
                case 'CenterWindow':
                case 'NonFullScreenPageMode':
                case 'Direction':
                    $o['info'][$k] = $v;
                    break;
                }
            }break;
        case 'out':
            $res = "\n" . $id . " 0 obj\n" . '<< ';
            foreach($o['info'] as $k=>$v)
            {
                $res .= "\n/" . $k . ' ' . $v;
            }
            $res .= "\n>>\n";
            return $res;
            break;
        }
    }

    /**
     * define the document catalog, the overall controller for the document
     */
    function o_catalog( $id, $action, $options = '' )
    {
        if ( $action != 'new' )
        {
            $o =& $this->objects[$id];
        }
        switch ( $action )
        {
        case 'new':
            $this->objects[$id] = array( 't' => 'catalog', 'info' => array() );
            $this->catalogId = $id;
            break;
        case 'outlines':
        case 'pages':
        case 'openHere':
            $o['info'][$action] = $options;
            break;
        case 'viewerPreferences':
            if ( !isset( $o['info']['viewerPreferences'] ) )
            {
                $this->numObj++;
                $this->o_viewerPreferences( $this->numObj, 'new' );
                $o['info']['viewerPreferences'] = $this->numObj;
            }
            $vp = $o['info']['viewerPreferences'];
            $this->o_viewerPreferences( $vp, 'add', $options );
            break;
        case 'out':
            $res= "\n" . $id . " 0 obj\n" . '<< /Type /Catalog';
            foreach ( $o['info'] as $k => $v )
            {
                switch ( $k )
                {
                case 'outlines':
                    $res .= "\n" . '/Outlines ' . $v . ' 0 R';
                    break;
                case 'pages':
                    $res .= "\n" . '/Pages ' . $v . ' 0 R';
                    break;
                case 'viewerPreferences':
                    $res .= "\n" . '/ViewerPreferences ' . $o['info']['viewerPreferences'] . ' 0 R';
                    break;
                case 'openHere':
                    $res .= "\n" . '/OpenAction ' . $o['info']['openHere'] . ' 0 R';
                    break;
                }
            }
            $res .= " >>\nendobj";
            return $res;
            break;
        }
    }

    /**
     * object which is a parent to the pages in the document
     */
    function o_pages( $id, $action, $options = '' )
    {
        if ($action!='new')
        {
            $o =& $this->objects[$id];
        }
        switch ( $action )
        {
        case 'new':
            $this->objects[$id] = array( 't' => 'pages', 'info' => array() );
            $this->o_catalog( $this->catalogId, 'pages', $id );
            break;
        case 'page':
            if ( !is_array( $options ) )
            {
                // then it will just be the id of the new page
                $o['info']['pages'][] = $options;
            }
            else
            {
                // then it should be an array having 'id','rid','pos', where rid=the page to which this one will be placed relative
                // and pos is either 'before' or 'after', saying where this page will fit.
                if ( isset( $options['id'] ) && isset( $options['rid'] ) && isset( $options['pos'] ) )
                {
                    $i = array_search( $options['rid'], $o['info']['pages'] );
                    if ( isset( $o['info']['pages'][$i] ) && $o['info']['pages'][$i] == $options['rid'])
                    {
                        // then there is a match
                        // make a space
                        switch ( $options['pos'] )
                        {
                        case 'before':
                            $k = $i;
                            break;
                        case 'after':
                            $k = $i + 1;
                            break;
                        default:
                            $k = -1;
                            break;
                        }
                        if ( $k >= 0 )
                        {
                            for ( $j = count( $o['info']['pages'] ) - 1; $j >= $k; $j-- )
                            {
                                $o['info']['pages'][$j+1] = $o['info']['pages'][$j];
                            }
                            $o['info']['pages'][$k] = $options['id'];
                        }
                    }
                }
            }break;

        case 'procset':
            $o['info']['procset'] = $options;
            break;
        case 'mediaBox':
            $o['info']['mediaBox'] = $options; // which should be an array of 4 numbers
            break;
        case 'font':
            $o['info']['fonts'][] = array( 'objNum' => $options['objNum'], 'fontNum' => $options['fontNum'] );
            break;
        case 'shading':
            $o['info']['shading'][] = array( 'objNum' => $options['objNum'], 'label' => $options['label'] );
            break;
        case 'xObject':
            $o['info']['xObjects'][] = array( 'objNum' => $options['objNum'], 'label' => $options['label'] );
            break;
        case 'out':
            if ( count( $o['info']['pages'] ) )
            {
                $res = "\n" . $id . " 0 obj\n<< /Type /Pages\n/Kids [";
                foreach ( $o['info']['pages'] as $k => $v )
                {
                    $res .= $v . " 0 R\n";
                }
                $res .= "]\n/Count " . count( $this->objects[$id]['info']['pages'] );
                if ( ( isset( $o['info']['fonts'] ) && count( $o['info']['fonts'] ) ) || isset( $o['info']['procset'] ) )
                {
                    $res .= "\n/Resources <<";
                    if ( isset( $o['info']['procset'] ) )
                    {
                        $res .= "\n/ProcSet " . $o['info']['procset'] . " 0 R";
                    }
                    if ( isset( $o['info']['fonts'] ) && count( $o['info']['fonts'] ) )
                    {
                        $res .= "\n/Font << ";
                        foreach ( $o['info']['fonts'] as $finfo )
                        {
                            $res .= "\n/F" . $finfo['fontNum'] . " " . $finfo['objNum'] . " 0 R";
                        }
                        $res .= " >>";
                    }

                    if ( isset( $o['info']['shading'] ) && count( $o['info']['shading'] ) )
                    {
                        $res .= "\n/Shading <<";
                        foreach ( $o['info']['shading'] as $finfo )
                        {
                            $res .= "\n/" . $finfo['label'] . " " . $finfo['objNum'] . " 0 R";
                        }
                        $res .= " >>";
                    }

                    if ( isset( $o['info']['xObjects'] ) && count( $o['info']['xObjects'] ) )
                    {
                        $res .= "\n/XObject << ";
                        foreach ( $o['info']['xObjects'] as $finfo )
                        {
                            $res .= "\n/" . $finfo['label'] . " " . $finfo['objNum'] . " 0 R";
                        }
                        $res .= " >>";
                    }
                    $res .= "\n>>";
                    if ( isset( $o['info']['mediaBox'] ) )
                    {
                        $tmp = $o['info']['mediaBox'];
                        $res .= "\n/MediaBox [" . sprintf( '%.3F', $tmp[0] ) . ' ' . sprintf( '%.3F', $tmp[1] ) . ' ' . sprintf( '%.3F', $tmp[2] ) . ' ' . sprintf( '%.3F', $tmp[3] ) . ']';
                    }
                }
                $res.="\n >>\nendobj";
            }
            else
            {
                $res = "\n" . $id . " 0 obj\n<< /Type /Pages\n/Count 0\n>>\nendobj";
            }
            return $res;
            break;
        }
    }

    /**
     * define the outlines in the doc, empty for now
     */
    function o_outlines( $id, $action, $options = '' )
    {
        if ( $action != 'new' )
        {
            $o =& $this->objects[$id];
        }
        switch ( $action )
        {
        case 'new':
            $this->objects[$id] = array( 't' => 'outlines', 'info' => array( 'outlines' => array() ) );
            $this->o_catalog( $this->catalogId, 'outlines', $id );
            break;
        case 'outline':
            $o['info']['outlines'][] = $options;
            break;
        case 'out':
            if ( count( $o['info']['outlines'] ) )
            {
                $res = "\n" . $id . " 0 obj\n<< /Type /Outlines /Kids [";
                foreach ( $o['info']['outlines'] as $k => $v )
                {
                    $res .= $v . " 0 R ";
                }
                $res .= "] /Count " . count( $o['info']['outlines'] ) . " >>\nendobj";
            }
            else
            {
                $res = "\n" . $id . " 0 obj\n<< /Type /Outlines /Count 0 >>\nendobj";
            }
            return $res;
            break;
        }
    }

    /**
      Add object to hold Function properties
      Only partial support for type 0, 3 and 4

     \param object id.
     \param action
     \param options
     */
    function o_function( $id, $action, $options = '' )
    {
        if ( $action != 'new' )
        {
            $o =& $this->objects[$id];
        }

        switch ( $action )
        {
            case 'new':
            {
                $this->objects[$id] = array ( 't' => 'function',
                                              'info' => array() );

                if ( isset( $options['type'] ) ) // Set function type
                {
                    $this->objects[$id]['info']['type'] = $options['type'];
                }
                else
                {
                    $this->objects[$id]['info']['type'] = '2';
                }

                if ( isset( $options['Domain'] ) ) // Set function Domain
                {
                    $this->objects[$id]['info']['Domain'] = $options['Domain'];
                }
                else
                {
                    $this->objects[$id]['info']['Domain'] = '[0.0 1.0]';
                }

                if ( $this->objects[$id]['info']['type'] == '2' ) // set start and en values
                {
                    if ( isset( $options['C0'] ) ) // Set values0
                    {
                        $this->objects[$id]['info']['C0'] = $options['C0'];
                    }

                    if ( isset( $options['C1'] ) ) // Set values1
                    {
                        $this->objects[$id]['info']['C1'] = $options['C1'];
                    }

                    if ( isset( $options['N'] ) ) // set exponent
                    {
                        $this->objects[$id]['info']['N'] = $options['N'];
                    }
                    else
                    {
                        $this->objects[$id]['info']['N'] = '1.0';
                    }
                }

            } break;

            case 'out':
            {
                $res = "\n" . $id . " 0 obj\n<< ";
                $res.= "/FunctionType " . $o['info']['type'] . "\n";
                $res.= "/Domain " . $o['info']['Domain'] . "\n";
                if ( isset ( $o['info']['C0'] ) )
                    $res.= "/C0 " . $o['info']['C0'] . "\n";
                if ( isset ( $o['info']['C1'] ) )
                    $res.= "/C1 " . $o['info']['C1'] . "\n";
                $res.= "/N " . $o['info']['N'] . "\n";
                $res.= ">>\nendobject";
                return $res;
            } break;
        }
    }

    /**
      Add object to hold pattern properties

     \param object id.
     \param action
     \param options

     \return action 'new' - dictionary name
            'out' - pdf output
     */
    function o_pattern( $id, $action, $options = '' )
    {
        if ( $action != 'new' )
        {
            $o =& $this->objects[$id];
        }

        switch ( $action )
        {
            case 'new':
            {
                $this->objects[$id] = array( 't' => 'shading',
                                             'info' => array() );

                if ( isset( $options['type'] ) ) //Set pattern type
                {
                    $this->objects[$id]['info']['PatternType'] = $options['type'];
                }
                else
                {
                    $this->objects[$id]['info']['PatternType'] = '2';
                }

                if ( isset( $options['matrix'] ) )
                {
                    $this->objects[$id]['info']['Matrix'] = '[ ';
                    foreach ( $options['matrix'] as $coord )
                    {
                        $this->objects[$id]['info']['Matrix'] .= sprintf( ' %.3F ', $coord );
                    }
                    $this->objects[$id]['info']['Matrix'] .= ' ]';
                }

                if ( $this->objects[$id]['info']['PatternType'] == 1 ) // Pattern type 1, tiling pattern
                {
                    $this->objects[$id]['info']['PaintType'] = $options['paintType'];
                    $this->objects[$id]['info']['TilingType'] = $options['tilingType'];

                    $this->objects[$id]['info']['BBox'] = '[ ';
                    foreach ( $options['bbox'] as $coord )
                    {
                        $this->objects[$id]['info']['BBox'] .= sprintf( ' %.3F ', $coord );
                    }
                    $this->objects[$id]['info']['BBox'] .= ']';

                    $this->objects[$id]['info']['XStep'] = $options['xstep'];
                    $this->objects[$id]['info']['YStep'] = $options['ystep'];
                }
                else // Non tiling, smooth pattern.
                {
                    if ( isset( $options['shading'] ) )
                    {
                        $this->objects[$id]['info']['Shading'] = $options['shading'] . ' R';
                    }
                }
            } break;

            case 'out':
            {
                $res = "\n" . $id . " 0 obj\n<< ";
                foreach ( $this->objects[$id]['info'] as $key => $info )
                {
                    $res .= '/' . $key . ' ' . $info[$key] . "\n";
                }
                $res .= ">>\nendobject";
                return $res;
            } break;
        }
    } //TODO: Add pattern too


    /**
      Add object to hold shading properties

     \param object id.
     \param action
     \param options

     \return action 'new' - dictionary name
            'out' - pdf output
     */
    function o_shading( $id, $action, $options = '' )
    {
        if ( $action != 'new' )
        {
            $o =& $this->objects[$id];
        }

        switch ( $action )
        {
            case 'new':
            {
                $this->objects[$id] = array( 't' => 'shading',
                                             'info' => array( 'type' => '2',
                                                              'ColorSpace' => '/DeviceCMYK' ) );

            if ( !isset( $options['orientation'] ) )
            {
                $options['orientation'] = 'vertical';
            }

            if ( $options['orientation'] == 'horizontal' )
            {
                $angle = 0;
            }
            else if ( $options['orientation'] == 'vertical' )
            {
                $angle = deg2rad( 90 );
            }
            else // orientation is an angle
            {
                $angle = $options['orientation'];
            }

            $this->objects[$id]['info']['Coords'] = '[ '.  // compute angle of gradient chading
                 sprintf( '%.3F', $options['size']['x1'] ) . ' ' .
                 sprintf( '%.3F', $options['size']['y1'] + $options['size']['height'] ) . ' ' .
                 sprintf( '%.3F', $options['size']['x1'] + $options['size']['width'] * cos( $angle ) ) . ' ' .
                 sprintf( '%.3F', $options['size']['y1'] + $options['size']['height'] * ( 1 - sin( $angle ) ) ) . ']';

            //$this->objects[$id]['info']['Coords'] = '[0.0 0.0 50.0 50.0]';

            if ( is_array( $options['color0'] ) ) //Set chading colors
            {
                if ( count( $options['color0'] ) == 3 )
                {
                    $options['color0'] = eZMath::rgbToCMYK( $options['color0'] );
                }
                $color0 = array ( 'c' => sprintf( '%.3F', $options['color0']['c'] ),
                                  'm' => sprintf( '%.3F', $options['color0']['m'] ),
                                  'y' => sprintf( '%.3F', $options['color0']['y'] ),
                                  'k' => sprintf( '%.3F', $options['color0']['k'] ) );
            }
            else
            {
                $color0 = eZMath::rgbToCMYK2( 0, 0, 0 );
            }
            if ( is_array( $options['color1'] ) )
            {
                if ( count( $options['color1'] ) == 3 )
                {
                    $options['color1'] = eZMath::rgbToCMYK( $options['color1'] );
                }
                $color1 = array ( 'c' => sprintf( '%.3F', $options['color1']['c'] ),
                                  'm' => sprintf( '%.3F', $options['color1']['m'] ),
                                  'y' => sprintf( '%.3F', $options['color1']['y'] ),
                                  'k' => sprintf( '%.3F', $options['color1']['k'] ) );
            }
            else
            {
                $color1 = eZMath::rgbToCMYK2( 1, 1, 1 );
            }

            $this->numObj++;
            $this->objects[$id]['info']['Function'] = $this->numObj;
            $this->o_function( $this->numObj, 'new', array ( 'type' => '2',
                                                             'Domain' => '[0.0 1.0]',
                                                             'C0' => '['.$color0['c'].' '.$color0['m'].' '.$color0['y'].' '.$color0['k'].']',
                                                             'C1' => '['.$color1['c'].' '.$color1['m'].' '.$color1['y'].' '.$color1['k'].']',
                                                             'N' => '1.0' ) );
            $this->objects[$id]['info']['Extend'] = '[true true]';
            // also tell the pages node about the new shading
            $this->o_pages( $this->currentNode, 'shading', array( 'label' => 'Sh' . $id,
                                                                  'objNum'=> $id ) );
            return 'Sh' . $id;
            } break;

            case 'out':
            {
                $res = "\n" . $id . " 0 obj\n<< ";
                $res.= "/ShadingType " . $o['info']['type'] . "\n";
                $res.= "/ColorSpace " . $o['info']['ColorSpace'] . "\n";
                $res.= "/Coords " . $o['info']['Coords'] . "\n";
                $res.= "/Function " . $o['info']['Function'] . " 0 R\n";
                $res.= "/Extend " . $o['info']['Extend'] . "\n";
                $res.= ">>\nendobject";
                return $res;
            } break;
        }
    }

    /**
     * an object to hold the font description
     */
    function o_font( $id, $action, $options = '' )
    {
        if ( $action != 'new' )
        {
            $o =& $this->objects[$id];
        }
        switch ( $action )
        {
        case 'new':
            $this->objects[$id] = array( 't' => 'font',
                                         'info' => array( 'name' => $options['name'],
                                                          'SubType' => 'Type1' ) );
            $fontNum = $this->numFonts;
            $this->objects[$id]['info']['fontNum'] = $fontNum;
            // deal with the encoding and the differences
            if ( isset( $options['differences'] ) )
            {
                // then we'll need an encoding dictionary
                $this->numObj++;
                $this->o_fontEncoding( $this->numObj, 'new', $options );
                $this->objects[$id]['info']['encodingDictionary'] = $this->numObj;
            }
            else if ( isset( $options['encoding'] ) )
            {
                // we can specify encoding here
                switch ( $options['encoding'] )
                {
                case 'WinAnsiEncoding':
                case 'MacRomanEncoding':
                case 'MacExpertEncoding':
                    $this->objects[$id]['info']['encoding'] = $options['encoding'];
                    break;
                case 'none':
                    break;
                default:
                    $this->objects[$id]['info']['encoding'] = 'WinAnsiEncoding';
                    break;
                }
            }
            else
            {
                $this->objects[$id]['info']['encoding'] = 'WinAnsiEncoding';
            }
            // also tell the pages node about the new font
            $this->o_pages( $this->currentNode, 'font', array( 'fontNum' => $fontNum, 'objNum' => $id ) );
            break;

        case 'add':
            foreach ( $options as $k => $v )
            {
                switch ( $k )
                {
                case 'BaseFont':
                    $o['info']['name'] = $v;
                    break;
                case 'FirstChar':
                case 'LastChar':
                case 'Widths':
                case 'FontDescriptor':
                case 'SubType':
                    $this->addMessage( 'o_font ' . $k . " : " . $v );
                    $o['info'][$k] = $v;
                    break;
                }
            }
            break;

        case 'out':
            $res = "\n" . $id . " 0 obj\n<< /Type /Font\n/Subtype /" . $o['info']['SubType'] . "\n";
            $res.= "/Name /F" . $o['info']['fontNum'] . "\n";
            $res.= "/BaseFont /" . $o['info']['name'] . "\n";
            if ( isset( $o['info']['encodingDictionary'] ) )
            {
                // then place a reference to the dictionary
                $res.= "/Encoding " . $o['info']['encodingDictionary'] . " 0 R\n";
            }
            else if ( isset( $o['info']['encoding'] ) )
            {
                // use the specified encoding
                $res.= "/Encoding /" . $o['info']['encoding'] . "\n";
            }
            if ( isset($o['info']['FirstChar'] ) )
            {
                $res.= "/FirstChar " . $o['info']['FirstChar'] . "\n";
            }
            if ( isset( $o['info']['LastChar'] ) )
            {
                $res.= "/LastChar " . $o['info']['LastChar'] . "\n";
            }
            if ( isset( $o['info']['Widths'] ) )
            {
                $res.= "/Widths " . $o['info']['Widths'] . " 0 R\n";
            }
            if ( isset( $o['info']['FontDescriptor'] ) )
            {
                $res.= "/FontDescriptor " . $o['info']['FontDescriptor'] . " 0 R\n";
            }
            $res.= ">>\nendobj";
            return $res;
            break;
        }
    }

/**
 * a font descriptor, needed for including additional fonts
 */
    function o_fontDescriptor( $id, $action, $options = '')
    {
        if ( $action != 'new' )
        {
            $o =& $this->objects[$id];
        }
        switch ( $action )
        {
        case 'new':
            $this->objects[$id] = array( 't' => 'fontDescriptor', 'info' => $options );
            break;
        case 'out':
            $res = "\n" . $id . " 0 obj\n<< /Type /FontDescriptor\n";
            foreach ( $o['info'] as $label => $value )
            {
                switch ( $label )
                {
                case 'Ascent':
                case 'CapHeight':
                case 'Descent':
                case 'Flags':
                case 'ItalicAngle':
                case 'StemV':
                case 'AvgWidth':
                case 'Leading':
                case 'MaxWidth':
                case 'MissingWidth':
                case 'StemH':
                case 'XHeight':
                case 'CharSet':
                    if ( strlen( $value ) )
                    {
                        $res.= '/'.$label.' '.$value."\n";
                    }
                    break;
                case 'FontFile':
                case 'FontFile2':
                case 'FontFile3':
                    $res.= '/'.$label.' '.$value." 0 R\n";
                    break;
                case 'FontBBox':
                    $res.= '/'.$label.' ['.$value[0].' '.$value[1].' '.$value[2].' '.$value[3]."]\n";
                    break;
                case 'FontName':
                    $res.= '/'.$label.' /'.$value."\n";
                    break;
                }
            }
            $res .= ">>\nendobj";
            return $res;
            break;
        }
    }

    /**
     * the font encoding
     */
    function o_fontEncoding( $id, $action, $options = '' )
    {
        if ( $action != 'new' )
        {
            $o =& $this->objects[$id];
        }
        switch ( $action )
        {
        case 'new':
            // the options array should contain 'differences' and maybe 'encoding'
            $this->objects[$id] = array( 't' => 'fontEncoding',
                                         'info' => $options );
            break;
        case 'out':
            $res = "\n" . $id . " 0 obj\n<< /Type /Encoding\n";
            if ( !isset( $o['info']['encoding'] ) )
            {
                $o['info']['encoding'] = 'WinAnsiEncoding';
            }
            if ( $o['info']['encoding'] != 'none' )
            {
                $res.= "/BaseEncoding /" . $o['info']['encoding'] . "\n";
            }
            $res.= "/Differences \n[";
            $onum = -100;
            foreach ( $o['info']['differences'] as $num => $label )
            {
                if ($num!=$onum+1)
                {
                    // we cannot make use of consecutive numbering
                    $res.= "\n".$num." /".$label;
                }
                else
                {
                    $res.= " /".$label;
                }
                $onum = $num;
            }
            $res .= "\n]\n>>\nendobj";
            return $res;
            break;
        }
    }

/**
 * the document procset, solves some problems with printing to old PS printers
 */
    function o_procset( $id, $action, $options = '' )
    {
        if ( $action != 'new' )
        {
            $o =& $this->objects[$id];
        }
        switch ( $action )
        {
        case 'new':
            $this->objects[$id] = array( 't' => 'procset',
                                         'info' => array( 'PDF' => 1, 'Text' => 1 ) );
            $this->o_pages( $this->currentNode, 'procset', $id );
            $this->procsetObjectId = $id;
            break;
        case 'add':
            // this is to add new items to the procset list, despite the fact that this is considered
            // obselete, the items are required for printing to some postscript printers
            switch ( $options )
            {
            case 'ImageB':
            case 'ImageC':
            case 'ImageI':
                $o['info'][$options] = 1;
                break;
            }
            break;
        case 'out':
            $res = "\n" . $id . " 0 obj\n[";
            foreach ( $o['info'] as $label => $val )
            {
                $res .= '/'.$label.' ';
            }
            $res .= "]\nendobj";
            return $res;
            break;
        }
    }

    /**
     * define the document information
     */
    function o_info( $id, $action, $options = '' )
    {
        if ( $action != 'new' )
        {
            $o =& $this->objects[$id];
        }
        switch ($action)
        {
        case 'new':
            $this->infoObject = $id;
            $date = 'D:' . date( 'Ymd' );
            $this->objects[$id] = array( 't' => 'info',
                                         'info' => array( 'Creator' => 'eZ Publish CMS, http://ez.no',
                                                          'CreationDate' => $date ) );
            break;
        case 'Title':
        case 'Author':
        case 'Subject':
        case 'Keywords':
        case 'Creator':
        case 'Producer':
        case 'CreationDate':
        case 'ModDate':
        case 'Trapped':
            $o['info'][$action]=$options;
            break;
        case 'out':
            if ( $this->encrypted )
            {
                $this->encryptInit( $id );
            }
            $res = "\n" . $id . " 0 obj\n<<\n";
            foreach ( $o['info']  as $k => $v )
            {
                $res .= '/' . $k . ' (';
                if ( $this->encrypted )
                {
                    $res .= $this->filterText( $this->ARC4( $v ) );
                }
                else
                {
                    $res .= $this->filterText( $v );
                }
                $res .= ")\n";
            }
            $res .= ">>\nendobj";
            return $res;
            break;
        }
    }

/**
 * an action object, used to link to URLS initially
 */
    function o_action( $id, $action, $options = '' )
    {
        if ( $action != 'new' )
        {
            $o =& $this->objects[$id];
        }
        switch ( $action )
        {
        case 'new':
            if ( is_array( $options ) )
            {
                $this->objects[$id] = array( 't' => 'action',
                                             'info' => $options,
                                             'type' => $options['type'] );
            }
            else
            {
                // then assume a URI action
                $this->objects[$id] = array( 't' => 'action',
                                             'info' => $options,
                                             'type' => 'URI' );
            }
            break;
        case 'out':
            if ( $this->encrypted )
            {
                $this->encryptInit( $id );
            }
            $res = "\n" . $id . " 0 obj\n<< /Type /Action";
            switch( $o['type'] )
            {
            case 'ilink':
                // there will be an 'label' setting, this is the name of the destination
                //$res.="\n/S /GoTo\n/D [".$this->destinations[(string)$o['info']['label']]." 0 R /Fit]";
                $res .= "\n/S /GoTo\n/D [" . $this->objects[ $this->destinations[ (string)$o['info']['label'] ] ]['info']['page'] . " 0 R /" .
                        $this->objects[ $this->destinations[ (string)$o['info']['label'] ] ]['info']['string'] . ']';
                break;
            case 'URI':
                $res .= "\n/S /URI\n/URI (";
                if ( $this->encrypted )
                {
                    $res .= $this->filterText( $this->ARC4( $o['info'] ) );
                }
                else
                {
                    $res .= $this->filterText( $o['info'] );
                }
                $res .= ")";
                break;
            }
            $res .= "\n>>\nendobj";
            return $res;
            break;
        }
    }

/**
 * an annotation object, this will add an annotation to the current page.
 * initially will support just link annotations
 */
    function o_annotation( $id, $action, $options = '' )
    {
        if ( $action != 'new' )
        {
            $o =& $this->objects[$id];
        }
        switch ( $action )
        {
        case 'new':
            // add the annotation to the current page
            $pageId = $this->currentPage;
            $this->o_page( $pageId, 'annot', $id);
            // and add the action object which is going to be required
            switch ( $options['type'] )
            {
            case 'link':
                $this->objects[$id] = array( 't' => 'annotation', 'info' => $options );
                $this->numObj++;
                $this->o_action( $this->numObj, 'new', $options['url'] );
                $this->objects[$id]['info']['actionId'] = $this->numObj;
                break;
            case 'ilink':
                // this is to a named internal link
                $label = $options['label'];
                $this->objects[$id] = array( 't' => 'annotation', 'info' => $options );
                $this->numObj++;
                $this->o_action( $this->numObj, 'new', array( 'type' => 'ilink', 'label' => $label ) );
                $this->objects[$id]['info']['actionId'] = $this->numObj;
                break;
            }
            break;

        case 'out':
            $res = "\n" . $id . " 0 obj\n<< /Type /Annot";
            switch ( $o['info']['type'] )
            {
            case 'link':
            case 'ilink':
                $res.= "\n/Subtype /Link";
                break;
            }
            $res.= "\n/A ".$o['info']['actionId']." 0 R";
            $res.= "\n/Border [0 0 0]";
            $res.= "\n/H /I";
            $res.= "\n/Rect [ ";
            foreach ( $o['info']['rect'] as $v )
            {
                $res.= sprintf( "%.4F ", $v );
            }
            $res.= "]";
            $res.= "\n>>\nendobj";
            return $res;
            break;
        }
    }

/**
 * a page object, it also creates a contents object to hold its contents
 */
    function o_page($id,$action,$options=''){
    if ($action!='new'){
        $o =& $this->objects[$id];
    }
    switch ($action){
        case 'new':
        $this->numPages++;
        $this->objects[$id]=array('t'=>'page','info'=>array('parent'=>$this->currentNode,'pageNum'=>$this->numPages));
        if (is_array($options)){
        // then this must be a page insertion, array shoudl contain 'rid','pos'=[before|after]
        $options['id']=$id;
        $this->o_pages($this->currentNode,'page',$options);
        } else {
        $this->o_pages($this->currentNode,'page',$id);
        }
        $this->currentPage=$id;
        //make a contents object to go with this page
        $this->numObj++;
        $this->o_contents($this->numObj,'new',$id);
        $this->currentContents=$this->numObj;
        $this->objects[$id]['info']['contents']=array();
        $this->objects[$id]['info']['contents'][]=$this->numObj;
        $match = ($this->numPages%2 ? 'odd' : 'even');
        foreach($this->addLooseObjects as $oId=>$target){
        if ($target=='all' || $match==$target){
            $this->objects[$id]['info']['contents'][]=$oId;
        }
        }
        break;
        case 'content':
        $o['info']['contents'][]=$options;
        break;
        case 'annot':
        // add an annotation to this page
        if (!isset($o['info']['annot'])){
            $o['info']['annot']=array();
        }
        // $options should contain the id of the annotation dictionary
        $o['info']['annot'][]=$options;
        break;
        case 'out':
        $res="\n".$id." 0 obj\n<< /Type /Page";
        $res.="\n/Parent ".$o['info']['parent']." 0 R";
        if (isset($o['info']['annot'])){
        $res.="\n/Annots [";
        foreach($o['info']['annot'] as $aId){
            $res.=" ".$aId." 0 R";
        }
        $res.=" ]";
        }
        $count = count($o['info']['contents']);
        if ($count==1){
        $res.="\n/Contents ".$o['info']['contents'][0]." 0 R";
        } else if ($count>1){
        $res.="\n/Contents [\n";
        foreach ($o['info']['contents'] as $cId){
            $res.=$cId." 0 R\n";
        }
        $res.="]";
        }
        $res.="\n>>\nendobj";
        return $res;
        break;
    }
    }

/**
 * the contents objects hold all of the content which appears on pages
 */
    function o_contents($id,$action,$options=''){
    if ($action!='new'){
        $o =& $this->objects[$id];
    }
    switch ($action){
        case 'new':
        $this->objects[$id]=array('t'=>'contents','c'=>'','info'=>array());
        if (strlen($options) && intval($options)){
        // then this contents is the primary for a page
        $this->objects[$id]['onPage']=$options;
        } else if ($options=='raw'){
        // then this page contains some other type of system object
        $this->objects[$id]['raw']=1;
        }
        break;
        case 'add':
        // add more options to the decleration
        foreach ($options as $k=>$v){
            $o['info'][$k]=$v;
        }
        case 'out':
        $tmp=$o['c'];
        $res= "\n".$id." 0 obj\n";
        if (isset($this->objects[$id]['raw'])){
        $res.=$tmp;
        } else {
        $res.= "<<";
        if (function_exists('gzcompress') && $this->options['compression']){
            // then implement ZLIB based compression on this content stream
            $res.=" /Filter /FlateDecode";
            $tmp = gzcompress($tmp);
        }
        if ($this->encrypted){
            $this->encryptInit($id);
            $tmp = $this->ARC4($tmp);
        }
        foreach($o['info'] as $k=>$v){
            $res .= "\n/".$k.' '.$v;
        }
        $res.="\n/Length ".strlen($tmp)." >>\nstream\n".$tmp."\nendstream";
        }
        $res.="\nendobj\n";
        return $res;
        break;
    }
    }

/**
 * an image object, will be an XObject in the document, includes description and data
 */
    function o_image($id,$action,$options=''){
    if ($action!='new'){
        $o =& $this->objects[$id];
    }
    switch($action){
        case 'new':
        // make the new object
        $this->objects[$id]=array('t'=>'image','data'=>$options['data'],'info'=>array());
        $this->objects[$id]['info']['Type']='/XObject';
        $this->objects[$id]['info']['Subtype']='/Image';
        $this->objects[$id]['info']['Width']=$options['iw'];
        $this->objects[$id]['info']['Height']=$options['ih'];
        if (!isset($options['type']) || $options['type']=='jpg'){
        if (!isset($options['channels'])){
            $options['channels']=3;
        }
        switch($options['channels']){
            case 1:
            $this->objects[$id]['info']['ColorSpace']='/DeviceGray';
            break;
            default:
            $this->objects[$id]['info']['ColorSpace']='/DeviceRGB';
            break;
        }
        $this->objects[$id]['info']['Filter']='/DCTDecode';
        $this->objects[$id]['info']['BitsPerComponent']=8;
        } else if ($options['type']=='png'){
        $this->objects[$id]['info']['Filter']='/FlateDecode';
        $this->objects[$id]['info']['DecodeParms']='<< /Predictor 15 /Colors '.$options['ncolor'].' /Columns '.$options['iw'].' /BitsPerComponent '.$options['bitsPerComponent'].'>>';
        if (strlen($options['pdata'])){
            $tmp = ' [ /Indexed /DeviceCMYK '.(strlen($options['pdata'])/3-1).' ';
            $this->numObj++;
            $this->o_contents($this->numObj,'new');
            $this->objects[$this->numObj]['c']=$options['pdata'];
            $tmp.=$this->numObj.' 0 R';
            $tmp .=' ]';
            $this->objects[$id]['info']['ColorSpace'] = $tmp;
            if (isset($options['transparency'])){
            switch($options['transparency']['type']){
                case 'indexed':
                $tmp=' [ '.$options['transparency']['data'].' '.$options['transparency']['data'].'] ';
                $this->objects[$id]['info']['Mask'] = $tmp;
                break;
            }
            }
        } else {
            $this->objects[$id]['info']['ColorSpace']='/'.$options['color'];
        }
        $this->objects[$id]['info']['BitsPerComponent']=$options['bitsPerComponent'];
        }
        // assign it a place in the named resource dictionary as an external object, according to
        // the label passed in with it.
        $this->o_pages($this->currentNode,'xObject',array('label'=>$options['label'],'objNum'=>$id));
        // also make sure that we have the right procset object for it.
        $this->o_procset($this->procsetObjectId,'add','ImageC');
        break;
        case 'out':
        $tmp=$o['data'];
        $res= "\n".$id." 0 obj\n<<";
        foreach($o['info'] as $k=>$v){
        $res.="\n/".$k.' '.$v;
        }
        if ($this->encrypted){
        $this->encryptInit($id);
        $tmp = $this->ARC4($tmp);
        }
        $res.="\n/Length ".strlen($tmp)." >>\nstream\n".$tmp."\nendstream\nendobj\n";
        return $res;
        break;
    }
    }

/**
 * encryption object.
 */
    function o_encryption($id,$action,$options=''){
    if ($action!='new'){
        $o =& $this->objects[$id];
    }
    switch($action){
        case 'new':
        // make the new object
        $this->objects[$id]=array('t'=>'encryption','info'=>$options);
        $this->arc4_objnum=$id;
        // figure out the additional paramaters required
        $pad = chr(0x28).chr(0xBF).chr(0x4E).chr(0x5E).chr(0x4E).chr(0x75).chr(0x8A).chr(0x41).chr(0x64).chr(0x00).chr(0x4E).chr(0x56).chr(0xFF).chr(0xFA).chr(0x01).chr(0x08).chr(0x2E).chr(0x2E).chr(0x00).chr(0xB6).chr(0xD0).chr(0x68).chr(0x3E).chr(0x80).chr(0x2F).chr(0x0C).chr(0xA9).chr(0xFE).chr(0x64).chr(0x53).chr(0x69).chr(0x7A);
        $len = strlen($options['owner']);
        if ($len>32){
        $owner = substr($options['owner'],0,32);
        } else if ($len<32){
        $owner = $options['owner'].substr($pad,0,32-$len);
        } else {
        $owner = $options['owner'];
        }
        $len = strlen($options['user']);
        if ($len>32){
        $user = substr($options['user'],0,32);
        } else if ($len<32){
        $user = $options['user'].substr($pad,0,32-$len);
        } else {
        $user = $options['user'];
        }
        $tmp = $this->md5_16($owner);
        $okey = substr($tmp,0,5);
        $this->ARC4_init($okey);
        $ovalue=$this->ARC4($user);
        $this->objects[$id]['info']['O']=$ovalue;
        // now make the u value, phew.
        $tmp = $this->md5_16($user.$ovalue.chr($options['p']).chr(255).chr(255).chr(255).$this->fileIdentifier);
        $ukey = substr($tmp,0,5);

        $this->ARC4_init($ukey);
        $this->encryptionKey = $ukey;
        $this->encrypted=1;
        $uvalue=$this->ARC4($pad);

        $this->objects[$id]['info']['U']=$uvalue;
        $this->encryptionKey=$ukey;

        // initialize the arc4 array
        break;
        case 'out':
        $res= "\n".$id." 0 obj\n<<";
        $res.="\n/Filter /Standard";
        $res.="\n/V 1";
        $res.="\n/R 2";
        $res.="\n/O (".$this->filterText($o['info']['O']).')';
        $res.="\n/U (".$this->filterText($o['info']['U']).')';
        // and the p-value needs to be converted to account for the twos-complement approach
        $o['info']['p'] = (($o['info']['p']^255)+1)*-1;
        $res.="\n/P ".($o['info']['p']);
        $res.="\n>>\nendobj\n";

        return $res;
        break;
    }
    }

/**
 * ARC4 functions
 * A series of function to implement ARC4 encoding in PHP
 */

/**
 * calculate the 16 byte version of the 128 bit md5 digest of the string
 */
    function md5_16($string){
    $tmp = md5($string);
    $out='';
    for ($i=0;$i<=30;$i=$i+2){
        $out.=chr(hexdec(substr($tmp,$i,2)));
    }
    return $out;
    }

/**
 * initialize the encryption for processing a particular object
 */
    function encryptInit($id){
    $tmp = $this->encryptionKey;
    $hex = dechex($id);
    if (strlen($hex)<6){
        $hex = substr('000000',0,6-strlen($hex)).$hex;
    }
    $tmp.= chr(hexdec(substr($hex,4,2))).chr(hexdec(substr($hex,2,2))).chr(hexdec(substr($hex,0,2))).chr(0).chr(0);
    $key = $this->md5_16($tmp);
    $this->ARC4_init(substr($key,0,10));
    }

/**
 * initialize the ARC4 encryption
 */
    function ARC4_init($key=''){
    $this->arc4 = '';
    // setup the control array
    if (strlen($key)==0){
        return;
    }
    $k = '';
    while(strlen($k)<256){
        $k.=$key;
    }
    $k=substr($k,0,256);
    for ($i=0;$i<256;$i++){
        $this->arc4 .= chr($i);
    }
    $j=0;
    for ($i=0;$i<256;$i++){
        $t = $this->arc4[$i];
        $j = ($j + ord($t) + ord($k[$i]))%256;
        $this->arc4[$i]=$this->arc4[$j];
        $this->arc4[$j]=$t;
    }
    }

/**
 * ARC4 encrypt a text string
 */
    function ARC4($text){
    $len=strlen($text);
    $a=0;
    $b=0;
    $c = $this->arc4;
    $out='';
    for ($i=0;$i<$len;$i++){
        $a = ($a+1)%256;
        $t= $c[$a];
        $b = ($b+ord($t))%256;
        $c[$a]=$c[$b];
        $c[$b]=$t;
        $k = ord($c[(ord($c[$a])+ord($c[$b]))%256]);
        $out.=chr(ord($text[$i]) ^ $k);
    }

    return $out;
    }

/**
 * functions which can be called to adjust or add to the document
 */

/**
 * add a link in the document to an external URL
 */
    function addLink($url,$x0,$y0,$x1,$y1){
    $this->numObj++;
    $info = array('type'=>'link','url'=>$url,'rect'=>array($x0,$y0,$x1,$y1));
    $this->o_annotation($this->numObj,'new',$info);
    }

/**
 * add a link in the document to an internal destination (ie. within the document)
 */
    function addInternalLink($label,$x0,$y0,$x1,$y1){
    $this->numObj++;
    $info = array('type'=>'ilink','label'=>$label,'rect'=>array($x0,$y0,$x1,$y1));
    $this->o_annotation($this->numObj,'new',$info);
    }

/**
 * set the encryption of the document
 * can be used to turn it on and/or set the passwords which it will have.
 * also the functions that the user will have are set here, such as print, modify, add
 */
    function setEncryption($userPass='',$ownerPass='',$pc=array()){
    $p=bindec(11000000);

    $options = array(
        'print'=>4
        ,'modify'=>8
        ,'copy'=>16
        ,'add'=>32
        );
    foreach($pc as $k=>$v){
        if ($v && isset($options[$k])){
        $p+=$options[$k];
        } else if (isset($options[$v])){
        $p+=$options[$v];
        }
    }
    // implement encryption on the document
    if ($this->arc4_objnum == 0){
        // then the block does not exist already, add it.
        $this->numObj++;
        if (strlen($ownerPass)==0){
        $ownerPass=$userPass;
        }
        $this->o_encryption($this->numObj,'new',array('user'=>$userPass,'owner'=>$ownerPass,'p'=>$p));
    }
    }

/**
 * should be used for internal checks, not implemented as yet
 */
    function checkAllHere(){
    }

/**
 * return the pdf stream as a string returned from the function
 */
    function output($debug=0){

    if ($debug){
        // turn compression off
        $this->options['compression']=0;
    }

    if ($this->arc4_objnum){
        $this->ARC4_init($this->encryptionKey);
    }

    $this->checkAllHere();

    $xref=array();
    $content="%PDF-1.3\n%����\n";
//  $content="%PDF-1.3\n";
    $pos=strlen($content);
    foreach($this->objects as $k=>$v){
        $tmp='o_'.$v['t'];
        $cont=$this->$tmp($k,'out');
        $content.=$cont;
        $xref[]=$pos;
        $pos+=strlen($cont);
    }
    $content.="\nxref\n0 ".(count($xref)+1)."\n0000000000 65535 f \n";
    foreach($xref as $p){
        ++$p;
        $content.=substr('0000000000',0,10-strlen($p)).$p." 00000 n \n";
    }
    $content.="\ntrailer\n  << /Size ".(count($xref)+1)."\n     /Root 1 0 R\n     /Info ".$this->infoObject." 0 R\n";
    // if encryption has been applied to this document then add the marker for this dictionary
    if ($this->arc4_objnum > 0){
        $content .= "/Encrypt ".$this->arc4_objnum." 0 R\n";
    }
    if (strlen($this->fileIdentifier)){
        $content .= "/ID[<".$this->fileIdentifier."><".$this->fileIdentifier.">]\n";
    }
    $content .= "  >>\nstartxref\n".($pos+1)."\n%%EOF\n";

    return $content;
    }

/**
 * intialize a new document
 * if this is called on an existing document results may be unpredictable, but the existing document would be lost at minimum
 * this function is called automatically by the constructor function
 *
 * @access private
 */
    function newDocument($pageSize=array(0,0,612,792)){
    $this->numObj=0;
    $this->objects = array();

    $this->numObj++;
    $this->o_catalog($this->numObj,'new');

    $this->numObj++;
    $this->o_outlines($this->numObj,'new');

    $this->numObj++;
    $this->o_pages($this->numObj,'new');

    $this->o_pages($this->numObj,'mediaBox',$pageSize);
    $this->currentNode = 3;

    $this->numObj++;
    $this->o_procset($this->numObj,'new');

    $this->numObj++;
    $this->o_info($this->numObj,'new');

    $this->numObj++;
    $this->o_page($this->numObj,'new');

    // need to store the first page id as there is no way to get it to the user during
    // startup
    $this->firstPageId = $this->currentContents;
    }

    /**
     * open the font file and return a php structure containing it.
     * first check if this one has been done before and saved in a form more suited to php
     * note that if a php serialized version does not exist it will try and make one, but will
     * require write access to the directory to do it... it is MUCH faster to have these serialized
     * files.
     *
     * @access private
     */
    function openFont( $font )
    {
        // assume that $font contains both the path and perhaps the extension to the file, split them
        $pos = strrpos( $font, '/' );
        if ( $pos === false )
        {
            $dir = './';
            $name = $font;
        }
        else
        {
            $dir = substr( $font, 0, $pos + 1 );
            $name = substr( $font, $pos + 1 );
        }

        if ( substr( $name, -5 ) == '.font' )
        {
            $name = substr( $name, 0, strlen( $name ) - 5 );
        }

        $this->addMessage( 'openFont: ' . $font . ' - ' . $name );
        if ( file_exists( $dir.'php_'.$name.'.font' ) )
        {
            $this->addMessage( 'openFont: php file exists ' . $dir . 'php_' . $name . '.font' );
            $tmp = file( $dir . 'php_' . $name . '.font' );
            $this->fonts[$font] = unserialize( $tmp[0] );
            if ( !isset( $this->fonts[$font]['_version_'] ) || $this->fonts[$font]['_version_'] < 1 )
            {
                // if the font file is old, then clear it out and prepare for re-creation
                $this->addMessage( 'openFont: clear out, make way for new version.' );
                unset( $this->fonts[$font] );
            }
        }
        if ( !isset( $this->fonts[$font] ) && file_exists( $dir.$name.'.afm' ) )
        {
            // then rebuild the php_<font>.afm file from the <font>.afm file
            $this->addMessage( 'openFont: build php file from ' . $dir.$name.'.afm' );
            $data = array();
            $file = file( $dir.$name.'.afm' );
            foreach ( $file as $rowA )
            {
                $row = trim( $rowA );
                $pos = strpos( $row, ' ' );
                if ( $pos )
                {
                    // then there must be some keyword
                    $key = substr( $row, 0, $pos );
                    switch ( $key )
                    {
                        case 'FontName':
                        case 'FullName':
                        case 'FamilyName':
                        case 'Weight':
                        case 'ItalicAngle':
                        case 'IsFixedPitch':
                        case 'CharacterSet':
                        case 'UnderlinePosition':
                        case 'UnderlineThickness':
                        case 'Version':
                        case 'EncodingScheme':
                        case 'CapHeight':
                        case 'XHeight':
                        case 'Ascender':
                        case 'Descender':
                        case 'StdHW':
                        case 'StdVW':
                        case 'StartCharMetrics':
                            $data[$key] = trim( substr( $row, $pos ) );
                        break;
                        case 'FontBBox':
                            $data[$key] = explode(' ', trim( substr( $row, $pos ) ) );
                        break;
                        case 'C':
                            //C 39 ; WX 222 ; N quoteright ; B 53 463 157 718 ;
                            $bits = explode( ';', trim( $row ) );
                            $dtmp = array();
                            foreach ( $bits as $bit )
                            {
                                $bits2 = explode( ' ', trim( $bit ) );
                                if ( strlen( $bits2[0] ) )
                                {
                                    if ( count( $bits2 ) > 2 )
                                    {
                                        $dtmp[$bits2[0]] = array();
                                        for ( $i = 1; $i < count( $bits2 ); $i++ )
                                        {
                                            $dtmp[$bits2[0]][] = $bits2[$i];
                                        }
                                    }
                                    else if ( count( $bits2 ) == 2 )
                                    {
                                        $dtmp[$bits2[0]] = $bits2[1];
                                    }
                                }
                            }
                            if ( $dtmp['C'] >= 0 )
                            {
                                $data['C'][$dtmp['C']] = $dtmp;
                                $data['C'][$dtmp['N']] = $dtmp;
                            }
                            else
                            {
                                $data['C'][$dtmp['N']] = $dtmp;
                            }
                            break;

                        case 'KPX':
                            //KPX Adieresis yacute -40
                            $bits = explode( ' ', trim( $row ) );
                            $data['KPX'][$bits[1]][$bits[2]] = $bits[3];
                            break;
                    }
                }
            }
            $data['_version_'] = 1;
            $this->fonts[$font] = $data;
            $fp = fopen( $dir.'php_'.$name.'.font', 'w' );
            fwrite( $fp, serialize( $data ) );
            fclose( $fp );
        }
        else if ( !isset( $this->fonts[$font] ) )
        {
            $this->addMessage( 'openFont: no font file found' );
            //echo 'Font not Found '.$font;
        }
    }

    /**
     * if the font is not loaded then load it and make the required object
     * else just make it the current font
     * the encoding array can contain 'encoding'=> 'none','WinAnsiEncoding','MacRomanEncoding' or 'MacExpertEncoding'
     * note that encoding='none' will need to be used for symbolic fonts
     * and 'differences' => an array of mappings between numbers 0->255 and character names.
     *
     */
    function selectFont( $fontName, $encoding = '', $set = 1 )
    {
        if ( !isset( $this->fonts[$fontName] ) )
        {
            // load the file
            $this->openFont( $fontName );
            if ( isset( $this->fonts[$fontName] ) )
            {
                $this->numObj++;
                $this->numFonts++;
                $pos = strrpos( $fontName, '/' );
                $name = substr( $fontName, $pos + 1 );
                if ( substr( $name, -5 ) == '.font' )
                {
                    $name = substr( $name, 0, strlen( $name ) - 5 );
                }
                if ( !isset( $this->fontFamilies[$name] ) )
                {
                    $this->setFontFamily( $name, array( 'b' => $name . '-Bold',
                                                        'i' => $name . '-Italic',
                                                        'bi' =>  $name . '-BoldItalic',
                                                        'ib' => $name . '-BoldItalic' ) );
                }
                $options = array( 'name' => $name );
                if ( is_array( $encoding ) )
                {
                    // then encoding and differences might be set
                    if ( isset( $encoding['encoding'] ) )
                    {
                        $options['encoding'] = $encoding['encoding'];
                    }
                    if ( isset( $encoding['differences'] ) )
                    {
                        $options['differences'] = $encoding['differences'];
                    }
                }
                else if ( strlen( $encoding ) )
                {
                    // then perhaps only the encoding has been set
                    $options['encoding'] = $encoding;
                }
                $fontObj = $this->numObj;
                $this->o_font( $this->numObj, 'new', $options );
                $this->fonts[$fontName]['fontNum'] = $this->numFonts;
                // if this is a '.afm' font, and there is a '.pfa' file to go with it ( as there
                // should be for all non-basic fonts), then load it into an object and put the
                // references into the font object
                $basefile = substr( $fontName, 0, strlen( $fontName ) );
                if ( file_exists( $basefile.'.pfb' ) )
                {
                    $fbtype = 'pfb';
                }
                else if ( file_exists( $basefile.'.ttf' ) )
                {
                    $fbtype = 'ttf';
                }
                else
                {
                    $fbtype = '';
                }
                $fbfile = $basefile.'.'.$fbtype;

                $this->addMessage( 'selectFont: checking for - ' . $fbfile );
                if ( strlen( $fbtype ) )
                {
                    $adobeFontName = $this->fonts[$fontName]['FontName'];
                    $this->addMessage( 'selectFont: adding font file - ' . $fbfile . ' - ' . $adobeFontName );
                    // find the array of fond widths, and put that into an object.
                    $firstChar = -1;
                    $lastChar = 0;
                    $widths = array();
                    foreach ( $this->fonts[$fontName]['C'] as $num => $d )
                    {
                        if ( intval($num) > 0 || $num == '0' )
                        {
                            if ( $lastChar > 0 && $num > $lastChar + 1 )
                            {
                                for ( $i = $lastChar + 1; $i < $num; $i++ )
                                {
                                    $widths[] = 0;
                                }
                            }
                            $widths[] = $d['WX'];
                            if ( $firstChar == -1 )
                            {
                                $firstChar = $num;
                            }
                            $lastChar = $num;
                        }
                    }
                    // also need to adjust the widths for the differences array
                    if ( isset( $options['differences'] ) )
                    {
                        foreach( $options['differences'] as $charNum => $charName )
                        {
                            if ( $charNum > $lastChar )
                            {
                                for( $i = $lastChar + 1; $i <= $charNum; $i++ )
                                {
                                    $widths[] = 0;
                                }
                                $lastChar = $charNum;
                            }
                            if ( isset( $this->fonts[$fontName]['C'][$charName] ) )
                            {
                                $widths[$charNum-$firstChar] = $this->fonts[$fontName]['C'][$charName]['WX'];
                            }
                        }
                    }
                    $this->addMessage( 'selectFont: FirstChar=' . $firstChar );
                    $this->addMessage( 'selectFont: LastChar=' . $lastChar );
                    $this->numObj++;
                    $this->o_contents( $this->numObj, 'new', 'raw' );
                    $this->objects[$this->numObj]['c'] .= '[';
                    foreach ( $widths as $width )
                    {
                        $this->objects[$this->numObj]['c'] .= ' ' . $width;
                    }
                    $this->objects[$this->numObj]['c'] .= ' ]';
                    $widthid = $this->numObj;

                    // load the pfb file, and put that into an object too.
                    // note that pdf supports only binary format type 1 font files, though there is a
                    // simple utility to convert them from pfa to pfb.
                    $fp = fopen( $fbfile, 'rb' );
                    $tmp = get_magic_quotes_runtime();
                    set_magic_quotes_runtime( 0 );
                    $data = fread( $fp, filesize( $fbfile ) );
                    set_magic_quotes_runtime( $tmp );
                    fclose( $fp );

                    // create the font descriptor
                    $this->numObj++;
                    $fontDescriptorId = $this->numObj;
                    $this->numObj++;
                    $pfbid = $this->numObj;
                    // determine flags (more than a little flakey, hopefully will not matter much)
                    $flags=0;
                    if ( $this->fonts[$fontName]['ItalicAngle'] != 0 )
                    {
                        $flags += pow( 2, 6 );
                    }
                    if ( $this->fonts[$fontName]['IsFixedPitch'] == 'true' )
                    {
                        $flags += 1;
                    }
                    $flags += pow( 2, 5 ); // assume non-sybolic

                    $list = array( 'Ascent' => 'Ascender',
                                   'CapHeight' => 'CapHeight',
                                   'Descent' => 'Descender',
                                   'FontBBox' => 'FontBBox',
                                   'ItalicAngle' => 'ItalicAngle' );
                    $fdopt = array( 'Flags' => $flags,
                                    'FontName' => $adobeFontName,
                                    'StemV' => 100  // don't know what the value for this should be!
                                    );
                    foreach ( $list as $k => $v )
                    {
                        if ( isset( $this->fonts[$fontName][$v] ) )
                        {
                            $fdopt[$k] = $this->fonts[$fontName][$v];
                        }
                    }

                    if ( $fbtype == 'pfb' )
                    {
                        $fdopt['FontFile'] = $pfbid;
                    }
                    else if ( $fbtype == 'ttf' )
                    {
                        $fdopt['FontFile2'] = $pfbid;
                    }
                    $this->o_fontDescriptor( $fontDescriptorId, 'new', $fdopt );

                    // embed the font program
                    $this->o_contents( $this->numObj, 'new' );
                    $this->objects[$pfbid]['c'] .= $data;
                    // determine the cruicial lengths within this file
                    if ($fbtype=='pfb')
                    {
                        $l1 = strpos($data,'eexec') + 6;
                        $l2 = strpos($data,'00000000') - $l1;
                        $l3 = strlen($data) - $l2 - $l1;
                        $this->o_contents( $this->numObj, 'add', array( 'Length1' => $l1,
                                                                        'Length2' => $l2,
                                                                        'Length3' => $l3 ) );
                    }
                    else if ( $fbtype == 'ttf' )
                    {
                        $l1 = strlen($data);
                        $this->o_contents( $this->numObj, 'add', array( 'Length1' => $l1 ) );
                    }

                    // tell the font object about all this new stuff
                    $tmp = array( 'BaseFont' => $adobeFontName,
                                  'Widths' => $widthid,
                                  'FirstChar' => $firstChar,
                                  'LastChar' => $lastChar,
                                  'FontDescriptor' => $fontDescriptorId );
                    if ( $fbtype == 'ttf' )
                    {
                        $tmp['SubType'] = 'TrueType';
                    }
                    $this->addMessage( 'adding extra info to font.('.$fontObj.')' );
                    foreach ( $tmp as $fk => $fv )
                    {
                        $this->addMessage( $fk." : ".$fv );
                    }
                    $this->o_font( $fontObj, 'add', $tmp );

                }
                else
                {
                    $this->addMessage( 'selectFont: pfb or ttf file not found, ok if this is one of the 14 standard fonts' );
                }


                // also set the differences here, note that this means that these will take effect only the
                //first time that a font is selected, else they are ignored
                if ( isset( $options['differences'] ) )
                {
                    $this->fonts[$fontName]['differences'] = $options['differences'];
                }
            }
        }
        if ( $set && isset( $this->fonts[$fontName] ) )
        {
            // so if for some reason the font was not set in the last one then it will not be selected
            $this->currentBaseFont = $fontName;
            // the next line means that if a new font is selected, then the current text state will be
            // applied to it as well.
            $this->setCurrentFont();
        }
        return $this->currentFontNum;
    }

    /**
     Get current font

     \return current font name
    */
    function currentFont()
    {
        return $this->currentBaseFont;
    }

    /**
     * sets up the current font, based on the font families, and the current text state
     * note that this system is quite flexible, a <b><i> font can be completely different to a
     * <i><b> font, and even <b><b> will have to be defined within the family to have meaning
     * This function is to be called whenever the currentTextState is changed, it will update
     * the currentFont setting to whatever the appropriatte family one is.
     * If the user calls selectFont themselves then that will reset the currentBaseFont, and the currentFont
     * This function will change the currentFont to whatever it should be, but will not change the
     * currentBaseFont.
     *
     * @access private
     */
    function setCurrentFont()
    {
        if ( strlen( $this->currentBaseFont ) == 0 )
        {
            // then assume an initial font
            $this->selectFont( 'lib/ezpdf/classes/fonts/Helvetica' );
        }
        $cf = substr( $this->currentBaseFont, strrpos( $this->currentBaseFont, '/' ) + 1 );
        if ( strlen( $this->currentTextState )
             && isset( $this->fontFamilies[$cf] )
             && isset( $this->fontFamilies[$cf][$this->currentTextState] ) )
        {
            // then we are in some state or another
            // and this font has a family, and the current setting exists within it
            // select the font, then return it
            $nf = substr( $this->currentBaseFont, 0, strrpos( $this->currentBaseFont, '/' ) + 1 ) .
                  $this->fontFamilies[$cf][$this->currentTextState];
            $this->selectFont( $nf, '', 0 );
            $this->currentFont = $nf;
            $this->currentFontNum = $this->fonts[$nf]['fontNum'];
        }
        else
        {
            // the this font must not have the right family member for the current state
            // simply assume the base font
            $this->currentFont = $this->currentBaseFont;
            $this->currentFontNum = $this->fonts[$this->currentFont]['fontNum'];
        }
    }

    /**
     * function for the user to find out what the ID is of the first page that was created during
     * startup - useful if they wish to add something to it later.
     */
    function getFirstPageId()
    {
        return $this->firstPageId;
    }

    /**
     * add content to the currently active object
     *
     * @access private
     */
    function addContent( $content )
    {
        $this->objects[$this->currentContents]['c'] .= $content;
    }

    /**
     * sets the colour for fill operations
     */
    function setColorRGB( $r, $g, $b, $force = 0 )
    {
        $this->setColor( eZMath::rgbToCMYK2( $r, $g, $b ), $force );
    }

    /*!
     sets the colour for fill operations

     \param CMYK array
    */
    function setColor( $cmykArray, $force = 0 )
    {
        if ( $force || !$this->compareCMYK( $cmykArray, $this->currentColour ) )
        {
            $this->objects[$this->currentContents]['c'] .= "\n" .
                 sprintf( '%.3F', $cmykArray['c'] ) . ' ' . sprintf( '%.3F', $cmykArray['m'] ) . ' ' .
                 sprintf( '%.3F', $cmykArray['y'] ) . ' ' . sprintf( '%.3F', $cmykArray['k'] ) . ' k';
            $this->currentColour = $cmykArray;
        }
    }

    /**
     * sets the colour for stroke operations
     */
    function setStrokeColorRGB( $r, $g, $b, $force = 0 )
    {
        $this->setStrokeColor( eZMath::rgbToCMYK2( $r, $g, $b ), $force );
    }

    /*!
      sets the colour for stroke operations

      \param cmyk array
      \param force color change
     */
    function setStrokeColor( $cmykArray, $force = 0 )
    {
        if ( $force || !$this->compareCMYK( $cmykArray, $this->currentStrokeColour ) )
        {
            $this->objects[$this->currentContents]['c'] .= "\n" .
                 sprintf( '%.3F', $cmykArray['c'] ) . ' ' . sprintf( '%.3F', $cmykArray['m'] ) . ' ' .
                 sprintf( '%.3F', $cmykArray['y'] ) . ' ' . sprintf( '%.3F', $cmykArray['k'] ) . ' K';
            $this->currentStrokeColour = $cmykArray;
        }
    }

    /**
     * draw a line from one set of coordinates to another
     */
    function line( $x1, $y1, $x2, $y2 )
    {
        $this->objects[$this->currentContents]['c'] .= "\n".sprintf('%.3F',$x1).' '.sprintf('%.3F',$y1).' m '.sprintf('%.3F',$x2).' '.sprintf('%.3F',$y2).' l S';
    }

    /**
     * draw a bezier curve based on 4 control points
     */
    function curve( $x0, $y0, $x1, $y1, $x2, $y2, $x3, $y3 )
    {
        // in the current line style, draw a bezier curve from (x0,y0) to (x3,y3) using the other two points
        // as the control points for the curve.
        $this->objects[$this->currentContents]['c'].="\n".sprintf('%.3F',$x0).' '.sprintf('%.3F',$y0).' m '.sprintf('%.3F',$x1).' '.sprintf('%.3F',$y1);
        $this->objects[$this->currentContents]['c'].= ' '.sprintf('%.3F',$x2).' '.sprintf('%.3F',$y2).' '.sprintf('%.3F',$x3).' '.sprintf('%.3F',$y3).' c S';
    }

    /**
     * draw a part of an ellipse
     */
    function partEllipse( $x0, $y0, $astart, $afinish, $r1, $r2 = 0, $angle = 0, $nSeg = 8 )
    {
        $this->ellipse( $x0, $y0, $r1, $r2, $angle, $nSeg, $astart, $afinish, 0 );
    }

    /**
     * draw a filled ellipse
     */
    function filledEllipse( $x0, $y0, $r1, $r2 = 0, $angle = 0, $nSeg = 8, $astart = 0, $afinish = 360 )
    {
        return $this->ellipse( $x0, $y0, $r1, $r2 = 0, $angle, $nSeg, $astart, $afinish, 1, 1 );
    }

    /**
     * draw an ellipse
     * note that the part and filled ellipse are just special cases of this function
     *
     * draws an ellipse in the current line style
     * centered at $x0,$y0, radii $r1,$r2
     * if $r2 is not set, then a circle is drawn
     * nSeg is not allowed to be less than 2, as this will simply draw a line (and will even draw a
     * pretty crappy shape at 2, as we are approximating with bezier curves.
     */
    function ellipse( $x0, $y0, $r1, $r2 = 0, $angle = 0, $nSeg = 8, $astart = 0, $afinish = 360, $close = 1, $fill = 0 )
    {
        if ( $r1 == 0 )
        {
            return;
        }
        if ( $r2 == 0 )
        {
            $r2 = $r1;
        }
        if ( $nSeg < 2 )
        {
            $nSeg = 2;
        }

        $astart = deg2rad( (float)$astart );
        $afinish = deg2rad( (float)$afinish );
        $totalAngle = $afinish - $astart;

        $dt = $totalAngle / $nSeg;
        $dtm = $dt / 3;

        if ( $angle != 0 )
        {
            $a = -1*deg2rad((float)$angle);
            $tmp = "\n q ";
            $tmp .= sprintf('%.3F',cos($a)).' '.sprintf('%.3F',(-1.0*sin($a))).' '.sprintf('%.3F',sin($a)).' '.sprintf('%.3F',cos($a)).' ';
            $tmp .= sprintf('%.3F',$x0).' '.sprintf('%.3F',$y0).' cm';
            $this->objects[$this->currentContents]['c'].= $tmp;
            $x0=0;
            $y0=0;
        }

        $t1 = $astart;
        $a0 = $x0 + $r1*cos($t1);
        $b0 = $y0 + $r2*sin($t1);
        $c0 = -$r1 * sin($t1);
        $d0 = $r2 * cos($t1);

        $this->objects[$this->currentContents]['c'] .= "\n".sprintf('%.3F',$a0).' '.sprintf('%.3F',$b0).' m ';
        for ($i=1;$i<=$nSeg;$i++)
        {
            // draw this bit of the total curve
            $t1 = $i*$dt + $astart;
            $a1 = $x0 + $r1*cos($t1);
            $b1 = $y0 + $r2*sin($t1);
            $c1 = -$r1 * sin($t1);
            $d1 = $r2 * cos($t1);
            $this->objects[$this->currentContents]['c'].= "\n".sprintf('%.3F',($a0+$c0*$dtm)).' '.sprintf('%.3F',($b0+$d0*$dtm));
            $this->objects[$this->currentContents]['c'].= ' '.sprintf('%.3F',($a1-$c1*$dtm)).' '.sprintf('%.3F',($b1-$d1*$dtm)).' '.sprintf('%.3F',$a1).' '.sprintf('%.3F',$b1).' c';
            $a0 = $a1;
            $b0 = $b1;
            $c0 = $c1;
            $d0 = $d1;
        }
        if ( $fill )
        {
            $this->objects[$this->currentContents]['c'].= ' f';
        }
        else
        {
            if ($close)
            {
                $this->objects[$this->currentContents]['c'].= ' s'; // small 's' signifies closing the path as well
            }
            else
            {
                $this->objects[$this->currentContents]['c'].= ' S';
            }
        }
        if ( $angle != 0 )
        {
            $this->objects[$this->currentContents]['c'].= ' Q';
        }
    }

    /**
     * this sets the line drawing style.
     * width, is the thickness of the line in user units
     * cap is the type of cap to put on the line, values can be 'butt','round','square'
     *    where the diffference between 'square' and 'butt' is that 'square' projects a flat end past the
     *    end of the line.
     * join can be 'miter', 'round', 'bevel'
     * dash is an array which sets the dash pattern, is a series of length values, which are the lengths of the
     *   on and off dashes.
     *   (2) represents 2 on, 2 off, 2 on , 2 off ...
     *   (2,1) is 2 on, 1 off, 2 on, 1 off.. etc
     * phase is a modifier on the dash pattern which is used to shift the point at which the pattern starts.
     */
    function setLineStyle( $width = 1, $cap = '', $join = '', $dash = '', $phase = 0 )
    {

        // this is quite inefficient in that it sets all the parameters whenever 1 is changed, but will fix another day
        $string = '';
        if ( $width > 0 )
        {
            $string.= $width.' w';
        }
        $ca = array( 'butt' => 0, 'round' => 1, 'square' => 2 );
        if ( isset( $ca[$cap] ) )
        {
            $string.= ' '.$ca[$cap].' J';
        }
        $ja = array('miter'=>0,'round'=>1,'bevel'=>2);
        if ( isset( $ja[$join] ) )
        {
            $string.= ' '.$ja[$join].' j';
        }
        if ( is_array( $dash ) )
        {
            $string.= ' [';
            foreach ( $dash as $len )
            {
                $string.=' '.$len;
            }
            $string.= ' ] '.$phase.' d';
        }
        $this->currentLineStyle = $string;
        $this->objects[$this->currentContents]['c'].= "\n".$string;
    }

    /**
     * draw a polygon, the syntax for this is similar to the GD polygon command
     */
    function polygon( $p, $np, $f = 0 )
    {
        $this->objects[$this->currentContents]['c'].= "\n";
        $this->objects[$this->currentContents]['c'].= sprintf('%.3F',$p[0]).' '.sprintf('%.3F',$p[1]).' m ';
        for ( $i = 2; $i < $np*2; $i = $i + 2 )
        {
            $this->objects[$this->currentContents]['c'].= sprintf('%.3F',$p[$i]).' '.sprintf('%.3F',$p[$i+1]).' l ';
        }
        if ( $f == 1 )
        {
            $this->objects[$this->currentContents]['c'].= ' f';
        }
        else
        {
            $this->objects[$this->currentContents]['c'].= ' S';
        }
    }

    /**
     Create shaded rectangle area

     \param x1
     \param x2
     \param width
     \param height
     \param options
            array ( 'orientation' => <vertical|horizontal ( optianal )>,
                    'color0' => <CMYK color array>,
                    'color1' => <CMYK color array> )
    */
    function shadedRectangle( $x1, $y1, $width, $height, $options )
    {
        $this->numObj++;
        $shadingLabel = $this->o_shading( $this->numObj, 'new', $options );

        $this->saveState();

        $this->objects[$this->currentContents]['c'].="\n".sprintf('%.3F',$x1).' '.sprintf('%.3F',$y1).' '.sprintf('%.3F',$width).' '.sprintf('%.3F',$height).' re';

        $this->objects[$this->currentContents]['c'].="\nW n";

        $this->objects[$this->currentContents]['c'].="\n/".$shadingLabel.' sh';

        $this->restoreState();
    }

    /**
     * a filled rectangle, note that it is the width and height of the rectangle which are the secondary paramaters, not
     * the coordinates of the upper-right corner
     */
    function filledRectangle( $x1, $y1, $width, $height )
    {
        $this->objects[$this->currentContents]['c'].="\n".sprintf('%.3F',$x1).' '.sprintf('%.3F',$y1).' '.sprintf('%.3F',$width).' '.sprintf('%.3F',$height).' re f';
    }

    /**
     * draw a rectangle, note that it is the width and height of the rectangle which are the secondary paramaters, not
     * the coordinates of the upper-right corner
     */
    function rectangle( $x1, $y1, $width, $height )
    {
        $this->objects[$this->currentContents]['c'].="\n".sprintf('%.3F',$x1).' '.sprintf('%.3F',$y1).' '.sprintf('%.3F',$width).' '.sprintf('%.3F',$height).' re S';
    }

    /**
     * add a new page to the document
     * this also makes the new page the current active object
     */
    function newPage( $insert = 0, $id = 0, $pos = 'after' )
    {
        // if there is a state saved, then go up the stack closing them
        // then on the new page, re-open them with the right setings

        if ( $this->nStateStack )
        {
            for ( $i = $this->nStateStack; $i >= 1; $i-- )
            {
                $this->restoreState( $i );
            }
        }

        $this->numObj++;
        if ( $insert )
        {
            // the id from the ezPdf class is the od of the contents of the page, not the page object itself
            // query that object to find the parent
            $rid = $this->objects[$id]['onPage'];
            $opt = array( 'rid' => $rid, 'pos' => $pos );
            $this->o_page( $this->numObj, 'new', $opt);
        }
        else
        {
            $this->o_page( $this->numObj, 'new' );
        }
        // if there is a stack saved, then put that onto the page
        if ( $this->nStateStack )
        {
            for ( $i = 1; $i <= $this->nStateStack; $i++)
            {
                $this->saveState($i);
            }
        }
        // and if there has been a stroke or fill colour set, then transfer them
        if ( $this->currentColour['c'] >= 0 )
        {
            $this->setColor( $this->currentColour, 1 );
        }
        if ( $this->currentStrokeColour['c'] >= 0 )
        {
            $this->setStrokeColor( $this->currentStrokeColour, 1 );
        }

        // if there is a line style set, then put this in too
        if ( strlen( $this->currentLineStyle ) )
        {
            $this->objects[$this->currentContents]['c'].= "\n".$this->currentLineStyle;
        }

        // the call to the o_page object set currentContents to the present page, so this can be returned as the page id
        return $this->currentContents;
    }

    /**
     * output the pdf code, streaming it to the browser
     * the relevant headers are set so that hopefully the browser will recognise it
     */
    function stream( $options = '' )
    {
        // setting the options allows the adjustment of the headers
        // values at the moment are:
        // 'Content-Disposition'=>'filename'  - sets the filename, though not too sure how well this will
        //        work as in my trial the browser seems to use the filename of the php file with .pdf on the end
        // 'Accept-Ranges'=>1 or 0 - if this is not set to 1, then this header is not included, off by default
        //    this header seems to have caused some problems despite tha fact that it is supposed to solve
        //    them, so I am leaving it off by default.
        // 'compress'=> 1 or 0 - apply content stream compression, this is on (1) by default
        if ( !is_array( $options ) )
        {
            $options = array();
        }
        if ( isset( $options['compress'] ) && $options['compress'] == 0 )
        {
            $tmp = $this->output( 1 );
        }
        else
        {
            $tmp = $this->output();
        }
        $tmp = ltrim( $tmp );

        ob_clean();

        header( 'Pragma: ' );
        header( 'Cache-Control: ' );
        /* Set cache time out to 10 seconds, this should be good enough to work around an IE bug */
        header( "Expires: ". gmdate( 'D, d M Y H:i:s', time() + 10 ) . ' GMT' );
        header( 'X-Powered-By: eZ Publish' );

        header( 'Content-Length: '.strlen( $tmp ) );
        header( 'Content-Type: application/pdf' );
        header( 'Content-Transfer-Encoding: binary' );
        header( 'Accept-Ranges: bytes' );

        ob_end_clean();

        echo $tmp;

        eZExecution::cleanExit();
    }

    /**
     * return the height in units of the current font in the given size
     */
    function getFontHeight( $size = false )
    {
        if ( !$this->numFonts )
        {
            $this->selectFont( './fonts/Helvetica' );
        }
        // for the current font, and the given size, what is the height of the font in user units
        $h = $this->fonts[$this->currentFont]['FontBBox'][3]-$this->fonts[$this->currentFont]['FontBBox'][1];
        if ( $size === false )
        {
            $size = $this->fontSize();
        }
        return $this->ez['lineSpace'] * $size * $h / 1000;
    }

    /**
     * return the font decender, this will normally return a negative number
     * if you add this number to the baseline, you get the level of the bottom of the font
     * it is in the pdf user units
     */
    function getFontDecender( $size = false )
    {
        // note that this will most likely return a negative value
        if ( !$this->numFonts )
        {
            $this->selectFont( './fonts/Helvetica' );
        }
        $h = $this->fonts[$this->currentFont]['FontBBox'][1];
        if ( $size === false )
        {
            $size = $this->fontSize();
        }
        return $size*$h/1000;
    }

    /**
     * filter the text, this is applied to all text just before being inserted into the pdf document
     * it escapes the various things that need to be escaped, and so on
     *
     * @access private
     */
    function filterText( $text )
    {
        $text = str_replace('\\','\\\\',$text);
        $text = str_replace('(','\(',$text);
        $text = str_replace(')','\)',$text);
        $text = str_replace('&lt;','<',$text);
        $text = str_replace('&gt;','>',$text);
        $text = str_replace('&#039;','\'',$text);
        $text = str_replace('&quot;','"',$text);
        $text = str_replace('&amp;','&',$text);

        return $text;
    }

    /**
     * given a start position and information about how text is to be laid out, calculate where
     * on the page the text will end
     *
     * @access private
     */
    function PRVTgetTextPosition( $x, $y, $angle, $size, $wa, $text )
    {
        $tmp = false;
        // given this information return an array containing x and y for the end position as elements 0 and 1

        $w = $this->getTextWidth($size,$text);
        // need to adjust for the number of spaces in this text
        $words = explode(' ',$text);
        $nspaces=count($words)-1;
        $w += $wa*$nspaces;
        $a = deg2rad((float)$angle);
        if ( $tmp )
        {
            return array($this->xOffset(),-sin($a)*$w+$y);
        }
        return array(cos($a)*$w+$x,-sin($a)*$w+$y);
    }

    /**
     * wrapper function for PRVTcheckTextDirective1
     *
     * @access private
     */
    function PRVTcheckTextDirective( &$text, $i, &$f, $final = 0 )
    {
        $x = 0;
        $y = 0;
        return $this->PRVTcheckTextDirective1( $text, $i, $f, $final, $x, $y );
    }

    /**
     * checks if the text stream contains a control directive
     * if so then makes some changes and returns the number of characters involved in the directive
     * this has been re-worked to include everything neccesary to fins the current writing point, so that
     * the location can be sent to the callback function if required
     * if the directive does not require a font change, then $f should be set to 0
     *
     * @access private
     */
    function PRVTcheckTextDirective1( &$text, $i, &$f, $final, &$x, &$y, $size = 0, $angle = 0, $wordSpaceAdjust = 0 )
    {
        $newTextState = $this->currentTextState;
        $noClose = 0;
        $directive = 0;
        $j = $i;
        if ( $text[$j] == '<' )
        {
            $j++;
            switch ( $text[$j] )
            {
            case '/':
                $j++;
                if (strlen($text) <= $j)
                {
                    return $directive;
                }
                switch ( $text[$j] )
                {
                    case 'b':
                    case 'i':
                        ++$j;
                    if ( $text[$j] == '>' )
                    {
                        if ( $final === true )
                            $this->currentTextState = substr( $this->currentTextState, 0, $p).substr( $this->currentTextState, $p+1);
                        $directive = $j-$i+1;
                    }
                    break;

                    case 'c':
                    {
                        // this this might be a callback function
                        $j++;
                        $k = strpos( $text, '>', $j );
                        if ( $k !== false && $text[$j] == ':' )
                        {
                            // then this will be treated as a callback directive
                            $directive = $k-$i+1;
                            $f = 0;
                            // split the remainder on colons to get the function name and the paramater
                            $tmp = substr( $text, $j+1, $k-$j-1 );
                            $b1 = strpos( $tmp, ':' );
                            if ( $b1 !== false )
                            {
                                $func = substr( $tmp, 0, $b1 );
                                $parm = substr( $tmp, $b1+1 );
                            }
                            else
                            {
                                $func = $tmp;
                                $parm = '';
                            }
                            if ( !isset( $func ) || !strlen( trim( $func ) ) )
                            {
                                $directive = 0;
                            }
                            else
                            {
                                // only call the function if this is the final call
                                if ( $final === 1 )
                                {
                                    // need to assess the text position, calculate the text width to this point
                                    // can use getTextWidth to find the text width I think
                                    if ( $x < $this->leftMargin() )
                                    {
                                        $x = $this->leftMargin();
                                    }
                                    $startInfo = $this->callback[$this->nCallback];

                                    if ( $x < $this->xOffset() )
                                    {
                                        $x = $this->xOffset();
                                    }
                                    $tmp = $this->PRVTgetTextPosition( $x, $y, $angle, $size, $wordSpaceAdjust, substr( $text, $startInfo['i'], $i-$startInfo['i'] ) );
                                    $info = array( 'x' => $tmp[0],'y' => $tmp[1], 'angle' => $angle, 'status' => 'end', 'p' => $parm, 'nCallback' => $this->nCallback );

                                    $x = $tmp[0];
                                    $y = $tmp[1];
                                    $ret = $this->$func( $info );
                                    if ( is_array( $ret ) )
                                    {
                                        // then the return from the callback function could set the position, to start with, later will do font colour, and font
                                        foreach ( $ret as $rk => $rv )
                                        {
                                            switch ( $rk )
                                            {
                                                case 'x':
                                                case 'y':
                                                    $$rk = $rv;
                                                break;
                                            }
                                        }
                                    }
                                    // also remove from to the stack
                                    // for simplicity, just take from the end, fix this another day
                                    $this->nCallback--;
                                    if ( $this->nCallback < 0 )
                                    {
                                        $this->nCallBack = 0;
                                    }
                                }
                            }
                        }
                    } break;
                }
                break;

            case 'b':
            case 'i':
                ++$j;

                if ( $text[$j] == '>' )
                {
                    if (  $final === true )
                        $this->currentTextState .= $text[$j-1];
                    $directive = $j-$i+1;
                }
                break;

            case 'C':
                $noClose = 1;
            case 'c':
                // this this might be a callback function
                $j++;
                $k = strpos( $text, '>', $j );
                if ( $k !== false && $text[$j] == ':' )
                {
                    // then this will be treated as a callback directive
                    $directive = $k-$i+1;
                    $f=0;
                    // split the remainder on colons to get the function name and the paramater
                    $tmp = substr( $text, $j+1, $k-$j-1 );
                    $b1 = strpos( $tmp, ':' );
                    if ( $b1 !== false )
                    {
                        $func = substr( $tmp, 0, $b1 );
                        $parm = substr( $tmp, $b1+1 );
                    }
                    else
                    {
                        $func = $tmp;
                        $parm = '';
                    }
                    if ( !isset( $func ) || !strlen( trim( $func ) ) )
                    {
                        $directive=0;
                    }
                    else
                    {
                        // only call the function if this is the final call, ie, the one actually doing printing, not measurement
                        if ($final === 1)
                        {
                            // need to assess the text position, calculate the text width to this point
                            // can use getTextWidth to find the text width I think
                            // also add the text height and decender
                            $tmp = $this->PRVTgetTextPosition($x,$y,$angle,$size,$wordSpaceAdjust,substr($text,0,$i));
                            if ( $tmp[0] < $this->leftMargin() )
                            {
                                $tmp[0] = $this->leftMargin();
                            }
                            if ( $tmp[0] < $this->xOffset() )
                            {
                                $tmp[0] = $this->xOffset();
                            }
                            $info = array( 'x' => $tmp[0],
                                           'y' => $tmp[1],
                                           'angle' => $angle,
                                           'status' => 'start',
                                           'p' => $parm,
                                           'f' => $func,
                                           'height' => $this->getFontHeight( $size ),
                                           'decender' => $this->getFontDecender( $size ),
                                           'i' => $i );

                            $x = $tmp[0];
                            $y = $tmp[1];
                            if (!isset($noClose) || !$noClose)
                            {
                                // only add to the stack if this is a small 'c', therefore is a start-stop pair
                                $this->nCallback++;
                                $info['nCallback']=$this->nCallback;
                                $this->callback[$this->nCallback]=$info;
                            }
                            $ret = $this->$func( $info );
                            if ( is_array( $ret ) )
                            {
                                // then the return from the callback function could set the position, to start with, later will do font colour, and font
                                foreach ( $ret as $rk => $rv )
                                {
                                    switch ( $rk )
                                    {
                                    case 'x':
                                    case 'y':
                                        $$rk=$rv;
                                        break;
                                    }
                                }
                            }
                        }
                    }
                }
                break;
            }
        }
        return array( 'directive' => $directive,
                      'y' => (float)$y,
                      'noClose' => $noClose,
                      'run_final' => ( $f == 0 ) );
    }

    /**
     * add text to the document, at a specified location, size and angle on the page
     *
     * \return array( 'height' => <used height if more than normal text, -1 if not> )
     */
    function addText( $x, $y, $size, $text, $angle = 0, $wordSpaceAdjust = 0 )
    {
        $returnArray = array( 'height' => -1 );

        if (!$this->numFonts)
        {
            $this->selectFont('./fonts/Helvetica');
        }

        // if there are any open callbacks, then they should be called, to show the start of the line
        if ($this->nCallback>0)
        {
            for ( $i = $this->nCallback; $i > 0; $i-- )
            {
                // call each function
                $info = array( 'x' => $x, 'y' => $y,
                               'angle' => $angle,
                               'status' => 'sol',
                               'p' => $this->callback[$i]['p'],
                               'nCallback' => $this->callback[$i]['nCallback'],
                               'height' => $this->callback[$i]['height'],
                               'decender' => $this->callback[$i]['decender'] );
                $func = $this->callback[$i]['f'];
                $this->$func( $info );
            }
        }
        if ( $angle == 0 )
        {
            $this->objects[$this->currentContents]['c'] .= "\n".'BT '.sprintf('%.3F',$x).' '.sprintf('%.3F',$y).' Td';
        }
        else
        {
            $a = deg2rad((float)$angle);
            $tmp = "\n".'BT ';
            $tmp .= sprintf('%.3F',cos($a)).' '.sprintf('%.3F',(-1.0*sin($a))).' '.sprintf('%.3F',sin($a)).' '.sprintf('%.3F',cos($a)).' ';
            $tmp .= sprintf('%.3F',$x).' '.sprintf('%.3F',$y).' Tm';
            $this->objects[$this->currentContents]['c'] .= $tmp;
        }
        if ($wordSpaceAdjust!=0 || $wordSpaceAdjust != $this->wordSpaceAdjust)
        {
            $this->wordSpaceAdjust=$wordSpaceAdjust;
            $this->objects[$this->currentContents]['c'].=' '.sprintf('%.3F',$wordSpaceAdjust).' Tw';
        }
        $len = strlen($text);
        $start = 0;
        for ( $i = 0; $i < $len; $i++ )
        {
            $f = 1;
            $directiveArray = $this->PRVTcheckTextDirective( $text, $i, $f, true );
            $directive = $directiveArray['directive'];
            if ($directive)
            {
                // then we should write what we need to
                if ( $i > $start )
                {
                    $part = substr($text,$start,$i-$start);
                    $this->objects[$this->currentContents]['c'].=' /F'.$this->currentFontNum.' '.sprintf('%.1F',$size).' Tf ';
                    $this->objects[$this->currentContents]['c'].=' ('.$this->filterText($part).') Tj';
                }
                if ( !$directiveArray['run_final'] )
                {
                    // then there was nothing drastic done here, restore the contents
                    $this->setCurrentFont();
                }
                else
                {
                    $this->objects[$this->currentContents]['c'] .= ' ET';
                    $f = 1;
                    $xp = $x;
                    $yp = $y;
                    $directiveArray = $this->PRVTcheckTextDirective1( $text, $i, $f, 1, $xp, $yp, $size, $angle, $wordSpaceAdjust );
                    if ( $directiveArray['y'] != 0 )
                    {
                        $returnArray['height'] = $y - $directiveArray['y'];
                    }

                    $directive = $directiveArray['directive'];

                    // restart the text object
                    if ( $angle == 0 )
                    {
                        $this->objects[$this->currentContents]['c'] .= "\n".'BT '.sprintf('%.3F',$xp).' '.sprintf('%.3F',$yp).' Td';
                    }
                    else
                    {
                        $a = deg2rad( (float)$angle );
                        $tmp = "\n".'BT ';
                        $tmp .= sprintf('%.3F',cos($a)).' '.sprintf('%.3F',(-1.0*sin($a))).' '.sprintf('%.3F',sin($a)).' '.sprintf('%.3F',cos($a)).' ';
                        $tmp .= sprintf('%.3F',$xp).' '.sprintf('%.3F',$yp).' Tm';
                        $this->objects[$this->currentContents]['c'] .= $tmp;
                    }
                    if ($wordSpaceAdjust!=0 || $wordSpaceAdjust != $this->wordSpaceAdjust)
                    {
                        $this->wordSpaceAdjust=$wordSpaceAdjust;
                        $this->objects[$this->currentContents]['c'] .= ' '.sprintf('%.3F',$wordSpaceAdjust).' Tw';
                    }
                }
                // and move the writing point to the next piece of text
                $i = $i + $directive - 1;
                $start = $i + 1;
            }

        }
        if ( $start < $len )
        {
            $part = substr($text,$start);
            $this->objects[$this->currentContents]['c'].=' /F'.$this->currentFontNum.' '.sprintf('%.1F',$size).' Tf ';
            $this->objects[$this->currentContents]['c'].=' ('.$this->filterText($part).') Tj';
        }
        $this->objects[$this->currentContents]['c'].=' ET';

        // if there are any open callbacks, then they should be called, to show the end of the line
        if ( $this->nCallback > 0 )
        {
            for ( $i = $this->nCallback; $i > 0; $i-- )
            {
                // call each function
                $tmp = $this->PRVTgetTextPosition( $x, $y, $angle, $size, $wordSpaceAdjust, $text );
                $info = array('x' => $tmp[0], 'y' => $tmp[1],
                              'angle' => $angle,
                              'status' => 'eol',
                              'p' => $this->callback[$i]['p'],
                              'nCallback' => $this->callback[$i]['nCallback'],
                              'height' => $this->callback[$i]['height'],
                              'decender' => $this->callback[$i]['decender'] );
                $func = $this->callback[$i]['f'];
                $this->$func( $info );
            }
        }

        return $returnArray;
    }

    /**
     * calculate how wide a given text string will be on a page, at a given size.
     * this can be called externally, but is alse used by the other class functions
     */
    function getTextWidth( $size, $text )
    {
        // this function should not change any of the settings, though it will need to
        // track any directives which change during calculation, so copy them at the start
        // and put them back at the end.
        $this->pushTextState( $this->currentTextState );

        if (!$this->numFonts)
        {
            $this->selectFont('./fonts/Helvetica');
        }

        // converts a number or a float to a string so it can get the width
        $text = "$text";
        // hmm, this is where it all starts to get tricky - use the font information to
        // calculate the width of each character, add them up and convert to user units
        $w = 0;
        $len = strlen( $text );
        $cf = $this->currentFont;
        for ( $i = 0; $i < $len; $i++ )
        {
            $f = 1;
            $directiveArray = $this->PRVTcheckTextDirective( $text, $i, $f );
            $directive = $directiveArray['directive'];
            if ( $directive )
            {
                if ($f)
                {
                    $this->setCurrentFont();
                    $cf = $this->currentFont;
                }
                $i = $i + $directive-1;
            }
            else
            {
                $char = ord( $text[$i] );
                if ( isset($this->fonts[$cf]['differences'][$char] ) )
                {
                    // then this character is being replaced by another
                    $name = $this->fonts[$cf]['differences'][$char];
                    if ( isset($this->fonts[$cf]['C'][$name]['WX'] ) )
                    {
                        $w += $this->fonts[$cf]['C'][$name]['WX'];
                    }
                }
                else if ( isset($this->fonts[$cf]['C'][$char]['WX'] ) )
                {
                    $w += $this->fonts[$cf]['C'][$char]['WX'];
                }
                else
                {
                    $w += 700;
                }
            }
        }

        $this->popTextState();
        $this->setCurrentFont();

        return $w*$size/1000;
    }

    /**
     * do a part of the calculation for sorting out the justification of the text
     *
     * @access private
     */
    function PRVTadjustWrapText( $text, $actual, $width, &$x, &$adjust, $justification )
    {
        switch ( $justification )
        {
        case 'left':
            return;
            break;
        case 'right':
            $x += $width - $actual;
            break;
        case 'center':
        case 'centre':
            $x += ($width - $actual) / 2;
            break;
        case 'full':
            // count the number of words
            $words = explode( ' ', $text );
            $nspaces = count($words) - 1;
            if ( $nspaces > 0 )
            {
                $adjust = ($width-$actual) / $nspaces;
            }
            else
            {
                $adjust = 0;
            }
        break;
    }
    }

    /**
     * add text to the page, but ensure that it fits within a certain width
     * if it does not fit then put in as much as possible, splitting at word boundaries
     * and return the remainder.
     * justification and angle can also be specified for the text
     *
     * return array ('text' => <text for new line>,
                     'width' => <width of added text, 0 i more text>,
                     'height' => <height of added text, -1 if none/default> )
     */
    function addTextWrap( $x, $y, $width, $size, $text, $justification = 'left', $angle = 0, $test = 0 )
    {
        // this will display the text, and if it goes beyond the width $width, will backtrack to the
        // previous space or hyphen, and return the remainder of the text.

        // $justification can be set to 'left','right','center','centre','full'

        // need to store the initial text state, as this will change during the width calculation
        // but will need to be re-set before printing, so that the chars work out right
        $store_currentTextState = $this->currentTextState;
        $returnArray = array ( 'text' => '',
                               'width' => 0,
                               'height' => 0 );
        if ( $text != '' )
        {
            $returnArray['height'] = $this->getFontHeight( $size );
        }

        if ( !$this->numFonts )
        {
            $this->selectFont('./fonts/Helvetica');
        }
        if ( $width <= 0 )
        {
            // error, pretend it printed ok, otherwise risking a loop
            return $returnArray;
        }
        $w = 0;
        $break = 0;
        $breakWidth = 0;
        $len = strlen( $text );
        $cf = $this->currentFont;
        $tw = $width/$size*1000;
        $directive = 0;
        for ( $i = 0; $i < $len; $i++ )
        {
            $f = 1;
            $directiveArray = $this->PRVTcheckTextDirective( $text, $i, $f );
            $deltaDirective = $directiveArray['directive'];
            $directive += $deltaDirective;
            if ( $directiveArray['y'] != 0 )
            {
                $y -= $directiveArray['y'];
                $returnArray['height'] = $directiveArray['y'];
            }
            if ($deltaDirective)
            {
                if ($f)
                {
                    $this->setCurrentFont();
                    $cf = $this->currentFont;
                }
                $i=$i+$deltaDirective-1;
            }
            else
            {
                $cOrd = ord($text[$i]);
                if ( isset( $this->fonts[$cf]['differences'][$cOrd] ) )
                {
                    // then this character is being replaced by another
                    $cOrd2 = $this->fonts[$cf]['differences'][$cOrd];
                }
                else
                {
                    $cOrd2 = $cOrd;
                }

                if ( isset( $this->fonts[$cf]['C'][$cOrd2]['WX'] ) )
                {
                    $w += $this->fonts[$cf]['C'][$cOrd2]['WX'];
                }
                else
                {
                    $w += 700;
                }

                if ( $w > $tw )
                {
                    // then we need to truncate this line
                    if ( $break > 0 )
                    {
                        // then we have somewhere that we can split :)
                        if ($text[$break] == ' ')
                        {
                            $tmp = substr( $text, 0, $break );
                        }
                        else
                        {
                            $tmp = substr( $text, 0, $break + 1 );
                        }
                        $adjust = 0;
                        $this->PRVTadjustWrapText( $tmp, $breakWidth, $width, $x, $adjust, $justification );

                        // reset the text state
                        $this->currentTextState = $store_currentTextState;
                        $this->setCurrentFont();
                        if ( !$test )
                        {
                            $addTextArray = $this->addText( $x, $y, $size, $tmp, $angle, $adjust );
                            if ( $addTextArray['height'] != -1 &&
                                 $returnArray['height'] < $addTextArray['height'] )
                            {
                                $returnArray['height'] = $addTextArray['height'];
                            }
                        }
                        $returnArray['text'] = substr( $text, $break + 1 );
                        return $returnArray;
                    }
                    else
                    {
                        // just split before the current character
                        $tmp = substr( $text, 0, $i );
                        $adjust = 0;
                        $ctmp = ord( $text[$i] );
                        if ( isset($this->fonts[$cf]['differences'][$ctmp] ) )
                        {
                            $ctmp = $this->fonts[$cf]['differences'][$ctmp];
                        }
                        $tmpw = ( $w - $this->fonts[$cf]['C'][$ctmp]['WX'] ) * $size/1000;
                        $this->PRVTadjustWrapText( $tmp, $tmpw, $width, $x, $adjust, $justification );
                        // reset the text state
                        $this->currentTextState = $store_currentTextState;
                        $this->setCurrentFont();
                        if ( !$test )
                        {
                            $addTextArray = $this->addText( $x, $y, $size, $tmp, $angle, $adjust );
                            if ( $addTextArray['height'] != -1 &&
                                 $returnArray['height'] < $addTextArray['height'] )
                            {
                                $returnArray['height'] = $addTextArray['height'];
                            }
                        }
                        $returnArray['text'] = substr( $text, $i );
                        return $returnArray;
                    }
                }

                if ( $text[$i] == '-' )
                {
                    $break = $i;
                    $breakWidth = $w*$size/1000;
                }
                if ( $text[$i] == ' ' )
                {
                    $break = $i;
                    $ctmp = ord( $text[$i] );
                    if ( isset($this->fonts[$cf]['differences'][$ctmp] ) )
                    {
                        $ctmp = $this->fonts[$cf]['differences'][$ctmp];
                    }
                    $breakWidth = ( $w - $this->fonts[$cf]['C'][$ctmp]['WX'] ) * $size/1000;
                }
            }
        }
        // then there was no need to break this line
        if ( $justification == 'full' )
        {
            $justification = 'left';
        }
        $adjust = 0;
        $tmpw = $w * $size/1000; //tmpw, text width
        $this->PRVTadjustWrapText( $text, $tmpw, $width, $x, $adjust, $justification );
        // reset the text state
        $this->currentTextState = $store_currentTextState;
        $this->setCurrentFont();
        if ( !$test )
        {
            $addTextArray = $this->addText( $x, $y, $size, $text, $angle, $adjust, $angle );
            if ( isset( $directive ) && $directive == $len )
            {
                return array( 'only_directive' => true );
            }

            if ( $addTextArray['height'] != -1 &&
                 $returnArray['height'] < $addTextArray['height'] )
            {
                $returnArray['height'] = $addTextArray['height'];
            }
        }
        $returnArray['width'] = $tmpw;
        return $returnArray;
    }

    /**
     * this will be called at a new page to return the state to what it was on the
     * end of the previous page, before the stack was closed down
     * This is to get around not being able to have open 'q' across pages
     *
     */
    function saveState( $pageEnd = 0 )
    {
        if ( $pageEnd )
        {
            // this will be called at a new page to return the state to what it was on the
            // end of the previous page, before the stack was closed down
            // This is to get around not being able to have open 'q' across pages
            $opt = $this->stateStack[$pageEnd]; // ok to use this as stack starts numbering at 1
            $this->setColor($opt['col'],1);
            $this->setStrokeColor($opt['str'],1);
            $this->objects[$this->currentContents]['c'].="\n".$opt['lin'];
            //$this->currentLineStyle = $opt['lin'];
        }
        else
        {
            $this->nStateStack++;
            $this->stateStack[$this->nStateStack]=array( 'col' => $this->currentColour,
                                                         'str' => $this->currentStrokeColour,
                                                         'lin' => $this->currentLineStyle );
        }
        $this->objects[$this->currentContents]['c'] .= "\nq";
    }

    /**
     * restore a previously saved state
     */
    function restoreState( $pageEnd = 0 )
    {
        if ( !$pageEnd )
        {
            $n = $this->nStateStack;
            $this->currentColour = $this->stateStack[$n]['col'];
            $this->currentStrokeColour = $this->stateStack[$n]['str'];
            $this->objects[$this->currentContents]['c'] .= "\n".$this->stateStack[$n]['lin'];
            $this->currentLineStyle = $this->stateStack[$n]['lin'];
            unset( $this->stateStack[$n] );
            $this->nStateStack--;
        }
        $this->objects[$this->currentContents]['c'] .= "\nQ";
    }

    /**
     * make a loose object, the output will go into this object, until it is closed, then will revert to
     * the current one.
     * this object will not appear until it is included within a page.
     * the function will return the object number
     */
    function openObject()
    {
        $this->nStack++;
        $this->stack[$this->nStack] = array( 'c' => $this->currentContents,
                                             'p' => $this->currentPage );
        // add a new object of the content type, to hold the data flow
        $this->numObj++;
        $this->o_contents( $this->numObj, 'new' );
        $this->currentContents = $this->numObj;
        $this->looseObjects[$this->numObj] = 1;

        return $this->numObj;
    }

    /**
     * open an existing object for editing
     */
    function reopenObject( $id )
    {
        $this->nStack++;
        $this->stack[$this->nStack] = array( 'c' => $this->currentContents,
                                             'p' => $this->currentPage );
        $this->currentContents=$id;
        // also if this object is the primary contents for a page, then set the current page to its parent
        if ( isset( $this->objects[$id]['onPage'] ) )
        {
            $this->currentPage = $this->objects[$id]['onPage'];
        }
    }

    /**
     * close an object
     */
    function closeObject()
    {
        // close the object, as long as there was one open in the first place, which will be indicated by
        // an objectId on the stack.
        if ( $this->nStack > 0 )
        {
            $this->currentContents=$this->stack[$this->nStack]['c'];
            $this->currentPage=$this->stack[$this->nStack]['p'];
            $this->nStack--;
            // easier to probably not worry about removing the old entries, they will be overwritten
            // if there are new ones.
        }
    }

    /**
     * stop an object from appearing on pages from this point on
     */
    function stopObject( $id )
    {
        // if an object has been appearing on pages up to now, then stop it, this page will
        // be the last one that could contian it.
        if ( isset( $this->addLooseObjects[$id] ) )
        {
            $this->addLooseObjects[$id] = '';
        }
    }

    /**
     * after an object has been created, it wil only show if it has been added, using this function.
     */
    function addObject( $id, $options = 'add' )
    {
        // add the specified object to the page
        if ( isset( $this->looseObjects[$id] ) && $this->currentContents != $id )
        {
            // then it is a valid object, and it is not being added to itself
            switch ( $options )
            {
            case 'all':
                // then this object is to be added to this page (done in the next block) and
                // all future new pages.
                $this->addLooseObjects[$id] = 'all';
            case 'add':
                if ( isset( $this->objects[$this->currentContents]['onPage'] ) )
                {
                    // then the destination contents is the primary for the page
                    // (though this object is actually added to that page)
                    $this->o_page( $this->objects[$this->currentContents]['onPage'], 'content', $id );
                }
                break;
            case 'even':
                $this->addLooseObjects[$id] = 'even';
                $pageObjectId = $this->objects[$this->currentContents]['onPage'];
                if ( $this->objects[$pageObjectId]['info']['pageNum'] % 2 == 0 )
                {
                    $this->addObject( $id ); // hacky huh :)
                }
                break;
            case 'odd':
                $this->addLooseObjects[$id] = 'odd';
                $pageObjectId = $this->objects[$this->currentContents]['onPage'];
                if ( $this->objects[$pageObjectId]['info']['pageNum'] % 2 == 1 )
                {
                    $this->addObject( $id ); // hacky huh :)
                }
                break;
            case 'next':
                $this->addLooseObjects[$id] = 'all';
                break;
            case 'nexteven':
                $this->addLooseObjects[$id] = 'even';
                break;
            case 'nextodd':
                $this->addLooseObjects[$id] = 'odd';
                break;
            }
        }
    }

    /**
     * add content to the documents info object
     */
    function addInfo( $label, $value = 0 )
    {
        // this will only work if the label is one of the valid ones.
        // modify this so that arrays can be passed as well.
        // if $label is an array then assume that it is key=>value pairs
        // else assume that they are both scalar, anything else will probably error
        if ( is_array( $label ) )
        {
            foreach ( $label as $l => $v )
            {
                $this->o_info( $this->infoObject, $l, $v );
            }
        }
        else
        {
            $this->o_info( $this->infoObject, $label, $value );
        }
    }

    /**
     * set the viewer preferences of the document, it is up to the browser to obey these.
     */
    function setPreferences( $label, $value = 0 )
    {
        // this will only work if the label is one of the valid ones.
        if ( is_array( $label ) )
        {
            foreach ( $label as $l => $v )
            {
                $this->o_catalog( $this->catalogId, 'viewerPreferences', array( $l => $v ) );
            }
        }
        else
        {
            $this->o_catalog( $this->catalogId, 'viewerPreferences', array( $label => $value ) );
        }
    }

    /**
     * extract an integer from a position in a byte stream
     *
     * @access private
     */
    function PRVT_getBytes( &$data, $pos, $num )
    {
        // return the integer represented by $num bytes from $pos within $data
        $ret = 0;
        for ( $i = 0; $i < $num; $i++ )
        {
            $ret = $ret * 256;
            $ret+= ord( $data[$pos+$i] );
        }
        return $ret;
    }

    /**
     * add a PNG image into the document, from a file
     * this should work with remote files
     *
     * \return true if adding image succeded
     */
    function addPngFromFile( $file, $x, $y, $w = 0, $h = 0 )
    {
        // read in a png file, interpret it, then add to the system
        $error = 0;
        $tmp = get_magic_quotes_runtime();
        set_magic_quotes_runtime(0);
        $fp = @fopen( $file, 'rb' );
        if ( $fp )
        {
            $data = '';
            while ( !feof( $fp ) )
            {
                $data .= fread( $fp, 1024 );
            }
            fclose( $fp );
        }
        else
        {
            $error = 1;
            $errormsg = 'trouble opening file: '.$file;
        }
        set_magic_quotes_runtime( $tmp );

        if ( !$error )
        {
            $header = chr(137).chr(80).chr(78).chr(71).chr(13).chr(10).chr(26).chr(10);
            if ( substr( $data, 0, 8 ) != $header )
            {
                $error = 1;
                $errormsg = 'this file does not have a valid header';
            }
        }

        if ( !$error )
        {
            // set pointer
            $p = 8;
            $len = strlen($data);
            // cycle through the file, identifying chunks
            $haveHeader = 0;
            $info = array();
            $idata = '';
            $pdata = '';
            while ( $p < $len )
            {
                $chunkLen = $this->PRVT_getBytes($data,$p,4);
                $chunkType = substr($data,$p+4,4);
                //echo $chunkType.' - '.$chunkLen.'<br>';

                switch ( $chunkType )
                {
                case 'IHDR':
                    // this is where all the file information comes from
                    $info['width'] = $this->PRVT_getBytes( $data, $p+8, 4 );
                    $info['height'] = $this->PRVT_getBytes( $data, $p+12, 4);
                    $info['bitDepth'] = ord( $data[$p+16] );
                    $info['colorType'] = ord( $data[$p+17] );
                    $info['compressionMethod'] = ord( $data[$p+18] );
                    $info['filterMethod'] = ord( $data[$p+19] );
                    $info['interlaceMethod'] = ord( $data[$p+20] );
                    //print_r($info);
                    $haveHeader = 1;
                    if ( $info['compressionMethod'] != 0 )
                    {
                        $error = 1;
                        $errormsg = 'unsupported compression method';
                    }
                    if ( $info['filterMethod'] != 0 )
                    {
                        $error = 1;
                        $errormsg = 'unsupported filter method';
                    }
                    break;

                case 'PLTE':
                    $pdata .= substr( $data, $p + 8, $chunkLen );
                    break;
                case 'IDAT':
                    $idata .= substr( $data, $p + 8, $chunkLen );
                    break;
                case 'tRNS':
                    //this chunk can only occur once and it must occur after the PLTE chunk and before IDAT chunk
                    //print "tRNS found, color type = ".$info['colorType']."<BR>";
                    $transparency = array();
                    if ( $info['colorType'] == 3 )
                    {
                        // indexed color, rbg
                        /* corresponding to entries in the plte chunk
                        Alpha for palette index 0: 1 byte
                        Alpha for palette index 1: 1 byte
                        ...etc...
                        */
                        // there will be one entry for each palette entry. up until the last non-opaque entry.
                        // set up an array, stretching over all palette entries which will be o (opaque) or 1 (transparent)
                        $transparency['type'] = 'indexed';
                        $numPalette = strlen($pdata)/3;
                        $trans = 0;
                        for ( $i = $chunkLen; $i >= 0; $i-- )
                        {
                            if ( ord( $data[$p+8+$i] ) == 0 )
                            {
                                $trans = $i;
                            }
                        }
                        $transparency['data'] = $trans;

                    }
                    elseif ( $info['colorType'] == 0 )
                    {
                        // grayscale
                        /* corresponding to entries in the plte chunk
                         Gray: 2 bytes, range 0 .. (2^bitdepth)-1
                        */
                        //$transparency['grayscale']=$this->PRVT_getBytes($data,$p+8,2); // g = grayscale
                        $transparency['type'] = 'indexed';
                        $transparency['data'] = ord( $data[$p+8+1] );

                    }
                    elseif ( $info['colorType'] == 2)
                    {
                        // truecolor
                        /* corresponding to entries in the plte chunk
                        Red: 2 bytes, range 0 .. (2^bitdepth)-1
                        Green: 2 bytes, range 0 .. (2^bitdepth)-1
                        Blue: 2 bytes, range 0 .. (2^bitdepth)-1
                        */
                        $transparency['r'] = $this->PRVT_getBytes( $data, $p+8, 2 ); // r from truecolor
                        $transparency['g'] = $this->PRVT_getBytes( $data, $p+10 ,2 ); // g from truecolor
                        $transparency['b'] = $this->PRVT_getBytes( $data, $p+12 ,2 ); // b from truecolor
                    }
                    else
                    {
                        //unsupported transparency type
                    }
                    // KS End new code
                    break;
                default:
                    break;
                }

                $p += $chunkLen+12;
            }

            if ( !$haveHeader )
            {
                $error = 1;
                $errormsg = 'information header is missing';
            }
            if ( isset( $info['interlaceMethod']) && $info['interlaceMethod'] )
            {
                $error = 1;
                $errormsg = 'There appears to be no support for interlaced images in pdf.';
            }
        }

        if ( !$error && $info['bitDepth'] > 8 )
        {
            $error = 1;
            $errormsg = 'only bit depth of 8 or less is supported';
        }

        if ( !$error )
        {
            if ( $info['colorType'] != 2 && $info['colorType'] != 0 && $info['colorType'] != 3 )
            {
                $error = 1;
                $errormsg = 'transparancey alpha channel not supported, transparency only supported for palette images.';
            }
            else
            {
                switch ( $info['colorType'] )
                {
                case 3:
                    $color = 'DeviceRGB';
                    $ncolor = 1;
                    break;
                case 2:
                    $color = 'DeviceRGB';
                    $ncolor = 3;
                    break;
                case 0:
                    $color = 'DeviceGray';
                    $ncolor = 1;
                    break;
                }
            }
        }
        if ( $error )
        {
            eZDebug::writeError( 'Adding PNG file, '. $file .', to PDF failed: '.$errormsg, 'Cpdf::addPngFromFile' );
            $this->addMessage('PNG error - ('.$file.') '.$errormsg);
            return false;
        }
        if ( $w == 0 )
        {
            $w = $h/$info['height'] * $info['width'];
        }
        if ( $h == 0 )
        {
            $h = $w * $info['height'] / $info['width'];
        }
        //print_r($info);
        // so this image is ok... add it in.
        $this->numImages++;
        $im = $this->numImages;
        $label = 'I'.$im;
        $this->numObj++;
    //  $this->o_image($this->numObj,'new',array('label'=>$label,'data'=>$idata,'iw'=>$w,'ih'=>$h,'type'=>'png','ic'=>$info['width']));
        $options = array( 'label' => $label,
                          'data' => $idata,
                          'bitsPerComponent' => $info['bitDepth'],
                          'pdata' => $pdata,
                          'iw' => $info['width'],
                          'ih' => $info['height'],
                          'type' => 'png',
                          'color' => $color,
                          'ncolor' => $ncolor );

        if ( isset( $transparency ) )
        {
            $options['transparency'] = $transparency;
        }
        $this->o_image( $this->numObj, 'new', $options );

        $this->objects[$this->currentContents]['c'].="\nq";
        $this->objects[$this->currentContents]['c'].="\n".sprintf('%.3F',$w)." 0 0 ".sprintf('%.3F',$h)." ".sprintf('%.3F',$x)." ".sprintf('%.3F',$y)." cm";
        $this->objects[$this->currentContents]['c'].="\n/".$label.' Do';
        $this->objects[$this->currentContents]['c'].="\nQ";
    }

    /**
     * add a JPEG image into the document, from a file
     */
    function addJpegFromFile( $img, $x, $y, $w = 0, $h = 0 )
    {
        // attempt to add a jpeg image straight from a file, using no GD commands
        // note that this function is unable to operate on a remote file.

        if ( !file_exists( $img ) )
        {
            //echo "FILE NOT EXISTS: $img";
            return;
        }

        $tmp = getimagesize( $img );
        $imageWidth = $tmp[0];
        $imageHeight = $tmp[1];

        if ( isset( $tmp['channels'] ) )
        {
            $channels = $tmp['channels'];
        }
        else
        {
            $channels = 3;
        }

        if ( $w <= 0 && $h <= 0 )
        {
            $w = $imageWidth;
        }
        if ( $w == 0 )
        {
            $w = $h / $imageHeight * $imageWidth;
        }
        if ( $h == 0 )
        {
            $h = $w * $imageHeight / $imageWidth;
        }

        $fp = fopen( $img, 'rb' );

        $tmp = get_magic_quotes_runtime();
        set_magic_quotes_runtime( 0 );
        $data = fread( $fp, filesize( $img ) );
        set_magic_quotes_runtime( $tmp );

        fclose( $fp );

        $this->addJpegImage_common( $data, $x, $y, $w, $h, $imageWidth, $imageHeight, $channels );
    }

    /**
     * add an image into the document, from a GD object
     * this function is not all that reliable, and I would probably encourage people to use
     * the file based functions
     */
    function addImage( &$img, $x, $y, $w = 0, $h = 0, $quality = 75 )
    {
        // add a new image into the current location, as an external object
        // add the image at $x,$y, and with width and height as defined by $w & $h

        // note that this will only work with full colour images and makes them jpg images for display
        // later versions could present lossless image formats if there is interest.

        // there seems to be some problem here in that images that have quality set above 75 do not appear
        // not too sure why this is, but in the meantime I have restricted this to 75.
        if ( $quality > 75 )
        {
            $quality = 75;
        }

        // if the width or height are set to zero, then set the other one based on keeping the image
        // height/width ratio the same, if they are both zero, then give up :)
        $imageWidth = imagesx( $img );
        $imageHeight = imagesy( $img );

        if ( $w <= 0 && $h <= 0 )
        {
            return;
        }
        if ( $w == 0 )
        {
            $w = $h / $imageHeight * $imageWidth;
        }
        if ( $h == 0 )
        {
            $h = $w * $imageHeight / $imageWidth;
        }

        // gotta get the data out of the img..

        // so I write to a temp file, and then read it back.. soo ugly, my apologies.
        $tmpDir = '/tmp';
        $tmpName = tempnam( $tmpDir, 'img' );
        imagejpeg( $img, $tmpName, $quality );
        $fp = fopen( $tmpName, 'rb' );

        $tmp = get_magic_quotes_runtime();
        set_magic_quotes_runtime( 0 );
        $fp = @fopen( $tmpName, 'rb' );
        if ( $fp )
        {
            $data = '';
            while ( !feof( $fp ) )
            {
                $data .= fread( $fp, 1024 );
            }
            fclose( $fp );
        }
        else
        {
            $error = 1;
            $errormsg = 'trouble opening file';
        }
    //  $data = fread($fp,filesize($tmpName));
        set_magic_quotes_runtime( $tmp );
    //  fclose( $fp );
        unlink( $tmpName );
        $this->addJpegImage_common( $data, $x, $y, $w, $h, $imageWidth, $imageHeight );
    }

    /**
     * common code used by the two JPEG adding functions
     *
     * @access private
     */
    function addJpegImage_common( &$data, $x, $y, $w = 0, $h = 0, $imageWidth, $imageHeight, $channels = 3 )
    {
        // note that this function is not to be called externally
        // it is just the common code between the GD and the file options
        $this->numImages++;
        $im = $this->numImages;
        $label = 'I'.$im;
        $this->numObj++;
        $this->o_image( $this->numObj, 'new', array( 'label' => $label,
                                                     'data' => $data,
                                                     'iw' => $imageWidth,
                                                     'ih' => $imageHeight,
                                                     'channels' => $channels ) );

        $this->objects[$this->currentContents]['c'] .= "\nq";
        $this->objects[$this->currentContents]['c'] .= "\n".sprintf('%.3F',$w)." 0 0 ".sprintf('%.3F',$h)." ".sprintf('%.3F',$x)." ".sprintf('%.3F',$y)." cm";
        $this->objects[$this->currentContents]['c'] .= "\n/".$label.' Do';
        $this->objects[$this->currentContents]['c'] .= "\nQ";
    }

    /**
     * specify where the document should open when it first starts
     */
    function openHere( $style, $a = 0, $b = 0, $c = 0 )
    {
        // this function will open the document at a specified page, in a specified style
        // the values for style, and the required paramters are:
        // 'XYZ'  left, top, zoom
        // 'Fit'
        // 'FitH' top
        // 'FitV' left
        // 'FitR' left,bottom,right
        // 'FitB'
        // 'FitBH' top
        // 'FitBV' left
        $this->numObj++;
        $this->o_destination( $this->numObj, 'new', array( 'page' => $this->currentPage,
                                                           'type' => $style,
                                                           'p1' => $a, 'p2' => $b, 'p3' => $c ) );
        $id = $this->catalogId;
        $this->o_catalog( $id, 'openHere', $this->numObj );
    }

    /**
     * create a labelled destination within the document
     */
    function addDestination($label,$style,$a=0,$b=0,$c=0)
    {
        // associates the given label with the destination, it is done this way so that a destination can be specified after
        // it has been linked to
        // styles are the same as the 'openHere' function
        $this->numObj++;
        $this->o_destination( $this->numObj, 'new', array( 'page' => $this->currentPage,
                                                           'type' => $style,
                                                           'p1' => $a, 'p2' => $b, 'p3' => $c ) );
        $id = $this->numObj;
        // store the label->idf relationship, note that this means that labels can be used only once
        $this->destinations["$label"] = $id;
    }

    /**
     * define font families, this is used to initialize the font families for the default fonts
     * and for the user to add new ones for their fonts. The default bahavious can be overridden should
     * that be desired.
     */
    function setFontFamily($family,$options='')
    {
        if (!is_array($options))
        {
            if ($family=='init')
            {
                // set the known family groups
                // these font families will be used to enable bold and italic markers to be included
                // within text streams. html forms will be used... <b></b> <i></i>
                $this->fontFamilies['Helvetica'] = array(
                    'b'=>'Helvetica-Bold'
                    ,'i'=>'Helvetica-Oblique'
                    ,'bi'=>'Helvetica-BoldOblique'
                    ,'ib'=>'Helvetica-BoldOblique'
                    );
                $this->fontFamilies['Courier'] = array(
                    'b'=>'Courier-Bold'
                    ,'i'=>'Courier-Oblique'
                    ,'bi'=>'Courier-BoldOblique'
                    ,'ib'=>'Courier-BoldOblique'
                    );
                $this->fontFamilies['Times-Roman'] = array(
                    'b'=>'Times-Bold'
                    ,'i'=>'Times-Italic'
                    ,'bi'=>'Times-BoldItalic'
                    ,'ib'=>'Times-BoldItalic'
                    );
            }
        }
        else
        {
            // the user is trying to set a font family
            // note that this can also be used to set the base ones to something else
            if (strlen($family))
            {
                $this->fontFamilies[$family] = $options;
            }
        }
    }

    /**
     * used to add messages for use in debugging
     */
    function addMessage( $message )
    {
        $this->messages .= $message."\n";
    }

    /**
     * a few functions which should allow the document to be treated transactionally.
     */
    function transaction( $action )
    {
        switch ( $action )
        {
        case 'start':
            // store all the data away into the checkpoint variable
            $data = get_object_vars( $this );
            $this->checkpoint = $data;
            unset( $data );
            break;
        case 'commit':
            if ( is_array( $this->checkpoint ) && isset( $this->checkpoint['checkpoint'] ) )
            {
                $tmp = $this->checkpoint['checkpoint'];
                $this->checkpoint = $tmp;
                unset( $tmp );
            }
            else
            {
                $this->checkpoint = '';
            }
            break;
        case 'rewind':
            // do not destroy the current checkpoint, but move us back to the state then, so that we can try again
            if ( is_array( $this->checkpoint ) )
            {
                // can only abort if were inside a checkpoint
                $tmp = $this->checkpoint;
                foreach ( $tmp as $k => $v )
                {
                    if ( $k != 'checkpoint' )
                    {
                        $this->$k = $v;
                    }
                }
                unset($tmp);
            }
            break;
        case 'abort':
            if ( is_array( $this->checkpoint ) )
            {
                // can only abort if were inside a checkpoint
                $tmp = $this->checkpoint;
                foreach ( $tmp as $k => $v )
                {
                    $this->$k = $v;
                }
                unset($tmp);
            }
            break;
        }

    }

    /*!
     \static

     \param new cmyk array 1
     \param new cmyk array 2

     \return true if equal, false if not
    */
    function compareCMYK( $cmykArray1, $cmykArray2 )
    {
        return ( $cmykArray1['c'] == $cmykArray2['c'] &&
                 $cmykArray1['m'] == $cmykArray2['m'] &&
                 $cmykArray1['y'] == $cmykArray2['y'] &&
                 $cmykArray1['k'] == $cmykArray2['k'] );
    }

    /*!
     Push current text state, and set specified to current

     \param new text state
    */
    function pushTextState( $newState )
    {
        $this->textStateStack[] = $this->currentTextState;
        $this->currentTextState = $newState;
        $this->setCurrentFont();
    }

    /*!
     Pop text stack, and set to previous state.
    */
    function popTextState( )
    {
        $this->currentTextState = array_pop( $this->textStateStack );
        $this->setCurrentFont();
    }

    public $textStateStack = array( '' );
} // end of class

?>
