<sect1 id="zend.pdf.create">
    <title>Criando e Carregando documentos PDF.</title>
    <para>
     A classe <code>Zend_Pdf</code> representa o próprio documento PDF e provê
     funcionalidades para manupulação do documento.
    </para>

    <para>
    Para criar um novo documento, um objeto <code>Zend_Pdf</code> deve ser instanciado.
    </para>

    <para>
    A classe <code>Zend_Pdf</code> também provê dois métodos estáticos para carregar um PDF existente.
    Os métodos são o <code>Zend_Pdf::load()</code> e o <code>Zend_Pdf::parse()</code>.
    Ambos retornam um objeto Zend_Pdf como resultado, ou uma exceção se algum erro ocorrer.
    </para>

    <example id="zend.pdf.create.example-1">
        <title>Criar um novo documento PDF ou Carregar um já existente.</title>
        <programlisting role="php"><![CDATA[<?php
...
// Create new PDF document.
$pdf1 = new Zend_Pdf();

// Load PDF document from a file.
$pdf2 = Zend_Pdf::load($fileName);

// Load PDF document from a string.
$pdf3 = Zend_Pdf::parse($pdfString);
...]]>
      </programlisting>
    </example>

    <para>
    O formato de arquivo PDF suporta a atualização incremental do documento. Dessa forma, toda vez que um documento
    é atualizado uma nova revisão do documento é criada.
    O módulo Zend_Pdf suporta a recuperação da revisão especificada.
    </para>
    <para>
    A revisão pode ser especificada como o segundo parâmetro dos métodos <code>Zend_Pdf::load()</code> e
    <code>Zend_Pdf::parse()</code> ou solicitada através de <code>Zend_Pdf::rollback()</code>
        <footnote>
            <para>
            O método <code>Zend_Pdf::rollback()</code> deve ser chamado antes que qualquer mudança seja
            aplicada ao documento.
            De outra forma o coportamento do método é indefinido.
            </para>
        </footnote>
    call.
    </para>

    <example id="zend.pdf.create.example-2">
        <title>Solicitando uma revisão específica do documento PDF.</title>
        <programlisting role="php"><![CDATA[<?php
...
// Load PDF previouse revision of the document.
$pdf1 = Zend_Pdf::load($fileName, 1);

// Load PDF previouse revision of the document.
$pdf2 = Zend_Pdf::parse($pdfString, 1);

// Load first revision of the document.
$pdf3 = Zend_Pdf::load($fileName);
$revisions = $pdf3->revisions();
$pdf3->rollback($revisions - 1);
...]]>
        </programlisting>
    </example>


</sect1>
<!--
vim:se ts=4 sw=4 et:
-->
