« ps\_shfillps\_show\_xy2 »PHP ManualФункції PS

ps_show_boxed

(PECL ps >= 1.1.0)

ps_show_boxed — Виводить текст у поле

Опис

ps_show_boxed(    resource $psdoc,    string $text,    float $left,    float $bottom,    float $width,    float $height,    string $hmode,    string $feature = ?): int

Виводить текст у заданому полі. Нижній лівий кут поля знаходиться в (left bottom). За потреби будуть вставлені розриви рядків. Декілька прогалин розглядаються як один. Табулятори розглядаються як прогалини.

Текст будет переноситься через дефис, если для параметраhyphenationустановлено значение**true**, а параметрhyphendict містить допустиме ім'я файлу для розміщення переносів. Міжрядковий інтервал береться зі значення leading. Абзаци можна розділяти порожнім рядком, як у TeX. Якщо для параметра parindent встановлено значення > 0.0, то перші n рядків будуть із відступом. Кількість рядків n задається параметром numindentlines. Щоб запобігти відступу перших m абзаців, встановіть позитивне число значенням параметра parindentkip

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

psdoc

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

text

Текст, який потрібно вивести у поле.

left

Координата X лівого нижнього кута поля.

bottom

Координата Y лівого нижнього кута поля.

width

Ширина поля.

height

Висота поля.

hmode

Параметрhmode може бути fulljustify right leftилиcenterРазница междуjustifyиfulljustifyвлияет только на последнюю строку поля. В режимеfulljustify останній рядок буде вирівняний по лівому та правому краю, якщо це не останній рядок абзацу. В режимі justify вона завжди буде вирівняна по лівому краю.

feature

Використовувані параметри

Висновок ps_show_boxed() може бути налаштований з кількома параметрами та значеннями, які повинні бути встановлені за допомогою ps_set_parameter() або ps_set_value(). Крім параметрів та значень, що впливають на виведення тексту, оцінюються такі параметри та значення:

leading (значення)

Відстань між базовими лініями двох послідовних ліній.

linebreak (параметр)

Установите значение**true**якщо хочете, щоб повернення каретки починало новий рядок, а не розглядало його як пробіл. За замовчуванням false

parbreak (параметр)

Установите значение**true**якщо хочете, щоб повернення каретки в окремому рядку починав новий абзац, а не розглядав його як пробіл. За замовчуванням true

hyphenation (параметр)

Установите значение**true, щоб увімкнути розміщення переносів. Для цього потрібно, щоб словник було встановлено з параметром hyphendictПо умолчаниюfalse**

hyphendict (параметр)

Ім'я файлу словника, який використовується для розміщення переносів (див. нижче).

hyphenminchar (значення)

Кількість символів, що має бути принаймні залишено до або після дефісу. Це означає, що через дефіс буде перенесено лише слова, які щонайменше вдвічі перевищують це значення. Значення за замовчуванням – три. Налаштування нульового значення встановить значення за промовчанням.

parindent (значення)

Встановіть кількість місця у пікселях для відступу перших m рядків абзацу. m можна встановити за допомогою значення numindentlines

parskip (значення)

Установите количество дополнительного пространства в пикселях между абзацами. По умолчанию що призведе до нормальної відстані між лініями.

numindentlines (значення)

Кількість рядків від початку абзацу, які будуть із відступом. За замовчуванням

parindentskip (значення)

Кількість абзаців у полі, перші рядки яких будуть без відступу. За замовчуванням . Це корисно для абзаців відразу після заголовка розділу або тексту, що триває у другому полі. В обох випадках можна встановити значення

linenumbermode (параметр)

Вкажіть спосіб нумерації рядків. Можливі значення: box для нумерації рядків у всьому блоці або paragraph для нумерації рядків у кожному абзаці.

linenumberspace (значення)

Простір для стовпця ліворуч від нумерованого рядка, що містить номер рядка. Номер рядка в цьому стовпці буде вирівняний праворуч. За замовчуванням 20

linenumbersep (значення)

Простір між стовпцем з номерами рядків і рядком. За замовчуванням 5

Перенесення

Текст переноситься, якщо у параметрі hyphenation встановлено значення true та заданий допустимий словник для розміщення переносів. pslib не надає власний словник для розміщення переносів, але використовує словник з openoffice, scribus або koffice. Ви можете знайти їхні словники для різних мов в одній з наступних каталогів, якщо встановлено відповідне програмне забезпечення:

  • /usr/share/apps/koffice/hyphdicts/
  • /usr/lib/scribus/dicts/
  • /usr/lib/openoffice/share/dict/ooo/

В даний час у scribus найбільш повні словники розміщення переносів.

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

Кількість символів, які не вдалося записати.

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