Anexar fuentes extra para un PDF clase FPDF

En ocasiones necesitamos que nuestro PDF generado con la clase FPDF o derivadas tengo una mejor presentación con el uso de la fuentes, pero las fuentes que tiene la clase son muy pocas, si revisamos la documentación encontramos que la instrucción SetFont explica lo siguiente:

«Establece la fuente usada para imprimir cadenas de carácteres. Es obligatorio invocar este método por lo menos una vez antes de imprimir texto o el documento resultante no será válido.

La fuente puede ser una estándar o una adicionada via el método AddFont().»

Es decir, las fuentes estándar son aquellas que vienen con la clase y para su uso se debe tener acceso a los ficheros de medida. No podemos usar las fuentes de forma directa.

El método AddFont describe de forma muy clara aunque a la vez escueta la forma de agregar fuentes.

«Importa una fuente TrueType o Type1 y la hace disponible. Es necesario primero generar un archivo de definición de fuente con la utilidad makefont.php.

El archivo de definición (y el archivo de fuente mismo cuando es incorporado) debe estar presente en el directorio de fuentes. Si no puede ser encontrado, es generado el error <Could not include font definition file>.»

Bueno agregar una fuente de acuerdo al Tutorial 7 no es tan fácil como agregarla con un define(‘ruta’), ya que se requiere un fichero de medidas y un archivo de definición de fuente. Si hay otra forma más sencilla adelante expreselo en los comentarios 😀

Añadir una nueva fuente requiere tres pasos para las TrueType (las comunes):
* Generación del fichero de medidas (.afm)
* Generación del fichero de definición de la fuente (.php)
* Declaración de la fuente en el script

En el tutorial esta muy bien explicado y el archivo de la clase viene acompañado con un ejemplo, de todas formas hice la prueba con una fuente y no tuve mayor problema.

Para el ejemplo NO manejo la misma cantidad de pasos pero el resultado es el mismo, además utilizo la siguiente <Ruta: C:\servidor_web\fpdf> y tengo la siguiente estructura de directorios:

servidor_web <localhost>
|_genera_fuente.php
|__ FPDF
|____ afm
|____ doc
|____ font
|____ makefont
|_______ makefont.php
|____ pfm
|____ tutorial

El directorio AFM (Adobe Font Metrics) contiene el programa tff2pt1 del proyecto «True Type Font to Postscript Type 1 Converter«. Puede descargarse desde la página del proyecto o desde la liga de FPDF, antes de descargar cualquier cosa sigan leyendo hasta terminar el paso uno.

El directorio PFM (Printer Font Metrics) contiene el programa pfm2afm una utilidad para convertir ficheros de medidas. Se puede descargar desde la liga de FPDF, por cierto no encontré referencia hacia alguna página oficial de la utileria y la fecha que muestra el archivo es de 1991 😦

El directorio Makefont tiene el archivo makefont.php que genera el archivo de definición de fuente y que podemos utilizar a través de un archivo php.

IDENTIFICACIÓN DEL TIPO.
El paso 1 es identificar el tipo de fuente a utilizar (TrueType o Type1), ya que si se tratase del segundo caso (Type1) ya nos ahorramos algo de trabajo y pasaremos al paso 3, sino es así continuar en el paso 2-b.

Nota: Además de la fuente Type1 se necesita un archivo AFM, si en lugar de este último se tiene un archivo PFM continuar en el paso 2-a.

GENERACIÓN DEL FICHERO DE MEDIDAS.
El paso 2 consiste en generar un archivo AFM (el fichero de medidas).

2-a. Si su archivo de medidas esta en formato PFM se debe convertir con la ayuda de la utilidad PFM2AFM, el enlace en párrafos anteriores.

En una ventana de DOS (si esa pantallita en negro sin soporte para ratón y sin iconos xDD) escribir:
pfm2afm infile [outfile] -a = pfm2afm evanescence.pfm evanescence.afm -a

infile corrresponde al nombre del archivo PFM
outfile corresponde al nombre del archivo AFM que será generado.
El parámetro -a se los quedo a deber 😛
Como resultado tendremos el archivo de medidas en formato AFM.

2-b. Se debe generar un archivo AFM con la utilidad ttf2pt1, el enlace en párrafos anteriores.

En una venta de DOS escribir:
ttf2pt1 -a infile.ext [outfile] = ttf2pt1 -a impact.ttf impact

infile corresponde al nombre del archivo con su extensión TTF (Fuente TrueType)
outfile el nombre que tendrá el archivo de medidas, no es necesario indicar la extensión.
El parámetro -a se los quedo a deber 😛

Como resultado obtendremos una lista extensa como salida en la pantalla y el mensaje Finished – font files created. Se generan dos archivos el AFM que nos interesa y otro con extensión T1A que podemos borrar con toda confianza.

Nota: Las fuentes se encuentran en las respectivas carpetas para evitar problemas de rutas, los archivos resultantes también se generan en las respectivas carpetas.

El tutorial 7 tiene como ejemplo la fuente Comic Sans y la ruta c:\windows\fonts\comic.ttf, la cual no probe pero los invito a intentarlo 🙂

GENERACIÓN DEL FICHERO DE DEFINICIÓN DE LA FUENTE.
El paso 3 ya que se tiene el archivo de medidas AFM es generar la definición de la fuente con ayuda del archivo makefont.php. Aunque su uso es sencillo tal vez la fuente o el idioma en el que se utilice requiera ciertos ajustes en los parámetros de la función que realiza la definición (Como el uso del símbolo del Euro € o caracteres aún más especiales).

La función MakeFont tiene los siguientes parámetros para su uso.
MakeFont(string fontfile, string afmfile [, string enc [, array patch [, string type]]])

fontfile: Ubicación del fichero .ttf o .pfb.
afmfile: Ubicación del fichero .afm.
enc: Nombre de la codificación. Valor por defecto: cp1252 codificación (Europa Occidental).
patch: Modificación opcionar de la codificación. Vacío por defecto.
type: Tipo de la fuente (TrueType o Type1). Valor por defecto: TrueType.

Como esto es un ejemplo y no me quiero complicar la existencia usaremos lo mínimo de parámetros, para eso genere el archivo «genera_fuente.php» no quedo muy elegante pero todo es cuestión de que ustedes le agreguen una interfaz para seleccionar la ruta y fuente, el fichero AFM y la codificación. NO prometo nada pero si tengo tiempo luego lo mejoro.

<.?php
require(‘fpdf/font/makefont/makefont.php’);
MakeFont(‘c:\\windows\\fonts\\impact.ttf’, ‘fpdf/afm/impact.afm’, ‘cp1252’);

//como la fuente es nativa de windows intente utilizar el directorio y no hubo problemas.

//La ruta con la estructura de carpetas es C:\\servidor_web\\fpdf\\impact.ttf

?.>

Por favor eliminen los puntos antes y después de los signos de interrogación, lo puse porque wordpress me edita los códigos 😛

La salida del archivo es la siguiente:
Font file compressed (impact.z)

Font definition file generated (impact.php)

Recuerden solo se genera el archivo Z si tienen activa la librería de compresión ZLIB. El activarla queda fuera de esta explicación, esa es otra historia XD

Los archivos generados deben buscarlos en la misma carpeta donde tienen el archivo genera_fuente.php o en su caso el archivo que hace la llamada a la función MakeFont.

Bueno ya tenemos 2 archivos (impact.z, impact.php), lo menos que pueden obtener es 1 archivo (impact.php).

Ahora hay que copiar los ficheros generados (menos el AFM) en el directorio de fuentes (de la clase NO de windows). Si el fichero de la fuente no pudo ser comprimido (impact.z), copie el .ttf o .pbf en lugar del .z.

Como en mi caso se genero el archivo comprimido (Z) solo copie los archivos impact.z y el archivo impact.php. Si no me hubiera generado el comprimido habría tenido que copiar los archivos impact.ttf y el archivo impact.php.

Nota: Si por alguna razón pierden el archivo Z y no tienen, no saben o no quieren instalar la librería ZLIB editen el archivo PHP y cambien la línea $file=’impact.z’; en lugar de hacer referencia al archivo Z debe hacer referencia al archivo TTF.

En el archivo PDF solo hay que establecer las fuentes a utilizar e indicar en que momento.
El método AddFont puede llevar por lo menos un parámetro (El nombre de la fuente) para trabajar.

El nombre de la fuente la puede obtener al ver las propiedades de la misma (en windows Abrir), si el nombre no es correcto la fuente no se cargará y el pdf generará un error. Como referencia revisen la fuente que incluye la clase calligra.ttf (nombre: Calligrapher).
…
$pdf->AddFont(‘Calligrapher’,»,’calligra.php’); //Fuente de ejemplo que incluye la Clase.
$pdf->AddFont(‘Impact’,»,’impact.php’); //Fuente de windows convertida con el proceso.
…
…
$pdf->SetFont(‘Impact’,»,15);
$pdf->Cell(0,4,’Soy Una Fuente muy Impactante’,0,1,’C’);

$pdf->Ln(10);
$pdf->SetFont(‘Calligrapher’,»,25);
$pdf->Cell(0,4,’Mi caligrafía puede mejorar’,0,1,’C’);

Anexo el mismo documento PDF del ejemplo el cual usa dos fuentes incorporadas Calligrapher <fuente demo del zip> y la fuente Impact nativa de Windows.

Click en la imagen para ver más grande.

Archivo de Ejemplo click para bajar.

Si alguien desea los archivos de la fuente Impact o los cambios al archivo de ejemplo por favor deje un mensaje.

Saludos.