Carrega uma fonte

# ps_findfont

(PECL ps >= 1.1.0)

ps_findfont — Carrega uma fonte

### Descrição

function 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

- ps_begin_page() - Inicia uma nova página
- ps_setfont() - Define a fonte a ser usada na saída seguinte

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open