PDF utiliza la misma geometría que PostScript. Se inicia desde la parte inferior izquierda de la página y por defecto se mide en puntos (1/72 de pulgada).

El tamaño de la página se puede recuperar desde un objeto página:

$width  = $pdfPage->getWidth();
$height = $pdfPage->getHeight();

PDF tiene una poderosa capacidad de representación de colores. El módulo Zend_Pdf soporta la Escala de Grises, y los espacios de color RGB y CMYK. Cualquiera de ellos puede ser usado en cualquier lugar, donde el objeto Zend_Pdf_Color sea requerido. Las clases Zend_Pdf_Color_GrayScale , Zend_Pdf_Color_Rgb y Zend_Pdf_Color_Cmyk proporcionan esta funcionalidad:

// $grayLevel (float number). 0.0 (black) - 1.0 (white)
$color1 = new Zend_Pdf_Color_GrayScale($grayLevel);

// $r, $g, $b (float numbers). 0.0 (min intensity) - 1.0 (max intensity)
$color2 = new Zend_Pdf_Color_Rgb($r, $g, $b);

// $c, $m, $y, $k (float numbers). 0.0 (min intensity) - 1.0 (max intensity)
$color3 = new Zend_Pdf_Color_Cmyk($c, $m, $y, $k);

Los estilos de colores HTML también se proporcionan con la clase Zend_Pdf_Color_Html :

$color1 = new Zend_Pdf_Color_Html('#3366FF');
$color2 = new Zend_Pdf_Color_Html('silver');
$color3 = new Zend_Pdf_Color_Html('forestgreen');

Todas las operaciones de dibujo se puede hacer en un contexto de página PDF .

La clase Zend_Pdf_Page proporciona un conjunto de primitivas de dibujo:

/**
 * Dibujar una línea desde x1,y1 hasta x2,y2.
 *
 * @param float $x1
 * @param float $y1
 * @param float $x2
 * @param float $y2
 * @return Zend_Pdf_Page
 */
public function drawLine($x1, $y1, $x2, $y2);

/**
 * Dibujar un rectángulo.
 *
 * Rellenar los tipos:
 * Zend_Pdf_Page::SHAPE_DRAW_FILL_AND_STROKE - rellenar el rectángulo
 *                                             y delinearlo (por defecto)
 * Zend_Pdf_Page::SHAPE_DRAW_STROKE          - delinear el rectángulo
 * Zend_Pdf_Page::SHAPE_DRAW_FILL            - rellenar el rectángulo
 *
 * @param float $x1
 * @param float $y1
 * @param float $x2
 * @param float $y2
 * @param integer $fillType
 * @return Zend_Pdf_Page
 */
public function drawRectangle($x1, $y1, $x2, $y2,
                    $fillType = Zend_Pdf_Page::SHAPE_DRAW_FILL_AND_STROKE);

/**
 * Dibujar un polígono.
 *
 * Si $fillType es Zend_Pdf_Page::SHAPE_DRAW_FILL_AND_STROKE o
 * Zend_Pdf_Page::SHAPE_DRAW_FILL, entonces el polígono se cierra automáticamente.
 * Véase la descripción detallada de estos métodos en la documentación de PDF
 * (sección 4.4.2 Path painting Operators, Filling)
 *
 * @param array $x  - array de float (la coordenada X de los vértices)
 * @param array $y  - array de float (la coordenada Y de los vértices)
 * @param integer $fillType
 * @param integer $fillMethod
 * @return Zend_Pdf_Page
 */
public function drawPolygon($x, $y,
                            $fillType =
                                Zend_Pdf_Page::SHAPE_DRAW_FILL_AND_STROKE,
                            $fillMethod =
                                Zend_Pdf_Page::FILL_METHOD_NON_ZERO_WINDING);

/**
 * Dibujar un círculo centrado en X, y con un radio de radius.
 *
 * Los ángulos están especificados en radianes.
 *
 * Firmas del Método::
 * drawCircle($x, $y, $radius);
 * drawCircle($x, $y, $radius, $fillType);
 * drawCircle($x, $y, $radius, $startAngle, $endAngle);
 * drawCircle($x, $y, $radius, $startAngle, $endAngle, $fillType);
 *
 *
 * No es un círculo de verdad, porque PDF sólo admite curvas cúbicss de Bezier,
 * pero con muy buena aproximación.
 * Se distingue de un verdadero círculo en un máximo de 0.00026 radios (en PI/8,
 * 3*PI/8, 5*PI/8, 7*PI/8, 9*PI/8, 11*PI/8, 13*PI/8 y 15*PI/8 ángulos).
 * A 0, PI/4, PI/2, 3*PI/4, PI, 5*PI/4, 3*PI/2 y 7*PI/4 es exactamente
 * la tangente a un círculo.
 *
 * @param float $x
 * @param float $y
 * @param float $radius
 * @param mixed $param4
 * @param mixed $param5
 * @param mixed $param6
 * @return Zend_Pdf_Page
 */
public function  drawCircle($x,
                            $y,
                            $radius,
                            $param4 = null,
                            $param5 = null,
                            $param6 = null);

/**
 * Dibujar una elipse dentro del rectángulo especificado.
 *
 * Firmas del método:
 * drawEllipse($x1, $y1, $x2, $y2);
 * drawEllipse($x1, $y1, $x2, $y2, $fillType);
 * drawEllipse($x1, $y1, $x2, $y2, $startAngle, $endAngle);
 * drawEllipse($x1, $y1, $x2, $y2, $startAngle, $endAngle, $fillType);
 *
 * Los ángulos se especifican en radianes
 *
 * @param float $x1
 * @param float $y1
 * @param float $x2
 * @param float $y2
 * @param mixed $param5
 * @param mixed $param6
 * @param mixed $param7
 * @return Zend_Pdf_Page
 */
public function drawEllipse($x1,
                            $y1,
                            $x2,
                            $y2,
                            $param5 = null,
                            $param6 = null,
                            $param7 = null);

Las operaciones de dibujo de texto también existen en el contexto de una página PDF . Puede dibujar una sola línea de texto en cualquier posición en la página mediante el suministro de las coordenadas X e Y de la base de referencia. La fuente y tamaño actual de la letra se utilizan para operaciones de dibujo de texto (ver descripción detallada más abajo).

/**
 * Dibujar una línea de texto en una posición específica.
 *
 * @param string $text
 * @param float $x
 * @param float $y
 * @param string $charEncoding (opcional) Codificación de caracteres del texto
 * fuente. El valor por defecto es la codificación actual y local.
 * @throws Zend_Pdf_Exception
 * @return Zend_Pdf_Page
 */
public function drawText($text, $x, $y, $charEncoding = '');

...
$pdfPage->drawText('Hello world!', 72, 720);
...

Por defecto, los strings de texto se interpretan usando el método de codificación de la localización actual. Si tiene un string que utiliza un método de codificación diferente (como un string UTF-8 a leer desde un archivo en disco, o un string MacRoman obtenido a partir del legado de una base de datos), puede indicar la codificación de caracteres a llamar en tiempo de dibujo y Zend_Pdf se encargará de la conversión. Puede proporcionar la fuente de cualquier método de codificación de strings soportados por la función de PHP iconv() :

...
// Leer del disco un string codificado en UTF-8
$unicodeString = fread($fp, 1024);

// Dibujar un string en la página
$pdfPage->drawText($unicodeString, 72, 720, 'UTF-8');
...

Zend_Pdf_Page::drawText() utiliza la fuente y el tamaño actual de la fuente de la página, que se establece con el método Zend_Pdf_Page::setFont() :

/**
 * Establecer la fuente actual.
 *
 * @param Zend_Pdf_Resource_Font $font
 * @param float $fontSize
 * @return Zend_Pdf_Page
 */
public function setFont(Zend_Pdf_Resource_Font $font, $fontSize);

Los documentos PDF soportan fuentes PostScript Type 1 y TrueType, así como dos tipos especializados de PDF , Type 3 y fuentes compuestas. También hay 14 fuentes estándar Tipo 1 incorporadas para cada visor PDF : Courier (4 estilos), Helvetica (4 estilos), Times (4 estilos), Symbol y Zapf Dingbats.

Zend_Pdf actualmente soporta el estándar de 14 fuentes PDF , así como sus propias fuentes personalizadas TrueType. Los objetos Font se obtienen a través de una de los dos métodos de fábrica: Zend_Pdf_Font::fontWithName($fontName) para las 14 fuentes estándar PDF o Zend_Pdf_Font::fontWithPath($filePath) para fuentes personalizadas.

...
// Crear una fuente nueva
$font = Zend_Pdf_Font::fontWithName(Zend_Pdf_Font::FONT_HELVETICA);

// Aplicar la fuente
$pdfPage->setFont($font, 36);
...

Los nombres de las 14 constantes para el tipo de letra estándar de PDF se definen en la clase Zend_Pdf_Font :

También puede utilizar cualquier fuente individual TrueType (que generalmente tiene una extensión '.ttf') o bien una fuente OpenType (con la extensión '.otf') si contiene esquemas TrueType. Actualmente no están soportadas, pero está previsto para una versión futura archivos de fuentes .dfont de Mac OS X y de Microsoft TrueType Collection(extensión '.ttc').

Para utilizar una fuente TrueType, debe proporcionar toda la ruta del archivo a la fuente del programa. Si la fuente no se puede leer por alguna razón, o si no es una fuente TrueType, el método de fábrica arrojará una excepción:

...
// Crear una nueva fuente
$goodDogCoolFont = Zend_Pdf_Font::fontWithPath('/path/to/GOODDC__.TTF');

// Aplicar la fuente
$pdfPage->setFont($goodDogCoolFont, 36);
...

Por defecto, las fuentes personalizadas serán incorporados en el documento PDF resultante. Esto permite que los destinatarios vean la página como está previsto, incluso si no tienen los tipos de letra apropiados instalados en su sistema. Si le preocupa el tamaño del archivo, puede pedir que la fuente del programa no sea integrada pasando una opción 'do not embed' ("no incluir") al método de fábrica:

...
// Crear una nueva fuente
$goodDogCoolFont = Zend_Pdf_Font::fontWithPath('/path/to/GOODDC__.TTF',
                                               Zend_Pdf_Font::EMBED_DONT_EMBED);

// Aplicar la fuente
$pdfPage->setFont($goodDogCoolFont, 36);
...

Si el programa no es de fuentes incrustadas, pero el destinatario del archivo PDF tiene instalada la fuente en su sistema, va a ver el documento como estaba previsto. Si no tiene la fuente correcta instalada, la aplicación del visor de PDF hará todo lo posible para sintetizar un sustituto.

Algunas fuentes tienen normas específicas de concesión de licencias que les impiden ser tenidas en cuenta en documentos PDF . Así que no son capturados con la "guardia baja" por la presente, si intenta utilizar una fuente que no puede ser incorporada, el método de fábrica lanzará una excepción.

Puede seguir utilizando esas fuentes, pero debe pasar el flag de no incluir como se ha descripto anteriormente, o simplemente puede suprimir la excepción:

...
$font = Zend_Pdf_Font::fontWithPath(
           '/path/to/unEmbeddableFont.ttf',
           Zend_Pdf_Font::EMBED_SUPPRESS_EMBED_EXCEPTION
        );
...

Esta técnica de supresión se prefiere si va a permitir a un usuario final a elegir sus propios tipos de letra. Las fuentes que puedan ser embebidas en el documento PDF , lo harán, aquellos que no puedan, no.

Los de programas de fuentes pueden ser bastante grandes, algunas llegan a decenas de megabytes. Por defecto, todas las fuentes incorporadas son comprimidas utilizando el esquema de compresión Flate, lo que resulta en un ahorro de espacio del 50% en promedio. Si, por alguna razón, no desea comprimir la fuente del programa, se puede desactivar con una opción:

...
$font = Zend_Pdf_Font::fontWithPath('/path/to/someReallyBigFont.ttf',
                                    Zend_Pdf_Font::EMBED_DONT_COMPRESS);
...

Por último, en caso necesario, puede combinar las opciones de la integración mediante el operador binario OR:

...
$font = Zend_Pdf_Font::fontWithPath(
            $someUserSelectedFontPath,
            (Zend_Pdf_Font::EMBED_SUPPRESS_EMBED_EXCEPTION |
            Zend_Pdf_Font::EMBED_DONT_COMPRESS));
...

Las fuentes estándar PDF utilizan internamente varias codificaciones de un solo byte (véase PDF Reference, Sixth Edition, version 1.7 Apéndice D para más detalles). Son, en general, igual al conjunto de caracteres Latin1 (excepto las fuentes ZapfDingbats y Symbol).

Zend_Pdf usa CP1252 (WinLatin1) para dibujar el texto con las fuentes estándar.

El texto todavía se puede proporcionar en cualquier otra codificación, que debe ser especificada si ésta es distinto de una fuente local actual. Realmente, sólo se dibujarán caracteres WinLatin1.

...
$font = Zend_Pdf_Font::fontWithName(Zend_Pdf_Font::FONT_COURIER);
$pdfPage->setFont($font, 36)
        ->drawText('Euro sign - €', 72, 720, 'UTF-8')
        ->drawText('Text with umlauts - à è ì', 72, 650, 'UTF-8');
...

El módulo Zend_Pdf proporciona una posibilidad de extraer las fuentes de los documentos cargados.

Puede ser útil para las actualizaciones incrementales de un documento. Sin esta funcionalidad tiene que agregar y posiblemente, incrustar una fuente en un documento cada vez que desee actualizarlo.

Los objetos Zend_Pdf y Zend_Pdf_Page proporcionan métodos especiales para extraer todas las fuentes mencionadas en un documento o una página:

...
$pdf = Zend_Pdf::load($documentPath);
...
// Obtener todas las fuentes del documento
$fontList = $pdf->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 . ': The quick brown fox jumps over the lazy dog',
                    100,
                    $yPosition,
                    'UTF-8');
    $yPosition -= 30;
}
...
// Obtener las fuentes referenciadas dentro de la primera página del documento
$firstPage = reset($pdf->pages);
$firstPageFonts = $firstPage->extractFonts();
...

...
$pdf = new Zend_Pdf();
...
$pdf->pages[] = ($page = $pdf->newPage(Zend_Pdf_Page::SIZE_A4));

$font = Zend_Pdf_Font::fontWithPath($fontPath);
$page->setFont($font, $fontSize);
$page->drawText($text, $x, $y);
...
// Este nombre de fuente debe ser almacenado en algún lugar...
$fontName = $font->getFontName(Zend_Pdf_Font::NAME_POSTSCRIPT,
                               'en',
                               'UTF-8');
...
$pdf->save($docPath);
...

...
$pdf = Zend_Pdf::load($docPath);
...
$pdf->pages[] = ($page = $pdf->newPage(Zend_Pdf_Page::SIZE_A4));

/* $srcPage->extractFont($fontName) también se puede usar aquí */
$font = $pdf->extractFont($fontName);

$page->setFont($font, $fontSize);
$page->drawText($text, $x, $y);
...
$pdf->save($docPath, true /* modo de actualización incremental */);
...

Las fuentes extraídas pueden ser utilizadas en el lugar de cualquier otra fuente con las siguientes limitaciones:

La clase Zend_Pdf_Page proporciona el método drawImage() para dibujar la imagen:

/**
 * Dibujar una imagen en una posición específica de la página.
 *
 * @param Zend_Pdf_Resource_Image $image
 * @param float $x1
 * @param float $y1
 * @param float $x2
 * @param float $y2
 * @return Zend_Pdf_Page
 */
public function drawImage(Zend_Pdf_Resource_Image $image, $x1, $y1, $x2, $y2);

Los objetos imagen deben ser creados con el método Zend_Pdf_Image::imageWithPath($filePath) (imágenes JPG, PNG y TIFF ahora son soportadas):

...
// Cargar la imagen
$image = Zend_Pdf_Image::imageWithPath('my_image.jpg');

$pdfPage->drawImage($image, 100, 100, 400, 300);
...

Importante! el soporte a JPEG requiere que se configure la extensión PHP GD. Importante! el soporte a PNG requiere que se configure la extensión ZLIB para trabajar con imágenes canal Alfa.

Consulte la documentación de PHP para obtener información detallada ( http://www.php.net/manual/en/ref.image.php ). ( http://www.php.net/manual/en/ref.zlib.php ).

El estilo del dibujo de líneas está definido por el ancho de línea, el color de línea y el patrón del tipo de línea. Todo esto parámetros pueden ser asignados por los métodos de la clase Zend_Pdf_Page :

/** Establecer el color de la línea. */
public function setLineColor(Zend_Pdf_Color $color);

/** Establecer el ancho de la línea. */
public function setLineWidth(float $width);

/**
 * Establecer el patrón de líneas de guiones.
 *
 * El patrón es una array de números de punto flotante:
 *     array(on_length, off_length, on_length, off_length, ...)
 * La fase está desplazada lateralmente desde el comienzo de la línea.
 *
 * @param array $pattern
 * @param array $phase
 * @return Zend_Pdf_Page
 */
public function setLineDashingPattern($pattern, $phase = 0);

Los métodos Zend_Pdf_Page::drawRectangle() , Zend_Pdf_Page::drawPolygon() , Zend_Pdf_Page::drawCircle() y Zend_Pdf_Page::drawEllipse() toman el argumento $fillType como un parámetro opcional. Puede ser:

El método Zend_Pdf_Page::drawPolygon() también tiene un parámetro adicional $fillMethod :

En cualquier momento el estado de la página de gráficos (fuente actual, tamaño de la fuente, color de línea, color de relleno, estilo de línea, rotación de la página, clip del área) se pueden guardar y restaurarlos luego. Guardar la operación pone los datos a un estado de pila de gráficos, la operación de restauración se recupera a partir de ahí.

Existen dos métodos en la clase Zend_Pdf_Page para estas operaciones:

/**
 * Salva el estado de los gráficos de esta página.
 * Esta toma una instantánea del estilo aplicado actualmente, posición,
 * área de recorte y cualquier rotación/traducción/escalado que ha sido
 * aplicada.
 *
 * @return Zend_Pdf_Page
 */
public function saveGS();

/**
 * Restablecer los gráficos que se guardaron con la última llamada a
 * saveGS().
 *
 * @return Zend_Pdf_Page
 */
public function restoreGS();

PDF y el módulo Zend_Pdf dan soporte de recorte a la zona de dibujo. La zona actual de Clip límita las regiones de la página de los operadores afectados por la pintura. En principio, es la página entera.

La clase Zend_Pdf_Page proporciona un conjunto de métodos para las operaciones de recorte.

/**
 * Intersectar el área actual de recorte con un rectángulo.
 *
 * @param float $x1
 * @param float $y1
 * @param float $x2
 * @param float $y2
 * @return Zend_Pdf_Page
 */
public function clipRectangle($x1, $y1, $x2, $y2);

/**
 * Intersectar el área actual de recorte con un polígono.
 *
 * @param array $x  - array de float (la coordenada X de los vértices)
 * @param array $y  - array de float (la coordenada Y de los vértices)
 * @param integer $fillMethod
 * @return Zend_Pdf_Page
 */
public function clipPolygon($x,
                            $y,
                            $fillMethod =
                                Zend_Pdf_Page::FILL_METHOD_NON_ZERO_WINDING);

/**
 * Intersectar el área actual de recorte con un círculo.
 *
 * @param float $x
 * @param float $y
 * @param float $radius
 * @param float $startAngle
 * @param float $endAngle
 * @return Zend_Pdf_Page
 */
public function clipCircle($x,
                           $y,
                           $radius,
                           $startAngle = null,
                           $endAngle = null);

/**
 * Intersectar el área actual de recorte con una elipse.
 *
 * Firmas del método:
 * drawEllipse($x1, $y1, $x2, $y2);
 * drawEllipse($x1, $y1, $x2, $y2, $startAngle, $endAngle);
 *
 * @todo process special cases with $x2-$x1 == 0 or $y2-$y1 == 0
 *
 * @param float $x1
 * @param float $y1
 * @param float $x2
 * @param float $y2
 * @param float $startAngle
 * @param float $endAngle
 * @return Zend_Pdf_Page
 */
public function clipEllipse($x1,
                            $y1,
                            $x2,
                            $y2,
                            $startAngle = null,
                            $endAngle = null);

La clase Zend_Pdf_Style proporciona la funcionalidad de los estilos.

Los estilos se pueden utilizar para almacenar un conjunto de parámetros de estado del gráfico y aplicarlo a un página PDF por una operación:

/**
 * Establecer el estilo a utilizar para futuras operaciones de dibujo sobre esta página
 *
 * @param Zend_Pdf_Style $style
 * @return Zend_Pdf_Page
 */
public function setStyle(Zend_Pdf_Style $style);

/**
 * Regresar el estilo aplicado a la página.
 *
 * @return Zend_Pdf_Style|null
 */
public function getStyle();

La clase Zend_Pdf_Style proporciona un conjunto de métodos para obtener o configurar diferentes parámetros de estado de los gráficos:

/**
 * Establecer el color de la línea.
 *
 * @param Zend_Pdf_Color $color
 * @return Zend_Pdf_Page
 */
public function setLineColor(Zend_Pdf_Color $color);

/**
 * Obtener el color de la línea.
 *
 * @return Zend_Pdf_Color|null
 */
public function getLineColor();

/**
 * Establecer el ancho de la línea.
 *
 * @param float $width
 * @return Zend_Pdf_Page
 */
public function setLineWidth($width);

/**
 * Obtener el ancho de la línea.
 *
 * @return float
 */
public function getLineWidth();

/**
 * Establecer el patrón de la línea de guiones
 *
 * @param array $pattern
 * @param float $phase
 * @return Zend_Pdf_Page
 */
public function setLineDashingPattern($pattern, $phase = 0);

/**
 * Obtener el patrón de la línea de guiones
 *
 * @return array
 */
public function getLineDashingPattern();

/**
 * Obtener la fase de la línea de guiones
 *
 * @return float
 */
public function getLineDashingPhase();

/**
 * Establecer el color de relleno.
 *
 * @param Zend_Pdf_Color $color
 * @return Zend_Pdf_Page
 */
public function setFillColor(Zend_Pdf_Color $color);

/**
 * Obtener el color de relleno.
 *
 * @return Zend_Pdf_Color|null
 */
public function getFillColor();

/**
 * Establecer la fuente actual.
 *
 * @param Zend_Pdf_Resource_Font $font
 * @param float $fontSize
 * @return Zend_Pdf_Page
 */
public function setFont(Zend_Pdf_Resource_Font $font, $fontSize);

/**
 * Modificar el tamaño de la fuente actual.
 *
 * @param float $fontSize
 * @return Zend_Pdf_Page
 */
public function setFontSize($fontSize);

/**
 * Obtener la fuente actual.
 *
 * @return Zend_Pdf_Resource_Font $font
 */
public function getFont();

/**
 * Obtener el tamaño de la fuente actual.
 *
 * @return float $fontSize
 */
public function getFontSize();

El módulo Zend_Pdf soporta el manejo de la transparencia.

La transparencia puede ser el método Zend_Pdf_Page::setAlpha() :

/**
 * Establecer la transparencia.
 *
 * $alpha == 0  - transparente
 * $alpha == 1  - opaco
 *
 * Modos de transparencia soportados por PDF:
 * Normal (por defecto), Multiply, Screen, Overlay, Darken, Lighten,
 * ColorDodge, ColorBurn, HardLight, SoftLight, Difference, Exclusion
 *
 * @param float $alpha
 * @param string $mode
 * @throws Zend_Pdf_Exception
 * @return Zend_Pdf_Page
 */
public function setAlpha($alpha, $mode = 'Normal');