Spec-Zone.ru › Matplotlib 3.2

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API