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_facesint

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

face_flags, style_flagsint

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

num_glyphsint

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

family_name, style_namestr

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

num_fixed_sizesint

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

scalablebool

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

bboxtuple[int, int, int, int]

Глобальная область обрезки начертания (xmin, ymin, xmax, ymax).

units_per_EMint

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

ascender, descenderint

Подъем и спуск в единицах 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)

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