( Замечание

Для того чтобы заработали приведенные ниже функции, PHP должен быть откомпилирован и установлен вместе с библиотекой FreeType, доступной по адресу http: www.freetype.org. В Windows-версии PHP она установлена по умолчанию.

Всего существует две функции для работы со шрифтами TrueType. Одна из них выводит строку в изображение, а вторая - определяет, какое положение эта строка бы заняла при выводе.

Вывод строки

list imageTTFText(int $im, int $size, int $angle, int $x, int $y, int $col, string $fontfile, string $text)

Параметры шрифта

После того как шрифт загружен, его можно использовать (встроенные шрифты, конечно же, загружать не требуется).

int imageFontHeight(int $font)

Возвращает высоту в пикселах каждого символа в заданном шрифте.

int imageFontWidth(int $font)

Возвращает ширину в пикселах каждого символа в заданном шрифте.

Вывод строки

int imageString(int $im, int $font, int $x, int $y, string $s, int $col)

Выводит строку $s в изображение $im, используя шрифт $font и цвет $col. Координаты ($x,$y) будут координатами левого верхнего угла прямоугольника, в который вписана строка.

int imageStringUp(int $im, int $font, int $x, int $y, string $s, int $c)

Эта функция также выводит строку текста, но не в горизонтальном, а в вертикальном направлении. Верхний левый угол, по-прежнему, задается координатами ($x,$y).

Работа со шрифтами TrueType

Библиотека GD поддерживает также работу со шрифтами PostScript и TrueType. Мы с вами рассмотрим только последние, т. к., во-первых, их существует великое множество (благодаря платформе Windows), а во-вторых, с ними проще всего работать в

PHP.

Хотя в официальной документации об этом ничего не сказано, я рискну взять на себя ответственность и заявить, что параметр $fontfile должен всегда задавать абсолютный путь (от корня файловой системы) к требуемому файлу шрифтов. Что самое интересное, в PHP версии 3 функции все же работают с относительными именами. Но в любом случае лучше подстелить соломку - абсолютные пути еще никому не вредили, не правда ли?..

Функция возвращает список из 8 элементов. Первая их пара задает координаты (x,y) верхнего левого угла прямоугольника, описанного вокруг строки текста в изображении, вторая пара - координаты верхнего правого угла, и т. д. Так как в общем случае строка может иметь любой наклон $angle, здесь требуются 4 пары координат.

Вот пример использования этой функции:

i Листинг 23.2. Вывод TrueType-строки

<?

В1водимая строка

$string="Hello world!";

Создаем рисунок подходящего размера

$im = imageCreate(300,40);

Создаем в палитре новые цвета

$black = imageColorAllocate($im, 0, 0, 0);

$orange = imageColorAllocate($im, 220, 210, 60);

Закрашиваем картинку

imageFill($im,0,0,$black);

Рисуем строку текста (файл times.ttf расположен в текущем каталоге)

imagettftext($im,50,0,20,35,$orange,getcwd()."/times.ttf",$string);

Сообщаем о том, что далее следует рисунок PNG Header("Content-type: image/png"); Выводим рисунок

Эта функция помещает строку $text в изображение $im цветом $col. Как обгчно, $col должен представлять собой допустимый идентификатор цвета. Параметр $angle задает угол наклона в градусах выводимой строки, отсчитываемый от горизонтали против часовой стрелки. Координаты ($x,$y) указывают положение так называемой базовой точки строки (обгчно это ее левый нижний угол). Параметр $size задает размер шрифта, который будет использоваться при выводе строки. Наконец, $fontfile должен содержать имя TTF-файла, в котором, собственно, и хранится шрифт.

Пример

В листинге 23.3 я привожу пример сценария, который использует возможности вывода TrueType-шрифтов, а также демонстрирует работу с цветом RGB. Хотя размер примера довольно велик, рисунок, который он генерирует, выглядит довольно привлекательно (см. рис. 23.1).

i Листинг 23.3. Вывод строки произвольного формата

<?

Аналог imageColorAllocate() (по умолчанию), но работает не с

RGB-тройкой, а с цветом в формате XXYYZZ, где:

* XX - red-составляющая в шестнадцатеричном формате;

* YY - green-составляющая в шестнадцатеричном формате;

* ZZ - blue-составляющая в шестнадцатеричном формате.

imagePng($im); ?>

Определение границ строки

list imageTTFBBox(int $size, int $angle, string $fontfile, string $text)

Эта функция ничего не выводит в изображение, а просто определяет, какой размер и положение заняла бы строка текста $text размера $size, выведенная под углом $angle в какой-нибудь рисунок. Параметр $fontfile, как и в функции imageTTFText() , задает абсолютный путь к файлу шрифта, который будет использован при выводе.

Возвращаемый список содержит всю информацию о размерах строки в формате, похожем на тот, что вхдает функция imageTTFText(). Однако порядок точек в нем отличается (табл. 23.2).

Таблица 23.2. Содержимое списка, возвращаемого функцией