Spec-Zone.ru › Matplotlib 3.1

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

Spec-Zone.ru

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