# 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).
Para OpenType, sólo es compatible el formato basado en TrueType (no así el basado en el Type1).
Para Type1, es necesario el archivo AFM correspondiente. Por lo general, éste es proveído con 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

## 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 [, boolean subset]]])`

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

`subset`

  Si un subconjunto de la fuente o no. 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.
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.
El último parámetro indica si el subconjunto deber ser usado o no, es decir, si o no, los caracteres del método de codificado deben mantenerse en la fuente embebida. Como consecuencia, si la fuente original fue grande, el tamaño del archivo PDF puede ser altamente reducido.
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]