« ps\_fillps\_get\_buffer »PHP ManualФункції PS

ps_findfont

(PECL ps >= 1.1.0)

ps_findfont — Завантажує шрифт

Опис

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

Завантажує шрифт для подальшого використання. Перед виведенням тексту із завантаженим шрифтом він має бути встановлений за допомогою ps_setfont(). Функція потребує файлу метрики шрифту Adobe, щоб обчислити простір, що використовується символами. Шрифт, завантажений на сторінку, буде доступний лише на цій сторінці. Шрифти, які будуть використовуватись у всьому документі, повинні бути завантажені до першого виклику ps_begin_page(). Виклик ps_findfont() між сторінками зробить шрифт доступним для всіх наступних сторінок.

Ім'я afm-файлу має бути fontname``.afm. Якщо шрифт має бути вбудований, також має бути файл fontname``.pfb, що містить контур шрифту.

Виклик ps_findfont() перед першою сторінкою вимагає виводу заголовка PostScript, який містить BoundingBox для всього документа. Зазвичай BoundingBox встановлюється під час першого виклику ps_begin_page(), який тепер йде після ps_findfont(). Отже, BoundingBox не встановлено, і під час виклику ps_findfont() буде видано попередження. Щоб запобігти цій ситуації, слід викликати ps_set_parameter() для встановлення BoundingBox до виклику ps_findfont()

Список параметрів

psdoc

Ідентифікатор ресурсу файлу postscript, повернутий функцією ps_new()

fontname

Назва шрифту.

encoding

Функцияps_findfont() спробує завантажити файл, переданий у параметрі encoding. Файли кодування мають той же синтаксис, що і використовувані dvips(1). Вони містять вектор кодування шрифту (який в даний час не використовується, але має бути присутнім) і список додаткових лігатур для розширення списку лігатур, отриманих з файлу afm.

encoding може бути null або порожнім рядком, якщо потрібно використовувати кодування за промовчанням (TeXBase1).

Если для кодировки установлено значениеbuiltin, то перекодування не буде і використовуватиметься кодування, специфічне для шрифту. Це дуже корисно для символьних шрифтів.

embed

Якщо встановлено значення > 0, шрифт буде вбудований у документ. Для цього потрібно контур шрифту (файл .pfb).

Значення, що повертаються

Повертає ідентифікатор шрифту або нуль у разі помилки. Ідентифікатор – позитивне число.

Дивіться також

  • ps_begin_page() - Починає нову сторінку
  • ps_setfont() - Встановлює шрифт, який використовуватиметься для наступного висновку