matplotlib.textpath#

matplotlib.textpath。TextPath ( xy , s , size = None , prop = None , _interpolation_steps = 1 , usetex = False ) [source] #

基地:Path

从文本创建路径。

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

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

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

字符串_

要转换为路径的文本。

大小浮动,可选

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

道具matplotlib.font_manager.FontProperties,可选

字体属性。如果未提供,将使用 带有rcParamsFontProperties参数 的默认值。

_interpolation_steps int,可选

(目前被忽略)

usetex布尔值,默认值:False

是否使用 tex 渲染。

例子

下面从带有 Helvetica 字体的字符串“ABC”创建一个路径;以及乳胶部分 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)

另请参阅使用文本作为路径

属性 代码#

返回代码

get_size ( ) [来源] #

获取文本大小。

set_size (大小) [来源] #

设置文字大小。

属性 顶点#

如有必要,在更新后返回缓存路径。

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 ) [来源] #

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

get_glyphs_with_font ( font , s , glyph_map = None , return_new_glyphs_only = False ) [来源] #

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

get_texmanager ( ) [来源] #

[弃用]返回缓存的TexManager实例。

笔记

3.6 版后已弃用:改用 TexManager()。

get_text_path ( prop , s , ismath = False ) [来源] #

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

参数
支柱FontProperties

文本的字体属性。

字符串_

要转换的文本。

ismath {假,真,“TeX”}

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

返回
顶点列表

包含顶点的 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 ) [来源] #