matplotlib.textpath

классmatplotlib.textpath.TextPath(xy, s, size=None, prop=None, _interpolation_steps=1, usetex=False)[source]

Базы: Path

Создаёт путь из текста.

Создаёт путь из текста. Обратите внимание, что это просто путь, а не элемент. Для отрисовки этого пути на холсте необходимо использовать PathPatch (или другие элементы).

Параметры:

xyкортеж или массив из двух числовых значений с плавающей точкой

Позиция текста. Для отсутствия смещения используйте xy=(0, 0).

sстрока

Текст, который нужно преобразовать в путь.

sizeчисло с плавающей точкой, необязательно

Размер шрифта в пунктах. По умолчанию используется размер, указанный в свойствах шрифта prop.

propmatplotlib.font_manager.FontProperties, необязательно

Свойства шрифта. Если не указаны, используется значение по умолчанию FontProperties с параметрами из rcParams.

_interpolation_stepsцелое число, необязательно

(В настоящее время игнорируется)

usetexбулево значение, по умолчанию: False

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

Примеры

Следующее создаёт путь из строки "ABC" с шрифтом Helvetica; и другой путь из латексной дроби 1/2:

from matplotlib.textpath import TextPath
from matplotlib.font_manager import FontProperties

fp = FontProperties(family="Helvetica", style="italic")
path1 = TextPath((12, 12), "ABC", size=12, prop=fp)
path2 = TextPath((0, 0), r"$\frac{1}{2}$", size=12, usetex=True)

См. также Использование текста как пути.

свойствоcodes

Возвращает коды

get_size()[source]

Получает размер текста.

set_size(size)[source]

Устанавливает размер текста.

свойствоvertices

Возвращает кэшированный путь, обновляя его при необходимости.

classmatplotlib.textpath.TextToPath[source]

Bases: object

Класс для преобразования строк в пути.

DPI=72

FONT_SCALE=100.0

get_glyphs_mathtext(prop, s, glyph_map=None, return_new_glyphs_only=False)[source]

Разбор строки mathtext s и преобразование её в пару (вершины, коды).

get_glyphs_tex(prop, s, glyph_map=None, return_new_glyphs_only=False)[source]

Преобразование строки s в вершины и коды с использованием режима usetex.

get_glyphs_with_font(font, s, glyph_map=None, return_new_glyphs_only=False)[source]

Преобразование строки s в вершины и коды с использованием предоставенного шрифта ttf.

get_texmanager()[source]

[Устарело] Возвращает кэшированный экземпляр TexManager.

Примечания

Устарело начиная с версии 3.6: Используйте TexManager() вместо этого.

get_text_path(prop, s, ismath=False)[source]

Преобразование текста s в путь (кортеж вершин и кодов для matplotlib.path.Path).

Параметры:

propFontProperties

Свойства шрифта для текста.

sstr

Текст, который нужно преобразовать.

ismath{False, True, "TeX"}

Если True, использовать парсер mathtext. Если "TeX", использовать TeX для отрисовки.

Возвращает:

vertslist

Список массивов NumPy, содержащих координаты x и y вершин.

codeslist

Список кодов пути.

Примеры

Создайте список вершин и кодов из текста и создайте Path из этих значений:

from matplotlib.path import Path
from matplotlib.textpath import TextToPath
from matplotlib.font_manager import FontProperties

fp = FontProperties(family="Humor Sans", style="italic")
verts, codes = TextToPath().get_text_path(fp, "ABC")
path = Path(verts, codes, closed=False)

Также см. TextPath для более прямого способа создания пути из текста.

get_text_width_height_descent(s, prop, ismath)[source]