matplotlib.textpath

class matplotlib.textpath.TextPath(xy, s, size=None, prop=None, _interpolation_steps=1, usetex=False)[源代码]

基类:matplotlib.path.Path

从文本创建路径。

从文本创建路径。请注意,它只是一条路径,而不是艺术家。你需要使用 PathPatch (或其他艺术家)将此路径绘制到画布上。

参数:
xy两个浮点值的元组或数组

文本的位置。对于无偏移,使用 xy=(0, 0) .

sSTR

要转换为路径的文本。

size可选浮动

以磅为单位的字体大小。默认为通过字体属性指定的大小 prop .

propmatplotlib.font_manager.FontProperties 可选matplotlib.font_manager.fontproperties,可选

字体属性。如果未提供,将使用默认值 FontProperties 参数来自 rcParams .

_interpolation_steps可选的

(当前被忽略)

usetexbool,默认值:False

是否使用tex渲染。

实例

下面从字符串“abc”创建一个带有helvetica字体的路径;从 Latex 分数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()[源代码]

获取文本大小。

set_size(size)[源代码]

设置文本大小。

property vertices

如果需要,请在更新缓存路径后返回该路径。

class matplotlib.textpath.TextToPath[源代码]

基类:object

将字符串转换为路径的类。

DPI = 72
FONT_SCALE = 100.0
get_glyphs_mathtext(prop, s, glyph_map=None, return_new_glyphs_only=False)[源代码]

分析mathtext字符串 s 并将其转换为(顶点,代码)对。

get_glyphs_tex(prop, s, glyph_map=None, return_new_glyphs_only=False)[源代码]

转换字符串 s 到顶点和代码使用usetex模式。

get_glyphs_with_font(font, s, glyph_map=None, return_new_glyphs_only=False)[源代码]

转换字符串 s 使用提供的TTF字体的顶点和代码。

get_texmanager()[源代码]

返回缓存 TexManager 实例。

get_text_path(prop, s, ismath=False)[源代码]

转换文本 s 到路径(matplotlib.path.path的顶点和代码的元组)。

参数:
propFontPropertiesFontProperties

文本的字体属性。

sSTR

要转换的文本。

ismath{假,真,“TeX”}

如果为True,则使用mathtext解析器。如果是“TeX”,则使用TeX进行渲染。

返回:
verts列表

包含顶点的x和y坐标的numpy数组的列表。

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(s, prop, ismath)[源代码]