Zeichnen Geometrie PDF verwendet die selbe Geometrie wie PostScript. Sie beginnt an der linken unteren Ecke der Seite und wird in Punkten (1/72 Zoll) gemessen. Die Seitengröße kann vom Seitenobjekt erhalten werden: getWidth(); $height = $pdfPage->getHeight(); ]]> Farben PDF bietet leistungsfähige Möglichkeiten für die Farbdarstellung. Die Zend_Pdf Komponente unterstützt die Grauskala sowie RGB und CYMK Farbräume. Jede kann überall verwendet werden, wo ein Zend_Pdf_Color Objekt benötigt wird. Die Zend_Pdf_Color_GrayScale, Zend_Pdf_Color_Rgb und Zend_Pdf_Color_Cmyk Klassen stellen folgende Funktionalitäten bereit: Die HTML Farben werden auch durch die Klasse Zend_Pdf_Color_Html bereitgestellt: Zeichnen von Formen Alle Zeichenoperationen können im Kontext einer PDF Seite durchgeführt werden. Die Zend_Pdf_Page Klass stellt einen Satz von einfachen Formen bereit: Zeichnen von Text Auch alle Textoperationen können im Kontext einer PDF Seite durchgeführt werden. Du kannst eine einzige Textzeile an jeder Position auf der Seite durch Übergabe der X und Y Koordinaten für die Grundlinie zeichnen. Der aktuelle Zeichensatz und die aktuelle Zeichengröße werden für die Textoperationen verwendet (beachte die detaillierte Beschreibung unten). Zeichne einen String auf der Seite drawText('Hello world!', 72, 720); ... ]]> Standardmäßig werden Textstrings unter Verwendung der Zeichenkodierungsmethode der aktuelle "locale" interpretiert. Wenn du einen String hast, der eine andere Zeichenkodierungsmethode verwendet (wie zum Beispiel ein UTF-8 String, der aus einer Datei auf der Platte gelesen wurde, oder ein MacRoman String, der aus einer älteren Datenbank erhalten wurde), kannst du die Zeichenkodierung zum Zeitpunkt des Zeichnens angeben und Zend_Pdf wird die Konvertierung für dich durchführen. Du kannst Quellstrings in jeder Kodierungsmethode übergeben, die von PHP's iconv() Funktion unterstützt wird. Zeiche einen UTF-8 kodierten String auf der Seite drawText($unicodeString, 72, 720, 'UTF-8'); ... ]]> Verwendung von Zeichensätzen Zend_Pdf_Page::drawText() verwendet den aktuellen Zeichensatz und die aktuelle Zeichengröße der Seite, die mit der Methode Zend_Pdf_Page::setFont() festgelegt werden: PDF Dokumente unterstützt PostScript Type1 und TrueType Zeichensätze, sowie die zwei speziellen PDF Typen Type3 und zusammengesetzte Zeichensätze (composite fonts). Es gibt zudem 14 Type1 Standardzeichensätze, die von jedem PDF Viewer bereit gestellt werden: Courier (4 Stile), Helvetica (4 Stile), Times (4 Stile), Symbol und Zapf Dingbats. Die Zend_Pdf Komponente unterstützt derzeit diese 14 PDF Standardzeichensätze sowie deine eigenen TrueType Zeichensätze. Zeichensatzobjekte können über eine der zwei Fabrikmethoden (factory methods) erhalten werden: Zend_Pdf_Font::fontWithName($fontName) für die 14 PDF Standardzeichensätze oder Zend_Pdf_Font::fontWithPath($filePath) für eigene Zeichensätze. Einen Standardzeichensatz erstellen setFont($font, 36); ... ]]> Die Zeichensatzkonstanten für die 14 PDF Standardzeichensätze sind innerhalb der Zend_Pdf_Font Klasse definiert: Zend_Pdf_Font::FONT_COURIER Zend_Pdf_Font::FONT_COURIER_BOLD Zend_Pdf_Font::FONT_COURIER_ITALIC Zend_Pdf_Font::FONT_COURIER_BOLDITALIC Zend_Pdf_Font::FONT_TIMES_ROMAN Zend_Pdf_Font::FONT_TIMES_BOLD Zend_Pdf_Font::FONT_TIMES_ITALIC Zend_Pdf_Font::FONT_TIMES_BOLDITALIC Zend_Pdf_Font::FONT_HELVETICA Zend_Pdf_Font::FONT_HELVETICA_BOLD Zend_Pdf_Font::FONT_HELVETICA_ITALIC Zend_Pdf_Font::FONT_HELVETICA_BOLDITALIC Zend_Pdf_Font::FONT_SYMBOL Zend_Pdf_Font::FONT_ZAPFDINGBATS Du kannst außerdem jeden individuellen TrueType Zeichensatz (welcher normalerweise eine '.ttf' Erweiterung hat) oder einen OpenType Zeichensatz ('.otf' Erweiterung) verwenden, wenn er TrueType Konturen enthält. Bisher nicht unterstützt, aber für zukünftige Versionen geplant, sind Mac OS X .dfont Dateien und Microsoft TrueType Collection ('.ttc' Erweiterung) Dateien. Um einen TrueType Zeichensatz zu verwenden, mußt du den kompletten Verzeichnispfad zum Zeichensatzprogramm angeben. Wenn der Zeichensatz aus welchem Grund auch immer nicht gelesen werden kann oder wenn es kein TrueType Zeichensatz ist, wird the Fabrikmethode eine Ausnahme werfen: Einen TrueType Zeichensatz erstellen setFont($goodDogCoolFont, 36); ... ]]> Standardmäßig werden eigene Zeichensätze in das erstellte PDF Dokument eingebettet. Dies ermöglicht den Empfänger, die Seite wie beabsichtigt anzuschauen, sogar wenn sie den entsprechenden Zeichensatz auf ihrem System gar nicht installiert haben. Wenn du dich über die Dateigröße sorgst, kannst du angeben, dass das Zeichensatzprogramm nicht eingebettet wird, indem du eine 'nicht einbetten' Option an die Fabrikmethode übergibst: Erstelle einen TrueType Zeichensatz, aber bette ihn nicht in das PDF Dokument ein setFont($goodDogCoolFont, 36); ... ]]> Wenn das Zeichensatzprogramm nicht eingebettet wurde, aber den Empfänger der PDF Datei diesen Zeichensatz auf seinem System installiert hat, wird er das Dokument so sehen wie beabsichtigt. Wenn sie nicht den korrekten Zeichensatz installiert haben, wird der PDF Viewer sich bemühen, um einen Ersatz herzustellen. Einige Zeichensätze haben sehr spezielle Lizensierungsregeln, die das Einbetten in PDF Dokumente verhindern. Damit du dadurch nicht überrascht wirst, wenn du versuchst einen Zeichensatz einzubetten, der nicht eingebettet werden kann, wird die Fabrikmethode eine Ausnahme werfen. Du kannst diese Zeichensätze weiterhin verwenden, aber du mußt entweder die 'nicht einbetten' Option übergeben wie oben beschrieben oder du kannst einfach die Ausnahme unterdrücken: Werfe keine Ausnahme für Zeichensätze, die nicht eingebettet werden können Diese Unterdrückungstechnik wird bevorzugt, wenn du einen Endnutzer erlaubst, seine eigenen Zeichensätze auszuwählen. Zeichensätze, die in ein PDF Dokument eingebettet werden können, werden eingebettet, andere nicht. Zeichensatzprogramme können sehr groß sein, manche erreichen Dutzende von Megabytes. Standardmäßig werden alle eingebetteten Zeichensätze unter Verwendung des Flate Kompressionsschemas komprimiert, woraus im Schnitt 50% an Speicherplatz gespart werden kann. Wenn du aus welchem Grund auch immer nicht möchtest, dass das Zeichensatzprogramm kompimiert wird, kannst du dies mit einer Option abschalten: Komprimiere einen eingebetten Zeichensatz nicht Zuguterletzt, kannst du die Einbettungsoptionen mit Hilfe des OR Operators kombinieren, wenn notwendig: Kombiniere die Zeichensatz Einbettungsoptionen Limits der Standard PDF Schriften Die Standard PDF Schriften verwendetn intern verschiedene Single-Byte Encodings (siehe PDF Reference, Sixth Edition, version 1.7 Anhang D für Details). Diese sind generell gleich wie beim Latin1 Zeichensatz (ausser den Symbol und ZapfDingbats Schriften). Zend_Pdf verwendet CP1252 (WinLatin1) für das Zeichnen von Text mit Standardschriften. Text kann trotzdem in jedem anderen Encoding angegeben werden, welches spezifiziert werden muß wenn es sich vom aktuellen Gebietsschema unterscheidet. Nur WinLatin1 Zeichen werden aktuell gezeichnet. Kombinieren mit in Schriften enthaltenen Optionen setFont($font, 36) ->drawText('Euro sign - €', 72, 720, 'UTF-8') ->drawText('Text with umlauts - à è ì', 72, 650, 'UTF-8'); ... ]]> Schriften extrahieren Das Zend_Pdf Modul bietet die Möglichkeit Schriften von geladenen Dokumenten zu extrahieren. Das kann für aufsteigende Dokumenten Updates nützlich sein. Ohne diese Funktionalität müssen Schriften jedes Mal in ein Dokument hinzugefügt und möglicherweise eingebetten werden, wenn es aktualisiert werden soll. Die Zend_Pdf und Zend_Pdf_Page Objekte bieten spezielle Methoden um alle genannten Schriften innerhalb eines Dokuments oder einer Seite zu extrahieren: Schriften von einem geladenen Dokument extrahieren extractFonts(); $pdf->pages[] = ($page = $pdf->newPage(Zend_Pdf_Page::SIZE_A4)); $yPosition = 700; foreach ($fontList as $font) { $page->setFont($font, 15); $fontName = $font->getFontName(Zend_Pdf_Font::NAME_POSTSCRIPT, 'en', 'UTF-8'); $page->drawText($fontName . ': Der schnelle braune Fuchs springt ' . 'über den lahmen Hund', 100, $yPosition, 'UTF-8'); $yPosition -= 30; } ... // Alle Schriften, die in der ersten Seite des Dokuments // referenziert sind erhalten $firstPage = reset($pdf->pages); $firstPageFonts = $firstPage->extractFonts(); ... ]]> Eine Schrift von einem geladenen Dokument extrahieren durch die Angabe des Schriftnamens pages[] = ($page = $pdf->newPage(Zend_Pdf_Page::SIZE_A4)); $font = Zend_Pdf_Font::fontWithPath($fontPath); $page->setFont($font, $fontSize); $page->drawText($text, $x, $y); ... // Diese Schrift sollte woanders gespeichert werden... $fontName = $font->getFontName(Zend_Pdf_Font::NAME_POSTSCRIPT, 'en', 'UTF-8'); ... $pdf->save($docPath); ... ]]> pages[] = ($page = $pdf->newPage(Zend_Pdf_Page::SIZE_A4)); /* $srcPage->extractFont($fontName) kann auch hier verwendet werden */ $font = $pdf->extractFont($fontName); $page->setFont($font, $fontSize); $page->drawText($text, $x, $y); ... $pdf->save($docPath, true /* aufsteigender Update Modus */); ... ]]> Extrahierte Schriften können statt jeder anderen Schrift mit den folgenden Einschränkungen verwendet werden: Eine extrahierte Schrift kann nur im Kontext des Dokuments verwendet werden von dem es extrahiert wurde. Ein möglicherweise eingebettetes Schriftprogramm wird aktuell nicht extrahiert. Deswegen können extrahierte Schriften keine richtigen Schriftmaße bieten und die originale Schrift wird für die Berechnung der Breite verwendet: extractFont($fontName); $originalFont = Zend_Pdf_Font::fontWithPath($fontPath); $page->setFont($font, /* Die extrahierte Schrift für das Zeichnen verwenden */ $fontSize); $xPosition = $x; for ($charIndex = 0; $charIndex < strlen($text); $charIndex++) { $page->drawText($text[$charIndex], xPosition, $y); // Die originale Schrift für die Berechnung der Breite des Textes verwenden $width += $originalFont->widthForGlyph( $originalFont->glyphNumberForCharacter($text[$charIndex]) ); $xPosition += $width/$originalFont->getUnitsPerEm()*$fontSize; } ... ]]> Zeichnen von Grafiken Die Zend_Pdf_Page Klasse stellt die drawImage() Methode für das Zeichnen von Grafiken bereit: Grafikobjekte sollten mit der Methode Zend_Pdf_Image::imageWithPath($filePath) erzeugt werden. (Es werden zur Zeit JPG, PNG und TIFF Grafiken unterstützt): Zeichnen von Grafiken drawImage($image, 100, 100, 400, 300); ... ]]> Wichtig! JPG Support setzt voraus, dass die GD Erweiterung für PHP konfiguriert wurde. Wichtig! PNG Support setzt voraus, dass die ZLIB Erweiterung konfiguriert wurde, um mit Grafiken mit Alphakanal zu arbeiten. Wende dich an die PHP Dokumentation für weitere Informationen (http://www.php.net/manual/de/ref.image.php). (http://www.php.net/manual/de/ref.zlib.php). Stil der Strichzeichnungen Der Stil der Strichzeichnungen wurd durch die Linienbreite, die Linienfarbe und das Strichmuster definiert. Alle diese Parameter können an die Klassenmethoden von Zend_Pdf_Page übergeben werden: Füllstil Die Methoden Zend_Pdf_Page::drawRectangle(), Zend_Pdf_Page::drawPolygon(), Zend_Pdf_Page::drawCircle() und Zend_Pdf_Page::drawEllipse() akzeptieren das $fillType Argument als optionalen Parameter. Es kann lauten: Zend_Pdf_Page::SHAPE_DRAW_STROKE - strichele die Form Zend_Pdf_Page::SHAPE_DRAW_FILL - fülle die Form Zend_Pdf_Page::SHAPE_DRAW_FILL_AND_STROKE - fülle und strichele die Form (Standardverhalten) Die Zend_Pdf_Page::drawPolygon() Methode akzeptiert $fillMethod als zusätzlichen Parameter: Zend_Pdf_Page::FILL_METHOD_NON_ZERO_WINDING (Standardverhalten) Die PDF Referenz beschreibt diese Regel wie folgt:
Die Regel der nicht-Null Fensternummer erkennt ob ein gegebener Punkt in einem Pfad liegt, indem konzeptuell ein Strahl von diesem Punkt in die Unendlichkeit in jede Richtung gezeichnet wird und dann die Plätze betrachtet werden an denen der Pfad den Strahl kreuzt. Beginnend mit der Anzahl 0, fügt die Regel jedesmal 1 hinzu wenn ein Pfadsegment den Strahl von links nach rechts kreuzt, und substrahiert jedesmal 1 wenn ein Segment von rechts nach links kreuzt. Wenn nach dem Zählen aller Kreuzungen das Ergebnis ß ist, dann ist der Punkt ausserhalb des Pfades; andernfalls ist er innerhalb. Beachte: Die gerade beschriebene Methode spezifiziert nicht was zu tun ist wenn ein Pfadsegment mit dem gewählten Strahl übereinstimmt oder ihn tangiert. Da die Richtung des Strahls beliebig ist wählt die Regel einen Strahl der solche problematischen Schnittpunkte nicht verursacht. Für einfache konvexe Pfade, definierte die Regel der nicht-Null Fensternummer das Innen und Aussen wie man es intuitiv erwarten würde. Die interessanteren Fälle sind jene die komplexe oder selbst-schneidenden Pfade wie jene in Figur 4.10 gezeigt (in der PDF Referenz). Für einen Pfad der aus einem fünf-punktigen Stern besteht, und mit fünf verbundenen geraden Linien besteht die sich gegenseitig schneiden, nimmt die Regel an dass das Innen die komplette Fläche ist, welche vom Stern eingeschlossen wird, inklusive dem Pentagon in der Mitte. Für einen Pfad der aus zwei konzentrischen Kreisen besteht, wird angenommen das die Fläche welche von beiden Kreisen eingeschlossen wird innen ist, wobei beide in der selben Richtung gezeichnet sein müssen. Wenn die Kreise in entgegengesetzten Richtungen gezeichnet werden, wird nur die "Donut" Form zwischen Ihnen als Innen angenommen, entsprechend der Regel; das "Donut Loch" ist Aussen.
Zend_Pdf_Page::FILL_METHOD_EVEN_ODD Die PDF Referenz beschreibt diese Regel wie folgt:
Eine alternative zur Regel der nicht-Null Fensternummer ist die gerade-ungerade Regel. Diese Regel erkennt die "Innenhaftigkeit" eines Punktes indem ein Strahl von diesem Punkt in jede Richtung gezeichnet wird und einfach die Anzahl der Pfadsegmente gezählt wird, welche den Strahl kreuzen, unabhängig von der Richtung. Wenn die Anzahl ungerade ist, dann ist der Punkt innerhalb; ist Sie gerade ist der Punkt ausserhalb. Das verursacht die gleichen Resultate wie die Regel der nicht-Null Fensternummer für Pfade mit einfachen Formen, produziert aber unterschiedliche Resultate für komplexere Formen. Figur 4.11 (in der PDF Referenz) zeigt die Effekte wenn die gerade-ungerade Regel auf komplexe Pfade angewendet wird. Für den Fünf-punktigen Stern nimmt die Regel an dass die Triangularpunkte innerhalb des Pfades liegen, aber nicht das Pentagon im Zentrum. Für die zwei konzentrischen Kreise, wird nur von der "Donut" Form angenommen das Sie innerhalb liegt, unabhängig von der Richtung in welcher die Kreise gezeichnet werden.
Lineare Transformationen Drehungen Bevor eine Zeichenoperation angewendet wird, können PDF Seiten gedreht werden. Dies kann mit Hilfe der Zend_Pdf_Page::rotate() Methode durchgeführt werden: Beginnend mit ZF 1.8, Skalierung Skalenänderungen werden durch die Zend_Pdf_Page::scale() Methode angeboten: Beginnend mit ZF 1.8, Bewegungen Das bewegen des Koordinationssystem wird von der Zend_Pdf_Page::translate() Methode durchgeführt: Beginnend mit ZF 1.8, Drehungen Das Drehen der Seite kann durch Verwendung der Zend_Pdf_Page::skew() Methode durchgeführt werden: Speichern/Wiederherstellen des Grafikzustand Jederzeit kann der Grafikzustand der Seite (aktueller Zeichensatz, Schriftgröße, Linienfarbe, Füllfarbe, Linienstil, Seitendrehung, Zeichenbereich) gespeichert und wiederhergestellt werden. Speicheroperationen legen die Daten auf einen Grafikzustand Stapel, Wiederherstelloperationen holen Sie daher zurück. In der Zend_Pdf_Page Klasse gibt es für diese Operationen zwei Methoden: Zeichenbereich PDF und die Zend_Pdf Komponente unterstützen die Begrenzung des Zeichenbereichs. Der aktuelle Zeichenbereich begrenzt den Seitenbereich, der von Zeichenoperationen beeinflusst werden kann. Zu Beginn ist dies die gesamte Seite. Die Zend_Pdf_Page Klasse stellt einen Satz von Methoden für die Begrenzung bereit. Stile Die Zend_Pdf_Style Klasse stellt Stilfunktionalitäten bereit. Stile können verwendet werden, um mit einer Operation die Parameter für den Grafikzustand zu speichern und auf eine PDF Seite anzuwenden: Die Zend_Pdf_Style Klasse stellt einen Satz von Methoden bereit, um verschiedene Parameter des Grafikstadiums zu setzen und zu holen: Transparenz Das Zend_Pdf Modul unterstützt die Handhabung von Transparenz. Transparenz kann durch Verwendung der Zend_Pdf_Page::setAlpha() Methode gesetzt werden: