font. Загрузка файла шрифта для нанесения надписей на изображение

font. Загрузка файла шрифта для нанесения надписей на изображение

^картинка.font[набор_букв;имя_файла_шрифта.gif](ширина_пробела)
^картинка.font[набор_букв;имя_файла_шрифта.gif](ширина_пробела;ширина_символа)
^картинка.font[набор_букв;имя_файла_шрифта.gif][хеш с параметрами] [3.4.0]

Помимо методов для рисования, Parser также предусматривает возможность нанесения надписей на рисунки. Для реализации этой возможности требуется наличие специальных файлов с изображением шрифтов. Можно либо использовать готовые файлы шрифтов, либо самостоятельно создавать собственные с нужным набором символов.

После загрузки такого файла с помощью метода font набору букв, заданных в параметрах метода, ставятся в соответствие фрагменты изображения из файла. Данный файл должен иметь формат GIF с прозрачным фоном и содержать изображение необходимого набора символов в приведенном ниже виде.

Пример файла digits.gif с изображением цифр:
0
1
2
3
4
5
6
7
8
9

Высота каждого символа определяется как отношение высоты рисунка к количеству букв в наборе. Методу передаются следующие параметры:

·	Набор букв - перечень символов, входящих в файл шрифта;

·	Имя и путь к файлу шрифта;

·	Ширина пробела в пикселях;

·	Ширина символа - необязательный параметр.

Некоторые параметры могут быть переданы в третьем параметре в виде хеша:
$.space(0)    - ширина пробела (по умолчанию равна ширине GIF со шрифтом);
$.width(x)    - ширина символа для моноширинного шрифта (по умолчанию шрифт пропорциональный);
$.width(0)    - включить моноширинный шрифт с автоматическим определением ширины символов (будет равна ширине GIF со шрифтом);
$.spacing(0) - межсимвольное расстояние (по умолчанию = 1).

По умолчанию при загрузке файла шрифта автоматически измеряется ширина всех его символов и при выводе текста используется пропорциональный (proportional) шрифт. Если задать ширину символа, то шрифт будет моноширинным.

Все символы следует располагать непосредственно у левого края изображения.

Пример
$square[^image::create(100;100;0x00FF00)]
^square.font[0123456789;digits.gif](0)

В данном случае будет загружен файл, содержащий изображения цифр от 0 до 9, и набору цифр от 0 до 9 будет поставлено в соответствие их графическое изображение. После того как будет определен шрифт для нанесения надписи, можно использовать метод text для нанесения надписей.

Дата обновления: 10.09.2024