matplotlib.ft2font

classmatplotlib.ft2font.FT2Font(filename, hinting_factor=8, *, _fallback_list=None, _kerning_factor=0)

Bases: object

Создать новый объект FT2Font.

Параметры:

filenamestr или file-like

Источник данных шрифта в формате (ttf или ttc), который может читать FreeType

hinting_factorint, необязательно

Должно быть положительным. Используется для масштабирования подсказки в направлении x

_fallback_listсписок FT2Font, необязательно

Список объектов FT2Font, используемых для поиска отсутствующих глифов.

Предупреждение

Этот API является закрытым и предварительным: не используйте его напрямую

_kerning_factorint, необязательно

Используется для корректировки степени кернинга.

Предупреждение

Этот API закрыт: не используйте его напрямую

Атрибуты:

num_facesint

Количество лиц в файле.

face_flags, style_flagsint

Флаги лица и стиля; см. константы ft2font.

num_glyphsint

Количество глифов в лице.

family_name, style_namestr

Имя семейства и стиля шрифта.

num_fixed_sizesint

Количество битовых карт в лице.

scalablebool

Является ли лицо масштабируемым; атрибуты после этого определены только для масштабируемых лиц.

bboxкортеж[int, int, int, int]

Глобальный прямоугольник обрезки лица (xmin, ymin, xmax, ymax).

units_per_EMint

Количество единиц шрифта, покрываемых EM.

ascender, descenderint

Ascender и descender в 26.6 единицах.

heightint

Высота в 26.6 единицах; используется для вычисления стандартной межстрочной интервалов (расстояние от базовой линии до базовой линии).

max_advance_width, max_advance_heightint

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

underline_position, underline_thicknessint

Вертикальное положение и толщина черты подчеркивания.

postscript_namestr

Имя шрифта PostScript.

ascender

bbox

clear(self)

Очистить все глифы, сбросить для нового вызова set_text.

descender

draw_glyph_to_bitmap(self, image, x, y, glyph, antialiased=True)

Отобразить один глиф в битовую карту в пиксельных координатах x, y. Необходимо самостоятельно подготовить битовую карту с помощью set_bitmap_size(w, h) перед вызовом.

Если требуется автоматическое расположение, используйте set_text в сочетании с draw_glyphs_to_bitmap. Данная функция предназначена для рендеринга отдельных глифов (например, возвращаемых load_char) в точных местах.

draw_glyphs_to_bitmap(self, antialiased=True)

Отобразить глифы, загруженные с помощью set_text, в битовую карту. Размер битовой карты будет автоматически настроен для включения глифов.

face_flags

family_name

fname

get_bitmap_offset(self)

Получить (x, y) смещение в 26.6 субпикселей для битовой карты, если чернила висят слева или ниже (0, 0). Поскольку Matplotlib поддерживает только текст слева направо, y всегда равно 0.

get_char_index(self, codepoint)

Возвращает индекс глифа, соответствующий символу codepoint.

get_charmap(self)

Возвращает словарь, который сопоставляет коды символов выбранной таблицы символов (по умолчанию Unicode) с соответствующими индексами глифов.

get_descent(self)

Получить нисхождение в 26.6 субпикселях текущей строки, установленной с помощью set_text. Учитывается поворот строки. Для получения нисхождения в пикселях разделите это значение на 64.

get_glyph_name(self, index)

Получить ASCII имя заданного глифа index в лице.

Из-за внутренней структуры Matplotlib для шрифтов, не содержащих имен глифов (по FT_FACE_FLAG_GLYPH_NAMES), возвращает искусственное имя, которое не является обратимым для get_name_index.

get_image(self)

Возвращает буфер изображения для данного объекта шрифта.

get_kerning(self, left, right, mode)

Получить кернинг между глифами с индексами left и right. mode — константа режима кернинга:

• KERNING_DEFAULT - Возвращает отмасштабированные и сетчатые расстояния кернинга
• KERNING_UNFITTED - Возвращает отмасштабированные, но не сетчатые расстояния кернинга
• KERNING_UNSCALED - Возвращает вектор кернинга в исходных единицах шрифта

get_name_index(self, name)

Возвращает индекс глифа заданного глифа name. Индекс глифа 0 означает 'неопределенный код символа'.

get_num_glyphs(self)

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

get_path(self)

Получить данные пути из загрученного глифа в виде кортежа вершин и кодов.

get_ps_font_info(self)

Возвращает информацию из структуры PS Font Info.

get_sfnt(self)

Загрузить всю таблицу имён SFNT в виде словаря, ключи которого являются кортежами (платформа-ID, схема кодирования ISO, код языка и описание).

get_sfnt_table(self, name)

Возвращает одну из следующих таблиц SFNT: head, maxp, OS/2, hhea, vhea, post или pclt.

get_width_height(self)

Получить ширину и высоту в 26.6 субпикселях текущей строки, заданной методом set_text. Учитывается поворот строки. Для получения ширины и высоты в пикселях разделите эти значения на 64.

get_xys(self, antialiased=True)

Получить координаты x и y текущих глифов.

Устарело начиная с версии 3.8.

height

load_char(self, charcode, flags=32)

Загрузить символ с charcode из текущего шрифтового файла и установить глиф. flags может быть битовой комбинацией констант LOAD_XXX; значение по умолчанию — LOAD_FORCE_AUTOHINT. Возвращает объект Glyph со следующими атрибутами:

• width: ширина глифа
• height: высота глифа
• bbox: рамка глифа (xmin, ymin, xmax, ymax)
• horiBearingX: отступ слева в горизонтальном расположении
• horiBearingY: отступ сверху в горизонтальном расположении
• horiAdvance: ширина продвижения для горизонтального расположения
• vertBearingX: отступ слева в вертикальном расположении
• vertBearingY: отступ сверху в вертикальном расположении
• vertAdvance: высота продвижения для вертикального расположения

load_glyph(self, glyphindex, flags=32)

Загрузить символ с glyphindex из текущего шрифтового файла и установить глиф. flags может быть битовой комбинацией констант LOAD_XXX; значение по умолчанию — LOAD_FORCE_AUTOHINT. Возвращает объект Glyph со следующими атрибутами:

• width: ширина глифа
• height: высота глифа
• bbox: рамка глифа (xmin, ymin, xmax, ymax)
• horiBearingX: отступ слева в горизонтальном расположении
• horiBearingY: отступ сверху в горизонтальном расположении
• horiAdvance: ширина продвижения для горизонтального расположения
• vertBearingX: отступ слева в вертикальном расположении
• vertBearingY: отступ сверху в вертикальном расположении
• vertAdvance: высота продвижения для вертикального расположения

max_advance_height

max_advance_width

num_charmaps

num_faces

num_fixed_sizes

num_glyphs

postscript_name

scalable

select_charmap(self, i)

Выбрать таблицу символов по её номеру FT_Encoding.

set_charmap(self, i)

Установить i-ю таблицу символов как текущую.

set_size(self, ptsize, dpi)

Установить размер шрифта в пунктах и dpi.

set_text(self, string, angle=0.0, flags=32)

Установить текст string и angle. flags может быть битовой комбинацией констант LOAD_XXX; значение по умолчанию — LOAD_FORCE_AUTOHINT. Необходимо вызвать этот метод перед draw_glyphs_to_bitmap. Возвращает последовательность координат x,y.

style_flags

style_name

underline_position

underline_thickness

units_per_EM

classmatplotlib.ft2font.FT2Image

Bases: object

draw_rect(self, x0, y0, x1, y1)

Нарисовать пустую прямоугольную область на изображении.

Устарело начиная с версии 3.8.

draw_rect_filled(self, x0, y0, x1, y1)

Нарисовать заполненную прямоугольную область на изображении.