# Añadiendo nuevas fuentes y codificaciones

Este tutorial explica cómo usar fuentes TrueType, OpenType y Type1 de forma que usted no se vea limitado a las fuentes incorporadas en FPDF. El otro punto de interés es que pueda elegir la codificación de la fuente, lo que le permitirá usar otros idiomas aparte de los europeos occidentales (ya que las fuentes estándar tienen muy pocos caracteres disponibles).
Nota: para OpenType, sólo es compatible el formato basado en TrueType (no así el basado en el Type1).
Existen dos formas de usar una nueva fuente: incluirla en el PDF o no. Cuando una fuente no se incluye, se busca en el sistema. La ventaja es que el fichero PDF es más pequeño; sin embargo, si la fuente no está disponible en el sistema, se usa otra como sustituta. Así que es aconsejable asegurarse de que la fuente en cuestión está instalada en los sistemas de los clientes. Si el fichero está destinado a una audiencia numerosas, es mejor incluir la fuente.
Añadir una nueva fuente requiere dos pasos:

- Generación del fichero de definición de la fuente
- Declaración de la fuente en el script

Para Type1, es necesario el archivo AFM correspondiente. Por lo general, éste es proveído con la fuente.

## Generación del fichero de definición de la fuente

El primer paso consiste en generar un fichero PHP que contenga toda la información que necesita FPDF; además, el fichero de la fuente deberá comprimirse. Para hacer esto, se distribuye un script auxiliar en el directorio makefont del paquete: makefont.php. Contiene la siguiente función:
`MakeFont(string fontfile, [, string enc [, boolean embed]])`

`fontfile`

  Ubicación del fichero .ttf, .otf o .pfb.

`enc`

  Nombre de la codificación. Valor por defecto: `cp1252`.

`embed`

  Si se incorpora o no la fuente. Valor por defecto: `true`.

El primer parámetro es el nombre del fichero de la fuente. La extensión debe ser .ttf, .otf o .pfb y determina el tipo de fuente. Si tiene una fuente Type1 en formato ASCII (.pfa), puede convertirla a formato binario (.pfb) con t1utils.
Para las fuentes Type1, el archivo .afm correspondiente debe estar presente en el mismo directorio.
La codificación define la asociación entre un código (de 0 a 255) y un carácter. Los primeros 123 son fijos y se corresponden con los caracteres ASCII; los siguientes son variables. Las codificaciones se almacenan en ficheros .map. Están disponibles:

- cp1250 (Europa Central)
- cp1251 (cirílico)
- cp1252 (Europa Occidental)
- cp1253 (griego)
- cp1254 (turco)
- cp1255 (hebreo)
- cp1257 (báltico)
- cp1258 (vietnamita)
- cp874 (tailandés)
- ISO-8859-1 (Europa Occidental)
- ISO-8859-2 (Europa Central)
- ISO-8859-4 (báltico)
- ISO-8859-5 (cirílico)
- ISO-8859-7 (griego)
- ISO-8859-9 (turco)
- ISO-8859-11 (tailandés)
- ISO-8859-15 (Europa Occidental)
- ISO-8859-16 (Europa Central)
- KOI8-R (ruso)
- KOI8-U (ucraniano)

Por supuesto, la fuente debe contener los caracteres adecuados a la codificación escogida.
Nota: las fuentes estándar usan cp1252.
Después de llamar a la función (puede crear un nuevo fichero e incluir makefont.php), se creará un fichero .php con el mismo nombre que la fuente. Puede renombrarlo si lo desea. En caso de incluir la fuente, el fichero se comprime y da lugar a un segundo fichero con extensión .z (excepto si la función de compresión no está disponible, puesto que requiere la biblioteca Zlib para PHP). También puede renombrarlo, pero, en este caso, tendrá que modificar la variable `$file` en el fichero .php consecuentemente.
Ejemplo:

    <?php
    require('makefont/makefont.php');

    MakeFont('c:\\Windows\\Fonts\\comic.ttf','cp1252');
    ?>

que devuelve los ficheros comic.php y comic.z.
Entonces tendrá que copiar los ficheros generados en el directorio de fuentes. Si el fichero de la fuente no pudo ser comprimido, copie la fuente en lugar del .z.
Otra forma de invocar a MakeFont() es a través de la línea de comandos:
`php makefont\makefont.php c:\Windows\Fonts\comic.ttf cp1252`
Por último, para las fuentes TrueType y OpenType, también puede generar los archivos en línea en lugar de hacerlo manualmente.

## Declaración de la fuente en el script

El segundo paso es el más simple. Sólo necesita llamar al método AddFont():

    $pdf->AddFont('Comic','','comic.php');

Y la fuente queda disponible (en los estilos normal y subrayado), lista para usar como las otras. Si hubiéramos trabajado con la Comic Sans MS Bold (comicbd.ttf), hubiésemos escrito:

    $pdf->AddFont('Comic','B','comicbd.php');

## Ejemplo

Veamos ahora un ejemplo completo. Vamos a utilizar la fuente Calligrapher. El primer paso es la generación de los archivos de la fuente:

    <?php
    require('makefont/makefont.php');

    MakeFont('calligra.ttf','cp1252');
    ?>

El script nos devolverá el siguiente informe:
Warning: character Euro is missing
Warning: character zcaron is missing
Font file compressed: calligra.z
Font definition file generated: calligra.php
El carácter del euro no está en la fuente (es muy antigua). Otro carácter tampoco se encuentra en la fuente.
Alternativamente, podríamos haber utilizado la línea de comandos:
`php makefont\makefont.php calligra.ttf cp1252`
o haber usado el generado en línea.
Podemos copiar estos dos ficheros en el directorio de fuentes (font) y escribir el script:

    <?php
    require('fpdf.php');

    $pdf = new FPDF();
    $pdf->AddFont('Calligrapher','','calligra.php');
    $pdf->AddPage();
    $pdf->SetFont('Calligrapher','',35);
    $pdf->Write(10,'Enjoy new fonts with FPDF!');
    $pdf->Output();
    ?>

[Demo]

## Acerca del símbolo del euro

El carácter del euro no aparece en todas las codificaciones, y no siempre está en la misma posición:

Codificación | Posición
--- | ---
cp1250 | 128
cp1251 | 136
cp1252 | 128
cp1253 | 128
cp1254 | 128
cp1255 | 128
cp1257 | 128
cp1258 | 128
cp874 | 128
ISO-8859-1 | ausente
ISO-8859-2 | ausente
ISO-8859-4 | ausente
ISO-8859-5 | ausente
ISO-8859-7 | ausente
ISO-8859-9 | ausente
ISO-8859-11 | ausente
ISO-8859-15 | 164
ISO-8859-16 | 164
KOI8-R | ausente
KOI8-U | ausente

La codificación ISO-8859-1 está muy extendida, pero no incluye el símbolo del euro. Si lo necesita, la solución más simple consiste en usar cp1252 o ISO-8859-15, que son prácticamente iguales pero contienen el preciado símbolo.

## Reduciendo el tamaño de las fuentes TrueType

Los ficheros de fuentes son con frecuencia bastante voluminosos ; esto se debe a que contienen los caracteres correspondientes a muchas codificaciones. La compresión Zlib los reduce, pero continúan siendo bastante grandes. Existe una técnica para reducirlos aún más. Consiste en convertir la fuente a formato Type1 con ttf2pt1 (el ejecutable para Windows está disponible aquí) especificando la codificación que le interesa; todos los demás caracteres serán omitidos.
Por ejemplo, la fuente arial.ttf que viene con Windows Vista tiene un tamaño de 748 KB (contiene 3381 caracteres). Después de comprimirla, pesa 411 KB. Convirtámosla a Type1 manteniendo sólo los caracteres cp1250:
`ttf2pt1 -b -L cp1250.map c:\Windows\Fonts\arial.ttf arial`
Los ficheros .map están en el directorio makefont del paquete. El proceso devuelve arial.pfn y arial.afm. El fichero arial.pfb ocupa sólo 57 KB, 53 KB después de comprimirlo.
Es incluso posible ir más allá. Si sólo está usted interesado en un subconjunto de la codificación (es probable que no necesite los 217 caracteres), puede abrir el fichero .map y quitar las líneas que no le interesen. Consecuentemente, el tamaño del fichero disminuirá.