matplotlib.ft2font

классmatplotlib.ft2font.FT2Font(filename, hinting_factor=8, *, _fallback_list=None, _kerning_factor=0)

Базы: object

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

Параметры:

filenamestr или файлоподобный объект

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

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

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

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

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

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

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

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

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

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

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

Атрибуты:

num_faces

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

face_flags, style_flagsint

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

num_glyphs

Количество глифов в начертании.

family_name, style_name

Название семейства и стиля шрифта.

num_fixed_sizes

Количество битовых изображений в шрифте.

scalable

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

bbox

Область глобального отображения шрифта (xmin, ymin, xmax, ymax).

units_per_EM

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

ascender, descender

Подъём и спуск в 26.6 единицах.

height

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

max_advance_width, max_advance_height

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

underline_position, underline_thickness

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

postscript_name

Имя шрифта 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 в виде словаря, ключами которого являются кортежи (номер платформы, схема кодирования 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)

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

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, 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)

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

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

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