matplotlib.ft2font

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

Основания: object

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

Параметры:

filenamestr или file-like

Источник данных шрифта в формате (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

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)

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

get_glyph_name(self, index)

Возвращает ASCII имя заданного глифа index в начертании.

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

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)

Получение координат 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)

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