PDF gebruikt dezelfde geometrie als PostScript. Het begint van de beneden-linkse hoek van de pagina en is standaard afgemeten in points (1/72 van een duim).

De grootte van een pagina kan worden verkregen van het pagina object:

$width  = $pdfPage->getWidth();
$height = $pdfPage->getHeight();
        

PDF heeft geweldig goede kleurweergavemogelijkheden. Zend_Pdf ondersteunt grijsschalen, RGB en CMYK kleuren. Elk van deze notaties kan worden gebruikt daar waar een Zend_Pdf_Color object nodig is. De Zend_Pdf_Color_GrayScale, Zend_Pdf_Color_RGB en Zend_Pdf_Color_CMYK klassen verstrekken deze functionaliteit:

// $grayLevel (float number). 0.0 (zwart) - 1.0 (wit)
$color1 = new Zend_Pdf_Color_GrayScale($grayLevel);

// $r, $g, $b (float numbers). 0.0 (minimum intensiteit) - 1.0 (maximum intensiteit)
$color2 = new Zend_Pdf_Color_RGB($r, $g, $b);

// $c, $m, $y, $k (float numbers). 0.0 (minimum intensiteit) - 1.0 (maximum intensiteit)
$color3 = new Zend_Pdf_Color_CMYK($c, $m, $y, $k);
        

Alle tekenoperaties kunnen worden uitgevoerd in de context van een PDF pagina.

De Zend_Pdf_Page klasse verstrekt een set van teken methodes:

/**
 * Een lijn trekken van x1,y1 naar x2,y2.
 *
 * @param float $x1
 * @param float $y1
 * @param float $x2
 * @param float $y2
 */
public function drawLine($x1, $y1, $x2, $y2);
        

/**
 * Teken een rechthoek.
 *
 * Vultypes:
 * Zend_Pdf_Const::SHAPEDRAW_FILLNSTROKE - vul rechthoek en streep door (standaard)
 * Zend_Pdf_Const::SHAPEDRAW_STROKE      - streep rechthoek door
 * Zend_Pdf_Const::SHAPEDRAW_FILL        - vul rechthoek op
 *
 * @param float $x1
 * @param float $y1
 * @param float $x2
 * @param float $y2
 * @param integer $fillType
 */
public function drawRectangle($x1, $y1, $x2, $y2, $fillType = Zend_Pdf_Const::SHAPEDRAW_FILLNSTROKE);
        

/**
 * Een polygoon tekenen.
 *
 * Als $fillType een Zend_Pdf_Const::SHAPEDRAW_FILLNSTROKE of Zend_Pdf_Const::SHAPEDRAW_FILL is,
 * zal de polygoon automatisch gesloten zijn.
 * Zie een gedetailleerde beschrijving van deze methodes in een PDF documentatie
 * (sectie 4.4.2 Path painting Operators, Opvulling)
 *
 * @param array $x  - array of float (de X coordinaten van de toppen)
 * @param array $y  - array of float (de Y coordinaten van de toppen)
 * @param integer $fillType
 * @param integer $fillMethod
 */
public function drawPolygon($x, $y,
                            $fillType = Zend_Pdf_Const::SHAPEDRAW_FILLNSTROKE,
                            $fillMethod = Zend_Pdf_Const::FILLMETHOD_NONZEROWINDING);
        

/**
 * Teken een cirkel gecentreerd op x, y met een radius van radius.
 *
 * Hoeken zijn aangeduid in radianten
 *
 * Method signatures:
 * drawCircle($x, $y, $radius);
 * drawCircle($x, $y, $radius, $fillType);
 * drawCircle($x, $y, $radius, $startAngle, $endAngle);
 * drawCircle($x, $y, $radius, $startAngle, $endAngle, $fillType);
 *
 *
 * Het is niet echt een cirkel want PDF ondersteunt alleen Bezier krommen.
 * Maar het komt er héél dichtbij.
 * Het verschilt maximaal 0.00026 radianten van een cirkel
 * (op PI/8, 3*PI/8, 5*PI/8, 7*PI/8, 9*PI/8, 11*PI/8, 13*PI/8 and 15*PI/8 hoeken).
 * Op 0, PI/4, PI/2, 3*PI/4, PI, 5*PI/4, 3*PI/2 en 7*PI/4 zijn het exacte tangenten van cirkels.
 *
 * @param float $x
 * @param float $y
 * @param float $radius
 * @param mixed $param4
 * @param mixed $param5
 * @param mixed $param6
 */
public function  drawCircle($x, $y, $radius, $param4 = null, $param5 = null, $param6 = null);
        

/**
 * Teken een ellips in een bepaalde rechthoek.
 *
 * Method signatures:
 * drawEllipse($x1, $y1, $x2, $y2);
 * drawEllipse($x1, $y1, $x2, $y2, $fillType);
 * drawEllipse($x1, $y1, $x2, $y2, $startAngle, $endAngle);
 * drawEllipse($x1, $y1, $x2, $y2, $startAngle, $endAngle, $fillType);
 *
 * Hoeken zijn aangeduid in radianten
 *
 * @param float $x1
 * @param float $y1
 * @param float $x2
 * @param float $y2
 * @param mixed $param5
 * @param mixed $param6
 * @param mixed $param7
 */
public function drawEllipse($x1, $y1, $x2, $y2, $param5 = null, $param6 = null, $param7 = null);
        

Ook tekst wordt geschreven in de paginacontext:

/**
 * Teken een regel tekst op de bepaalde plaats.
 *
 * @param string $text
 * @param float $x
 * @param float $y
 * @throws Zend_Pdf_Exception
 */
public function drawText($text, $x, $y );
        

Het huidige lettertype en de lettertypegrootte worden gebruikt om tekst te schrijven. Zie de gedetailleerde beschrijving hieronder.

De Zend_Pdf_Page::drawText() methode gebruikt het actieve lettertype die kan gezet worden door de Zend_Pdf_Page::drawText() methode:

/**
 * Actief lettertype zetten.
 *
 * @param Zend_Pdf_Font $font
 * @param float $fontSize
 */
public function setFont(Zend_Pdf_Font $font, $fontSize);
        

PDF ondersteunt Type1, TrueType, Type3 and composite lettertypes. Er zijn ook 14 standaard Type1 lettertypes voorzien in PDF. De Zend_Pdf module verstrekt op dit moment alleen de 14 standaard lettertypes. Die kunnen verkregen worden door de Zend_Pdf_Font_Standard klasse te gebruiken. Een bepaalde lettertype moet worden gebruikt als argument:

<?php
...
// Een nieuw lettertype maken
$font = new Zend_Pdf_Font_Standard(Zend_Pdf_Const::FONT_HELVETICA);

// lettertype actief maken
$pdfPage->setFont($font, 36);
...
?>
            

De Zend_Pdf_Const verstrekt constanten voor de 14 standaard lettertypes:

De Zend_Pdf_Page klasse voorziet de drawImage() methode om beelden te tekenen:

/**
 * Teken een beeld op de bepaalde positie.
 *
 * @param Zend_Pdf_Image $image
 * @param float $x1
 * @param float $y1
 * @param float $x2
 * @param float $y2
 */
public function drawImage(Zend_Pdf_Image $image, $x1, $y1, $x2, $y2);
        

Beeldobjecten worden door afstammelingen van de Zend_Pdf_Image klasse voorgesteld.

Alleen JPG beelden zijn momenteel ondersteund:

<?php
...
$image = new Zend_Pdf_Image_JPEG('my_image.jpg');
$pdfPage->drawImage($image, 100, 100, 400, 300);;
...
?>
            

Belangrijk! De Zend_Pdf_Image_JPEG klasse heeft de PHP GD extensie nodig.

Zie de PHP documentatie voor meer informatie (http://www.php.net/manual/nl/ref.image.php).

De lijnstijl wordt gedefinieerd door lijndikte, lijnkleur en lijnstippenpatroon. Al deze parameters kunnen door de Zend_Pdf_Page klasse methodes worden aangegeven:

/** Zet lijnkleur. */
public function setLineColor(Zend_Pdf_Color $color);

/** Zet lijndikte. */
public function setLineWidth(float $width);

/**
 * Zet lijnstippenpatroon.
 *
 * Het patroon ($pattern) is een Array van floats: array(on_length, off_length, on_length, off_length, ...)
 * Fase ($phase) is shift vanaf het begin van de lijn.
 *
 * @param array $pattern
 * @param array $phase
 */
public function setLineDashingPattern($pattern, $phase = 0);
        

De Zend_Pdf_Page::drawRectangle(), Zend_Pdf_Page::drawPoligon(), Zend_Pdf_Page::drawCircle() en Zend_Pdf_Page::drawEllipse() methodes aanvaarden het optionele argument $fillType. Dit kan het volgende zijn:

De Zend_Pdf_Page::drawPoligon() methode accepteert ook een optionele parameter $fillMethod:

Een PDF pagina kan geroteerd worden zo lang er nog niets op werd geschreven of getekend. Het wordt gedaan door de Zend_Pdf_Page::rotate() methode:

/**
 * De pagina rond het punt ($x, $y) roteren met de aangeduide hoek (in radianten).
 *
 * @param float $angle
 */
public function rotate($x, $y, $angle);
        

Op eender welk moment kan een grafische staat van een pagina (huidig lettertype, lettertype grootte, lijnkleur, vulkleur, lijnstijl, paginarotatie, clip area) worden opgeslagen en worden hersteld. De opsla-operatie slaat de data in een grafische staatstapel op, de hersteloperatie haalt ze er weer uit.

Dit zijn de Zend_Pdf_Page klassemethodes om deze operaties uit te voeren:

/**
 * De grafische staat van deze pagina opslaan.
 * Dit neemt een "foto" van de huidige stijl, positie en clipping area en
 * enige aangebrachte rotatie/vertaling/schaling.
 */
public function saveGS();

/**
 * De laatst opgeslagen grafische staat herstellen.
 */
public function restoreGS();
        

PDF en de Zend_Pdf module ondersteunen clippen van een teken area. De actieve clip area begrenst de regios van de pagina die door tekenoperaties worden beïnvloed. Initieel is het de volledige pagina.

De Zend_Pdf_Page klasse verstrekt een set methodes voor clipoperaties.

/**
 * Rechthoekig clippen.
 *
 * @param float $x1
 * @param float $y1
 * @param float $x2
 * @param float $y2
 */
public function clipRectangle($x1, $y1, $x2, $y2);
        

/**
 * Polygoon clippen.
 *
 * @param array $x  - array of float (the X co-ordinates of the vertices)
 * @param array $y  - array of float (the Y co-ordinates of the vertices)
 * @param integer $fillMethod
 */
public function clipPolygon($x, $y, $fillMethod = Zend_Pdf_Const::FILLMETHOD_NONZEROWINDING);
        

/**
 * Cirkel clippen.
 *
 * @param float $x
 * @param float $y
 * @param float $radius
 * @param float $startAngle
 * @param float $endAngle
 */
public function clipCircle($x, $y, $radius, $startAngle = null, $endAngle = null);
        

/**
 * Ellips clippen.
 *
 * Method signatures:
 * drawEllipse($x1, $y1, $x2, $y2);
 * drawEllipse($x1, $y1, $x2, $y2, $startAngle, $endAngle);
 *
 * @todo process special cases with $x2-$x1 == 0 or $y2-$y1 == 0
 *
 * @param float $x1
 * @param float $y1
 * @param float $x2
 * @param float $y2
 * @param float $startAngle
 * @param float $endAngle
 */
public function clipEllipse($x1, $y1, $x2, $y2, $startAngle = null, $endAngle = null);
        

De Zend_Pdf_Style klasse voorziet in stijlen

Stijlen kunnen gebruikt worden om een set grafische parameters op te slaan en ze toe te brengen op een PDF pagina in één operatie:

/**
 * Zet de stijl voor de komende tekenoperaties voor deze pagina
 *
 * @param Zend_Pdf_Style $style
 */
public function setStyle(Zend_Pdf_Style $style);

/**
 * Geef de stijl terug en breng ze op de pagina aan.
 *
 * @return Zend_Pdf_Style|null
 */
public function getStyle();
        

De Zend_Pdf_Style klasse voorziet in een set methodes om verschillende grafische staat parameters te zetten of te verkrijgen:

/**
 * Zet de lijnkleur.
 *
 * @param Zend_Pdf_Color $color
 */
public function setLineColor(Zend_Pdf_Color $color);
        

/**
 * verkrijg de lijnkleur.
 *
 * @return Zend_Pdf_Color|null
 */
public function getLineColor();
        

/**
 * Zet de lijndikte.
 *
 * @param float $width
 */
public function setLineWidth($width);
        

/**
 * Verkrijg de lijndikte.
 *
 * @return float
 */
public function getLineWidth($width);
        

/**
 * Zet het lijnstippenpatroon
 *
 * @param array $pattern
 * @param float $phase
 */
public function setLineDashingPattern($pattern, $phase = 0);
        

/**
 * Verkrijg het lijnstippenpatroon
 *
 * @return array
 */
public function getLineDashingPattern();
        

/**
 * Verkrijg de lijnstippenfase
 *
 * @return float
 */
public function getLineDashingPhase();
        

/**
 * Zet de vulkleur
 *
 * @param Zend_Pdf_Color $color
 */
public function setFillColor(Zend_Pdf_Color $color);
        

/**
 * Verkrijg de vulkleur
 *
 * @return Zend_Pdf_Color|null
 */
public function getFillColor();
        

/**
 * Zet actief lettertype
 *
 * @param Zend_Pdf_Font $font
 * @param float $fontSize
 */
public function setFont(Zend_Pdf_Font $font, $fontSize);
        

/**
 * Wijzig huidige lettertype grootte
 *
 * @param float $fontSize
 */
public function setFontSize($fontSize);
        

/**
 * Verkrijg huidig lettertype
 *
 * @return Zend_Pdf_Font $font
 */
public function getFont();
        

/**
 * Verkrijg huidige lettertype grootte
 *
 * @return float $fontSize
 */
public function getFontSize();