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
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
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.