<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.pdf.create">
    <title>Erstellen und Laden von PDF Dokumenten</title>

    <para>
        Die <classname>Zend_Pdf</classname> Klasse bildet das <acronym>PDF</acronym> Dokument ab
        und stellt Operationen auf Dokumentebene bereit.
    </para>

    <para>
        Um ein neues Dokument zu stellen, sollte zuerst ein neues <classname>Zend_Pdf</classname>
        Objekt erstellt werden.
    </para>

    <para>
        Die <classname>Zend_Pdf</classname> Klasse stellt zwei statische Methoden zum Laden von
        bestehenden <acronym>PDF</acronym> Dokumenten bereit. Dies sind die
        <methodname>Zend_Pdf::load()</methodname> und <methodname>Zend_Pdf::parse()</methodname>
        Methoden. Beide geben als Ergebnis <classname>Zend_Pdf</classname> Objekte zurück oder
        werfen eine Ausnahme, wenn ein Fehler auftritt.
    </para>

    <example id="zend.pdf.create.example-1">
        <title>Erstellen und Laden von PDF Dokumenten</title>

        <programlisting language="php"><![CDATA[
...
// Erstelle ein neues PDF Dokument
$pdf1 = new Zend_Pdf();

// Lade ein PDF Dokument aus einer Datei
$pdf2 = Zend_Pdf::load($fileName);

// Lade ein PDF Dokument aus einer Zeichenkette
$pdf3 = Zend_Pdf::parse($pdfString);
...
]]></programlisting>
    </example>

    <para>
        Das <acronym>PDF</acronym> Datei Format unterstützt die schrittweise Aktualisierung von
        Dokumenten. Jedes Mal, wenn ein Dokument aktualisiert wird, wird eine neue Revision des
        Dokuments erstellt. Die <classname>Zend_Pdf</classname> Komponente unterstützt die Rückgabe
        einer vorgegebenen Revision des Dokuments.
    </para>

    <para>
        Die Revision kann den Methoden <methodname>Zend_Pdf::load()</methodname> und
        <methodname>Zend_Pdf::parse()</methodname> als zweiter Parameter übergeben oder durch Aufruf
        der <methodname>Zend_Pdf::rollback()</methodname> Methode.

        <footnote>
            <para>
                Die <methodname>Zend_Pdf::rollback()</methodname> Methode muss vor einer Änderung
                eines Dokuments aufgerufen werden, andernfalls ist das Verhalten nicht definiert.
            </para>
        </footnote>

        Aufruf angefordert werden.
    </para>

    <example id="zend.pdf.create.example-2">
        <title>Rückgabe einer vorgegebenen Revision eines PDF Dokuments</title>

        <programlisting language="php"><![CDATA[
...
// Lade die vorherige Revision des PDF Dokuments
$pdf1 = Zend_Pdf::load($fileName, 1);

// Lade die vorherige Revision des PDF Dokuments
$pdf2 = Zend_Pdf::parse($pdfString, 1);

// Lade die erste Revision des PDF Dokuments
$pdf3 = Zend_Pdf::load($fileName);
$revisions = $pdf3->revisions();
$pdf3->rollback($revisions - 1);
...
]]></programlisting>
    </example>
</sect1>
