matplotlib.textpath
-
class matplotlib.textpath.TextPath(xy, s, size=None, prop=None, _interpolation_steps=1, usetex=False, *args, **kwargs)[source] -
Основы:
matplotlib.path.PathСоздать путь из текста.
Создать путь из текста. Обратите внимание, что это просто путь, а не объект. Вам нужно использовать
PathPatch(или другие объекты) для отрисовки этого пути на холсте.Параметры: -
xytuple or array of two float values -
Положение текста. Для отсутствия смещения используйте
xy=(0, 0). -
sstr -
Текст, который нужно преобразовать в путь.
-
sizefloat, optional -
Размер шрифта в пунктах. По умолчанию используется размер, указанный в свойствах шрифта prop.
-
propmatplotlib.font_manager.FontProperties, optional -
Свойства шрифта. Если не указано, будет использоваться стандартный
FontPropertiesс параметрами из rcParams. -
_interpolation_stepsinteger, optional -
(В настоящее время игнорируется)
-
usetexbool, optional -
Использовать рендеринг TeX. По умолчанию
False.
Примеры
Следующее создает путь из строки "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)См. также Демонстрация пути текста.
-
property codes -
Возвращает коды
-
get_size(self)[source] -
Получить размер текста.
-
is_math_text(self, s)[source] -
[Устаревшее] Возвращает True, если заданная строка s содержит математический текст.
Примечания
Устарело начиная с версии 3.1.
-
set_size(self, size)[source] -
Установить размер текста.
-
text_get_vertices_codes(self, prop, s, usetex)[source] -
[Устаревшее] Преобразовать строку s в пару (вершины, коды) с использованием свойств шрифта prop.
Примечания
Устарело начиная с версии 3.1.
-
property vertices -
Возвращает кэшированный путь после его обновления при необходимости.
-
-
class matplotlib.textpath.TextToPath[source] -
Основы:
objectКласс для преобразования строк в пути.
-
DPI = 72
-
FONT_SCALE = 100.0
-
get_glyphs_mathtext(self, prop, s, glyph_map=None, return_new_glyphs_only=False)[source] -
Разбор строки математического текста s и преобразование её в пару (вершины, коды).
-
get_glyphs_tex(self, prop, s, glyph_map=None, return_new_glyphs_only=False)[source] -
Преобразование строки s в вершины и коды с использованием режима usetex.
-
get_glyphs_with_font(self, font, s, glyph_map=None, return_new_glyphs_only=False)[source] -
Преобразование строки s в вершины и коды с использованием предоставенного шрифта ttf.
-
get_texmanager(self)[source] -
Возвращает кэшированный экземпляр
TexManager.
-
get_text_path(self, prop, s, ismath=False, usetex=<deprecated parameter>)[source] -
Преобразование текста s в путь (кортеж вершин и кодов для matplotlib.path.Path).
Параметры: -
propmatplotlib.font_manager.FontProperties instance -
Свойства шрифта для текста.
-
sstr -
Текст для преобразования.
-
ismath{False, True, "TeX"} -
Если True, использовать математический парсер. Если "TeX", использовать TeX для рендеринга.
-
usetexbool, optional -
Если задано, принудительно устанавливает ismath в True. Этот параметр устарел.
Возвращает: -
verts, codestuple of lists -
verts — список массивов NumPy, содержащих координаты x и y вершин. codes — список кодов пути.
Примеры
Создайте список вершин и кодов из текста и создайте
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(self, s, prop, ismath)[source]
-
glyph_to_path(self, font, currx=0.0)[source] -
[Устаревшее] Преобразование текущего глифа font в пару (вершины, коды).
Примечания
Устарело начиная с версии 3.1.
-
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.2.2/api/textpath_api.html