17.2.5. Работа с текстом и шрифтами

17.2.5.1. Высота матрицы шрифта: ImageFontHeight

17.2.5.2. Ширина матрицы шрифта: ImageFontWidth

17.2.5.3. Загрузка шрифта: ImageLoadFont

Функция ImageLoadFont () предназначена для загрузки пользовательского растрового шрифта и возвращает идентификатор, под которым этот шрифт зарегистрирован в системе. Это значение всегда больше 5 (идентификаторы от 1 до 5 выделены для встроенных в систему шрифтов).

Формат шрифта в общем случае зависит от архитектуры машины. Это означает, что вы должны сгенерировать бинарное описание шрифта на той же машине, где будет работать PHP-машина (см. табл. 17.1).

См. также описание функций ImageFontWidth () (раздел 17.2.5.2) и ImageFontHeightO (раздел 17.2.5.1).

17.2.5.4. Размер текстовой области Postscript: ImagePSBBox

Функция предназначена для определения размера прямоугольной области, необходимой для вывода текста text заданным Postscript-шрифтом font с указанными параметрами.

Следует сразу отметить, что size задается в пикселах. Аргумент space позволяет задать размер пробела. Это дополнительное значение, показывающее, на какую величину необходимо увеличить или уменьшить (если значение отрицательное) стандартный размер пробела.

Аргумент tightness позволяет вам управлять размером пространства между буквами. Это значение показывает, на какую величину необходимо увеличить или уменьшить (если значение отрицательное) межбуквенный интервал. Аргумент angle задает угол наклона шрифта и вводится в градусах. Аргументы space и tightness представляются в условных единицах, которые равны не одному доллару, как вы могли бы подумать, а 1/1000 ширины буквы «т» текущего шрифта.

17.2.5.5. Перестройка вектора кодировки: ImagePSEncodeFont

Функция загружает из файла encodi ngf i le вектор кодировки символов и приводит в соответствие с ним кодировку шрифта, зарегистрированного под номером font_index. Необходимость этой операции, как вы понимаете, связана с желанием использовать кириллические Postscript-шрифты. Понятно, что для этого вы должны прежде всего иметь шрифты с кириллицей, а также установить библиотеку T1lib.

Вполне возможно, что вам понравится работать с Postscript-шрифтами, хотя, на мой взгляд, для генерируемой графики это слишком. В этом случае вы можете включить созданную вами кодировку в конфигурационный файл и использовать ее по умолчанию.

17.2.5.6. Выгрузка Postscript-шрифта: ImagePSFreeFont

Функция предназначена для освобождения памяти, занятой шрифтом Postscript, который был загружен в PHP-машину с помощью функции ImagePSLoadFont () (см. раздел 17.2.5.7).

17.2.5.7. Загрузка шрифта Postscript: ImagePSLoadFont

Функция осуществляет загрузку и регистрацию в PHP-машине шрифта Postscript, содержащегося в заданном файле. В случае успешной загрузки возвращается идентификатор шрифта. В противном случае функция возвращает false и генерирует сообщение об ошибке.

17.2.5.8. Масштабирование шрифта: ImagePsExtendFont

Функция расширяет или, наоборот, сжимает шрифт Postscript, адресуемый указателем font_index. Если значение аргумента extend больше 1, шрифт будет расширен, а если меньше — то сжат.

17.2.5.9. Наклонный шрифт: ImagePsSlantFont

Функция преобразует исходный шрифт Postscript в наклонный. Угол наклона определяется значением параметра slant.

17.2.5.10. Отрисовка текста: ImagePSText

Функция предназначена для отрисовки в изображении image текста text с помощью Postscript-шрифта, зарегистрированного под номером font. Аргумент size определяет высоту используемого шрифта и задается в пикселах.

Аргументы foreground и background определяют цвета текста и фона соответственно. Под фоном в данной функции понимается цвет, на который необходимо ориентироваться во избежание слияния выводимого текста. Вывод пикселов с цветом фона не производится, поэтому нет никакой необходимости в использовании однотонной «подстилающей поверхности» — значение цвета фона носит «справочный» характер.

Координаты (х, у) определяют нижнюю левую позицию первой буквы выводимого текста.

Аргумент space позволяет задать размер пробела, используемого при выводе данной строки. Значение аргумента показывает, на какую величину необходимо увеличить или уменьшить (если значение отрицательное) стандартный размер пробела. Аналогичным образом аргумент tightness позволяет управлять межбуквенным интервалом. Оба эти аргумента задаются в условных единицах, которые равны 0,001 от ширины буквы «т» в данном шрифте.

Угол angles определяет направление вывода шрифта и задается в градусах.

Аргумент antialias_steps позволяет вам задать количество цветов, вовлеченных в построение строки, не сливающейся с фоном. В настоящее время вы можете

В отличие от функции ImageString(), в которой задается правый верхний угол первого символа! указать либо 4, либо 16 цветов. Для шрифтов, размер которых меньше 20, используйте 16 цветов, а для шрифтов большего размера достаточно 4. Кроме того, в этом случае вывод осуществляется заметно быстрее.

17.2.5.11. Вывод строки: ImageString

Функция ImageString( )осуществляет вывод в изображение текстовой строки начиная с координат (х, у). Эти координаты определяют позицию правого верхнего угла первой выводимой буквы строки. Началом координат является левый верхний угол «холста». Аргумент col определяет цвет изображения.

17.2.5.12. Вертикальный вывод строки: ImageStringUp

Функция ImageStri ngUp() отрисовывает строку s в вертикальном направлении начиная с координат (х, у). Эти координаты определяют позицию правого верхнего угла первой выводимой буквы строки. Началом координат является левый верхний угол «холста». Аргумент col определяет цвет изображения.

17.2.5.13. Размер TTF-строки: ImageTTFBBox

Функция вычисляет размер зоны, описывающей текст, выводимый с помощью TTF-шрифтов, и возвращает ее параметры в виде массива, который содержит 8 элементов (табл. 17.2).

Возвращаемые точки не зависят от направления вывода текста, поэтому термин «левый нижний» обозначает координаты точки относительно горизонтального расположения текста.