文本路径

matplotlib.textpath¶

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

基类：matplotlib.path.Path

从文本创建路径。

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

参数:	xy : 两个浮点值的元组或数组 文本的位置。对于无偏移，使用 xy=(0, 0) . s : STR 要转换为路径的文本。 size : 可选浮动 以磅为单位的字体大小。默认为通过字体属性指定的大小 prop . prop ： matplotlib.font_manager.FontProperties 可选 : matplotlib.font_manager.fontproperties，可选 字体属性。如果未提供，将使用默认值 FontProperties 参数来自 rcParams . _interpolation_steps : 整数，可选 （当前被忽略） 用语 : 可选的布尔 是否使用tex渲染。默认为 False .

实例

下面从字符串“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)

也看到 演示文本路径 .

codes¶

返回代码

get_size()[源代码]¶

获取文本的大小

is_math_text(s)[源代码]¶

如果给定的字符串 s 包含任何数学文本。

set_size(size)[源代码]¶

设置文本的大小

text_get_vertices_codes(prop, s, usetex)[源代码]¶

转换字符串 s 到使用提供的字体属性的顶点和代码 prop . 大部分是从后端复制的。

vertices¶

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

class matplotlib.textpath.TextToPath[源代码]¶

基类：object

使用TTF字体将给定文本转换为路径的类。

DPI = 72¶

FONT_SCALE = 100.0¶

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

转换字符串 s 通过用MathText解析顶点和代码。

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

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

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

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

get_texmanager()[源代码]¶

返回 matplotlib.texmanager.TexManager 实例

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

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

参数:	prop ： matplotlib.font_manager.FontProperties 实例 : matplotlib.font_manager.fontproperties实例 文本的字体属性。 s : STR 要转换的文本。 用语 : 可选的布尔 是否使用tex渲染。默认为 False . ISMAX : 可选的布尔 如果为true，则使用MathText解析器。仅在以下情况下有效 usetex == False .
返回:	代码代码 : 列表元组 维茨 是包含顶点的x和y坐标的numpy数组列表。 代码 是路径代码列表。

实例

从文本创建顶点和代码列表，并创建 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)[源代码]¶

glyph_to_path(font, currx=0.0)[源代码]¶

将ft2font glyph转换为顶点和代码。

tex_font_map¶

3.0 版后已移除: tex_font_map函数在matplotlib 3.0中已弃用，将在3.2中删除。