matplotlib.textpath
-
class matplotlib.textpath.TextPath(xy, s, size=None, prop=None, _interpolation_steps=1, usetex=False, *args, **kwargs)[source] -
Основы:
matplotlib.path.PathСоздать путь из текста.
Создать путь из текста. Обратите внимание, что это просто путь, а не объект. Вам нужно использовать
PathPatch(или другие объекты) для рисования этого пути на холсте.Параметры: -
xy : tuple or array of two float values -
Позиция текста. Для отсутствия смещения используйте
xy=(0, 0). -
s : str -
Текст, который нужно преобразовать в путь.
-
size : float, optional -
Размер шрифта в пунктах. По умолчанию используется размер, указанный в свойствах шрифта prop.
-
prop : matplotlib.font_manager.FontProperties, optional -
Свойства шрифта. Если не указано, используется значение по умолчанию
FontPropertiesс параметрами из rcParams. -
_interpolation_steps : integer, optional -
(В настоящее время игнорируется)
-
usetex : bool, 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)Также см. Демонстрация пути текста.
-
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.
-
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).
Параметры: -
prop : matplotlib.font_manager.FontProperties instance -
Свойства шрифта для текста.
-
s : str -
Текст для преобразования.
-
ismath : {False, True, "TeX"} -
Если True, использовать парсер mathtext. Если "TeX", использовать TeX для рендеринга.
-
usetex : bool, optional -
Если задано, принудительно устанавливает ismath в True. Этот параметр устарел.
Возвращает: -
verts, codes : tuple 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.
-
tex_font_map -
[Устарело]
Примечания
Устарело начиная с версии 3.0:
-
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.1.1/api/textpath_api.html