mpl_toolkits.mplot3d.art3d.Path3DCollection

类 mpl_toolkits.mplot3d.art3d.Path3DCollection(*args, zs=0, zdir='z', depthshade=True, axlim_clip=False, **kwargs)

基类：PathCollection

三维路径的集合。

创建一组平坦的三维路径，其法向量指向 *zdir* 方向，并位于 *zdir* 轴上的 *zs* 位置。'zs' 可以是一个标量，也可以是一个与集合中路径数量相同长度的数组。

构造函数参数与 PathCollection 相同。此外，还可使用关键字 *zs=0* 和 *zdir='z'*。

此外，还可以使用关键字参数 *depthshade* 来指示是否对补丁进行深度着色以使其呈现深度感（默认为 *True*）。这在散点图中通常是需要的。

do_3d_projection()

draw(renderer)

使用给定的渲染器绘制 Artist（及其子对象）。

如果 artist 不可见（Artist.get_visible 返回 False），则此操作无效。

参数:

rendererRendererBase 子类。

备注

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

get_depthshade()

get_edgecolor()

get_facecolor()

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, depthshade=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sizes=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, sort_zpos=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<UNSET>, visible=<UNSET>, zorder=<UNSET>)

一次性设置多个属性。

支持的属性包括：

属性	描述
3d_properties	float 或 浮点数数组
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
alpha	类数组或浮点数或 None
animated	布尔值
antialiased 或 aa 或 antialiaseds	布尔值或布尔值列表
array	类数组或 None
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clim	(vmin: 浮点数, vmax: 浮点数)
clip_box	BboxBase 或 None
clip_on	布尔值
clip_path	Patch 或 (Path, Transform) 或 None
cmap	Colormap 或 字符串 或 None
color	颜色 或 RGBA 元组列表
depthshade	布尔值
edgecolor 或 ec 或 edgecolors	颜色 或 颜色列表 或 'face'
facecolor 或 facecolors 或 fc	颜色 或 颜色列表
figure	Figure 或 SubFigure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	未知
in_layout	布尔值
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
label	object
linestyle 或 dashes 或 linestyles 或 ls	字符串或元组或其列表
linewidth 或 linewidths 或 lw	未知
mouseover	布尔值
norm	Normalize 或 字符串 或 None
offset_transform 或 transOffset	变换
offsets	(N, 2) 或 (2,) 类数组
path_effects	AbstractPathEffect 列表
paths	未知
picker	None 或 布尔值 或 浮点数 或 可调用对象
pickradius	浮点数
rasterized	布尔值
sizes	未知
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
sort_zpos（Z轴排序位置）	未知
transform	变换
url	str
字符串列表或 None	urls
visible	布尔值
zorder	浮点数

set_3d_properties(zs, zdir, axlim_clip=False)

设置路径的 *z* 位置和方向。

参数:

zs浮点数或浮点数数组

在 *zdir* 轴上放置集合中路径的位置。

zdir{'x', 'y', 'z'}

与路径正交的绘图平面。所有路径必须具有相同的方向。有关值的描述，请参见 get_dir_vector。

axlim_clip布尔值, 默认值: False

是否隐藏顶点超出坐标轴视图限制的路径。

set_depthshade(depthshade)

设置是否对集合成员执行深度着色。

参数:

depthshade布尔值

是否对补丁进行着色以使其呈现深度感。

set_linewidth(lw)

设置集合的线宽。*lw* 可以是标量或序列；如果是序列，则补丁将按序列循环。

参数:

lw浮点数或浮点数列表

set_sizes(sizes, dpi=72.0)

设置集合中每个成员的大小。

参数:

sizesnumpy.ndarray 或 None

为集合中每个元素设置的大小。该值是元素的“面积”。

dpi浮点数, 默认值：72

画布的 DPI。

set_sort_zpos(val)

设置用于 Z 轴排序的位置。