# Trabalhando com Páginas

## Criação de Página

As páginas em um documento PDF são representadas como instâncias de `Zend_Pdf_Page` em `Zend_Pdf`.

Páginas PDF podem ser carregadas de um PDF existente ou criadas usando a API de `Zend_Pdf`.

Novas páginas podem ser criadas instanciando novos objetos `Zend_Pdf_Page` diretamente ou chamando o método `Zend_Pdf::newPage()`, que retorna um objeto `Zend_Pdf_Page`. `Zend_Pdf::newPage()` cria uma página já anexada à um documento. Páginas desanexadas não podem ser usadas com múltiplos documentos PDF, mas elas possuem uma performance relativamente maior.

Esta é uma limitação da versão atual do Zend Framework. Esta limitação será eliminada nas versões futuras. Mas páginas desanexadas sempre terão um desempenho melhor no compartilhamento de páginas entre diversos documentos.

O método `Zend_Pdf::newPage()` e o construtor `Zend_Pdf_Page` recebem os mesmos parâmetros de definição do tamanho da página. Eles podem receber tanto o tamanho da página ($x, $y) em pontos (1/72 polegadas) quanto uma constante pré-definida representando um tipo de página:

- Zend_Pdf_Page::SIZE_A4

- Zend_Pdf_Page::SIZE_A4_LANDSCAPE

- Zend_Pdf_Page::SIZE_LETTER

- Zend_Pdf_Page::SIZE_LETTER_LANDSCAPE

As páginas de um documento são armazenadas no atributo público `$pages` da classe `Zend_Pdf`. O atributo contém uma matriz de objetos `Zend_Pdf_Page` e define completamente as instâncias e ordem das páginas. Esta matriz pode ser manipulada como qualquer outra matriz do PHP:

### Gerenciamento de páginas de documentos PDF

    ...
    // Inverte a ordem das páginas
    $pdf->pages = array_reverse($pdf->pages);
    ...
    // Adiciona nova página
    $pdf->pages[] = new Zend_Pdf_Page(Zend_Pdf_Page::SIZE_A4);
    // Adiciona nova página
    $pdf->pages[] = $pdf->newPage(Zend_Pdf_Page::SIZE_A4);

    // Remove uma página específica
    unset($pdf->pages[$id]);

    ...

## Clonagem de Página

Páginas PDF podem ser clonadas através da criação de um novo objeto `Zend_Pdf_Page` com uma página já existente como parâmetro:

### Clonando páginas existentes

    ...
    // Armazena a página template em uma variável separada
    $template = $pdf->pages[$templatePageIndex];
    ...
    // Adiciona nova página
    $page1 = new Zend_Pdf_Page($template);
    $pdf->pages[] = $page1;
    ...

    // Adiciona outra página
    $page2 = new Zend_Pdf_Page($template);
    $pdf->pages[] = $page2;
    ...

    // Remove a fonte da página template dos documentos
    unset($pdf->pages[$templatePageIndex]);

    ...

É útil caso você precise criar diversas páginas usando um template.

Importante! Uma página clonada compartilha alguns recursos do PDF com uma página template, então ela só pode ser usada no mesmo documento como uma página template. Um documento modificado pode ser salvo como um novo documento.