ps_findfont

(PECL ps >= 1.1.0)

ps_findfontCarrega uma fonte

Descrição

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

Carrega uma fonte para uso posterior. Antes que o texto seja gerado com uma fonte carregada, ele deve ser definido com ps_setfont(). Esta função precisa do arquivo de métricas de fontes da Adobe para calcular o espaço usado pelos caracteres. Uma fonte carregada dentro de uma página estará disponível apenas naquela página. As fontes que serão usadas no documento completo devem ser carregadas antes da primeira chamada de ps_begin_page(). Chamar ps_findfont() entre páginas tornará essa fonte disponível para todas as páginas seguintes.

O nome do arquivo afm deve ser fontname.afm. Se a fonte for incorporada, o arquivo fontname.pfb contendo o contorno da fonte também deve estar presente.

Chamar ps_findfont() antes da primeira página requer a geração do cabeçalho PostScript que inclui o BoundingBox para todo o documento. Normalmente, o BoundingBox é definido com a primeira chamada de ps_begin_page(), que agora vem depois de ps_findfont(). Consequentemente, o BoundingBox não foi definido e um aviso será emitido quando ps_findfont() for chamado. Para evitar essa situação, deve-se chamar ps_set_parameter() para definir o BoundingBox antes de ps_findfont() ser chamado.

Parâmetros

psdoc

Identificador de recurso do arquivo postscript conforme retornado por ps_new().

fontname

O nome da fonte.

encoding

ps_findfont() tentará carregar o arquivo passado no parâmetro encoding. Os arquivos de codificação têm a mesma sintaxe daqueles usados ​​por dvips(1). Eles contêm um vetor de codificação de fonte (que atualmente não é usado, mas deve estar presente) e uma lista de ligaduras extras para estender a lista de ligaduras derivadas do arquivo afm.

encoding pode ser null ou a string vazia se a codificação padrão (TeXBase1) for usada.

Se a codificação for definida como builtin, não haverá recodificação e a codificação específica da fonte será usada. Isso é muito útil com fontes de símbolos.

embed

Se definido para um valor maior que zero, a fonte será incorporada ao documento. Isso requer a presença do contorno da fonte (arquivo .pfb).

Valor Retornado

Retorna o identificador da fonte ou zero em caso de erro. O identificador é um número positivo.

Veja Também