mpl_toolkits.mplot3d.art3d.Text3D

mpl_toolkits.mplot3d.art3d类。Text3D ( x = 0 , y = 0 , z = 0 , text = '' , zdir = 'z' , ** kwargs )

基地：Text

具有 3D 位置和方向的文本对象。

参数：

x, y, z

文本的位置。

文字串

要显示的文本字符串。

zdir {'x'，'y'，'z'，无，三元组}

文本的方向。有关get_dir_vector这些值的说明，请参阅。

其他参数：

**kwargs

所有其他参数都传递给Text.

在x , y处创建一个带有字符串textText的实例。

文本根据（默认：'left'）和 （默认：'bottom'）相对于锚点（x，y ）对齐。另请参见 文本对齐。horizontalalignmentverticalalignment

虽然 Text 接受 'label' 关键字参数，但默认情况下它不会添加到图例的句柄中。

有效的关键字参数是：

财产	描述
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	标量或无
animated	布尔
backgroundcolor	颜色
bbox	具有属性的字典patches.FancyBboxPatch
clip_box	未知
clip_on	未知
clip_path	未知
color或 c	颜色
figure	Figure
fontfamily或家人	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties或字体或字体属性	font_manager.FontProperties或str或pathlib.Path
fontsize或尺寸	浮动或{'xx-small'、'x-small'、'small'、'medium'、'large'、'x-large'、'xx-large'}
fontstretch或拉伸	{0-1000 范围内的数值，'超压缩'，'超压缩'，'压缩'，'半压缩'，'普通'，'半扩展'，'扩展'，'超扩展', '超膨胀'}
fontstyle或风格	{'正常'，'斜体'，'斜体'}
fontvariant或变体	{'正常', '小型大写字母'}
fontweight或重量	{0-1000 范围内的数值, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', '粗体'，'重'，'超粗体'，'黑色'}
gid	字符串
horizontalalignment或哈	{'左'，'中心'，'右'}
in_layout	布尔
label	目的
linespacing	浮动（字体大小的倍数）
math_fontfamily	字符串
mouseover	布尔
multialignment或马	{'左'，'右'，'中心'}
parse_math	布尔
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
position	（浮动，浮动）
rasterized	布尔
rotation	浮动或{'垂直'，'水平'}
rotation_mode	{无，'默认'，'锚点'}
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
text	目的
transform	Transform
transform_rotates_text	布尔
url	字符串
usetex	布尔或无
verticalalignment或 va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	布尔
wrap	布尔
x	漂浮
y	漂浮
zorder	漂浮

绘制（渲染器）

使用给定的渲染器绘制艺术家（及其子级）。

如果艺术家不可见，这将无效（Artist.get_visible 返回 False）。

参数：

渲染器RendererBase子类。

笔记

此方法在 Artist 子类中被覆盖。

get_position_3d ( )

返回文本的 (x, y, z) 位置。

get_tightbbox ( renderer = None )

喜欢Artist.get_window_extent，但包括任何剪辑。

参数：

渲染器RendererBase子类

将用于绘制图形的渲染器（即 fig.canvas.get_renderer()）

返回：

Bbox

封闭的边界框（在图中像素坐标中）。

设置( * , agg_filter=<UNSET> , alpha=<UNSET> , animated=<UNSET> , backgroundcolor=<UNSET> , bbox=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , color=<UNSET> , fontfamily=<UNSET> , fontproperties=<UNSET> , fontsize=<UNSET> , fontstretch=<UNSET> , fontstyle=<UNSET> , fontvariant=<UNSET> , fontweight=<UNSET> , gid=<未设置>,水平对齐=<未设置>, in_layout=<UNSET> , label=<UNSET> , linespacing=<UNSET> , math_fontfamily=<UNSET> , mouseover=<UNSET > , multialignment=<UNSET> , parse_math =<UNSET> , path_effects=<UNSET> ,选择器=<UNSET> , position=<UNSET> , position_3d=<UNSET> , rasterized=<UNSET> , rotation=<UNSET> , rotation_mode=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , text=<未设置> ,变换=<UNSET> ,transform_rotates_text=<UNSET> , url=<UNSET> , usetex=<UNSET> , verticalalignment=<UNSET> , visible=<UNSET> , wrap=<UNSET> , x=<UNSET> , y=<UNSET> , z= <UNSET> , zorder=<UNSET> )

一次设置多个属性。

支持的属性是

财产	描述
3d_properties	未知
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	标量或无
animated	布尔
backgroundcolor	颜色
bbox	具有属性的字典patches.FancyBboxPatch
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
color或 c	颜色
figure	Figure
fontfamily或家人	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties或字体或字体属性	font_manager.FontProperties或str或pathlib.Path
fontsize或尺寸	浮动或{'xx-small'、'x-small'、'small'、'medium'、'large'、'x-large'、'xx-large'}
fontstretch或拉伸	{0-1000 范围内的数值，'超压缩'，'超压缩'，'压缩'，'半压缩'，'普通'，'半扩展'，'扩展'，'超扩展', '超膨胀'}
fontstyle或风格	{'正常'，'斜体'，'斜体'}
fontvariant或变体	{'正常', '小型大写字母'}
fontweight或重量	{0-1000 范围内的数值, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', '粗体'，'重'，'超粗体'，'黑色'}
gid	字符串
horizontalalignment或哈	{'左'，'中心'，'右'}
in_layout	布尔
label	目的
linespacing	浮动（字体大小的倍数）
math_fontfamily	字符串
mouseover	布尔
multialignment或马	{'左'，'右'，'中心'}
parse_math	布尔
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
position	（浮动，浮动）
position_3d	（浮动，浮动，浮动）
rasterized	布尔
rotation	浮动或{'垂直'，'水平'}
rotation_mode	{无，'默认'，'锚点'}
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
text	目的
transform	Transform
transform_rotates_text	布尔
url	字符串
usetex	布尔或无
verticalalignment或 va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	布尔
wrap	布尔
x	漂浮
y	漂浮
z	漂浮
zorder	漂浮

set_3d_properties ( z = 0 , zdir = 'z' )

set_position_3d ( xyz , zdir = None )

设置文本的 ( x , y , z ) 位置。

参数：

xyz （浮动，浮动，浮动）

3D 空间中的位置。

zdir {'x'，'y'，'z'，无，三元组}

文本的方向。如果未指定，则不会更改 zdir。

set_z ( z )

设置文本的z位置。

参数：

z浮动