# ps_findfont

(PECL ps >= 1.1.0)

ps_findfont — Cargar una fuente

### Descripción

ps_findfont(
resource `$psdoc`,
string `$fontname`,
string `$encoding`,
bool `$embed` = false
): int

Carga una fuente para su uso posterior. Antes de que un texto se imprima con una fuente cargada, ésta debe establecerse con a la función ps_setfont(). Esta función necesita el fichero de métrica de fuentes de Adobe para poder calcular el espacio utilizado por los caracteres. Una fuente que sea cargada dentro de una página solamente estára disponible en esta página. Las fuentes que van a ser usadas en el documento completo tienen que ser cargadas antes de llamar por primera vez a la función ps_begin_page(). Llamar a la función ps_findfont() entre páginas hará que esa fuente esté disponible para todas las páginas siguientes.

El nombre del fichero afm debe ser `nombre_de_fuente``.afm`. Si la fuente estará embebida, el fichero `nombre_de_fuente``.pfb` que contiene el esquema de la fuente también debe estar presente.

Llamar a la función ps_findfont() antes de la primera página requiere imprimir la cabecera postscript que incluya el campo BoundingBox para el documento entero. Normalmente BoundingBox se establece con la primera llamada a la fucnión ps_begin_page(), que ahora va después de la función ps_findfont(). Por lo tanto, BoundingBox no se ha establecido y se emitirá una advertencia al llamar a la función ps_findfont(). Para prevenir esta situación, se debería llamar a la función ps_set_parameter() para establecer BoundingBox antes de llamar a la función ps_findfont().

### Parámetros

`psdoc`

  El identificador de recursos del fichero postscript, como el devuelto por la función ps_new().

`fontname`

  El nombre de la fuente.

`encoding`

  ps_findfont() intentará cargar el fichero pasado al parámetro `encoding`. Los archivos codificados tienen la misma sintaxis que los utilizados por dvips(1). Contienen un vector de codificación de fuente (que actualmente no se usa pero debe estar presente) y una lista de ligaduras extra para prolongar la lista de ligaduras derivada del fichero afm.

  `encoding` puede ser `null` o la cadena vacía si se usará la codificación predeterminada (TeXBase1).

  Si la codificación se establece a `builtin` no habrá recodificación y se usará la codificación específica de la fuente. Esto es muy útil con fuentes de símbolos.

`embed`

  Si se establece a un valor >0 la fuente será embebida en el documento. Esto requiere que el esquema de la fuente (fichero .pfb) esté presente.

### Valores devueltos

Devuelve el identificador de la fuente, o cero en caso de error. El identificador es un número positivo.

### Ver también

- ps_begin_page() - Empezar una nueva página
- ps_setfont() - Establecer la fuente a usar para la siguiente impresión