matplotlib.afm

Интерфейс Python к файлам метрик шрифтов Adobe.

Несмотря на то, что существует ряд других реализаций на Python, и они могут быть более полными, было решено не использовать их, потому что они были либо:

1. защищены авторским правом или использовали лицензию, несовместимую с BSD
2. имели слишком много зависимостей, и потребовалась независимая библиотека
3. делали больше, чем нужно, и было проще написать всё заново, чем разбираться, как получить только необходимое.

Он довольно прост в использовании и не имеет внешних зависимостей:

>>> import matplotlib as mpl
>>> from pathlib import Path
>>> afm_path = Path(mpl.get_data_path(), 'fonts', 'afm', 'ptmr8a.afm')
>>>
>>> from matplotlib.afm import AFM
>>> with afm_path.open('rb') as fh:
...     afm = AFM(fh)
>>> afm.string_width_height('What the heck?')
(6220.0, 694)
>>> afm.get_fontname()
'Times-Roman'
>>> afm.get_kern_dist('A', 'f')
0
>>> afm.get_kern_dist('A', 'y')
-92.0
>>> afm.get_bbox_char('!')
[130, -9, 238, 676]

Как и в спецификации формата файла метрик шрифтов Adobe, все размеры указаны в единицах 1/1000 масштабного коэффициента (размер шрифта) используемого шрифта.

классmatplotlib.afm.AFM(fh)[source]

Основывается на object

Разбор файла AFM в объекте файла fh.

свойствоfamily_name

Название семейства шрифтов, например, 'Times'.

get_angle()[source]

Возвращает угол шрифта как число с плавающей точкой.

get_bbox_char(c, isord=False)[source]

get_capheight()[source]

Возвращает высоту заглавной буквы как число с плавающей точкой.

get_familyname()[source]

Возвращает название семейства шрифтов, например, 'Times'.

get_fontname()[source]

Возвращает имя шрифта, например, 'Times-Roman'.

get_fullname()[source]

Возвращает полное имя шрифта, например, 'Times-Roman'.

get_height_char(c, isord=False)[source]

Получить высоту рамки (чернил) символа c (пробел — 0).

get_horizontal_stem_width()[source]

Возвращает стандартную ширину горизонтального штриха как число с плавающей точкой или None, если она не указана в файле AFM.

get_kern_dist(c1, c2)[source]

Возвращает расстояние межбуквенного кернинга (возможно, 0) для символов c1 и c2.

get_kern_dist_from_name(name1, name2)[source]

Возвращает расстояние межбуквенного кернинга (возможно, 0) для символов name1 и name2.

get_name_char(c, isord=False)[source]

Получить имя символа, например, ';' это 'semicolon'.

get_str_bbox(s)[source]

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

get_str_bbox_and_descent(s)[source]

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

get_underline_thickness()[source]

Возвращает толщину подчеркивания как число с плавающей точкой.

get_vertical_stem_width()[source]

Возвращает стандартную ширину вертикального штриха как число с плавающей точкой или None, если она не указана в файле AFM.

get_weight()[source]

Возвращает начертание шрифта, например, 'Bold' или 'Roman'.

get_width_char(c, isord=False)[source]

Получить ширину символа из поля метрики символа WX.

get_width_from_char_name(name)[source]

Получить ширину символа из имени символа type1.

get_xheight()[source]

Возвращает xheight как число с плавающей точкой.

свойствоpostscript_name

string_width_height(s)[source]

Возвращает ширину строки (включая кернинг) и высоту строки в виде кортежа (w, h).

classmatplotlib.afm.CharMetrics(width, name, bbox)[source]

Bases: tuple

Представляет метрики символа.

Примечания

Поля в настоящее время описывают только подмножество информации о метриках символов, определенных в стандарте AFM.

Создает новый экземпляр CharMetrics(ширина, имя, рамка)

bbox

Рамка символа (B) в виде кортежа (llx, lly, urx, ury).

name

Имя символа (N).

width

Ширина символа (WX).

classmatplotlib.afm.CompositePart(name, dx, dy)[source]

Bases: tuple

Представляет информацию о составном элементе составного символа.

Создает новый экземпляр CompositePart(имя, dx, dy)

dx

Смещение по оси x части от начала координат.

dy

Смещение по оси y части от начала координат.

name

Имя части, например, 'acute'.