(PECL ps >= 1.1.0)
ps_findfont — Cargar una fuente
$psdoc
, string $fontname
, string $encoding
[, bool $embed = false
] ) : intCarga 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().
psdocEl identificador de recursos del fichero postscript, como el devuelto por la función ps_new().
fontnameEl 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.
embedSi 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.
Devuelve el identificador de la fuente, o cero en caso de error. El identificador es un número positivo.