mpl_toolkits.mplot3d.art3d.Path3DCollection

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

基类： PathCollection

3D 路径集合。

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

构造函数参数与 PathCollection 相同。此外，还提供了关键字参数 zs=0 和 zdir='z'。

此外，还提供了关键字参数 depthshade，用于指示是否对补丁（patches）进行阴影处理以呈现深度感（默认为 True）。这通常在散点图中需要。

depthshade_minalpha 设置由深度阴影应用的最小 Alpha 值。

do_3d_projection()

draw(renderer)

使用给定的渲染器绘制 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>, hatchcolor=<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>, **kwargs)

一次性设置多个属性。

a.set(a=A, b=B, c=C)

等同于

a.set_a(A)
a.set_b(B)
a.set_c(C)

除全名属性外，还支持别名，例如 set(lw=2) 等同于 set(linewidth=2)，但同时传入两者会报错。

各个 setter 的调用顺序与 set() 中的参数顺序一致。然而，大多数属性并不相互依赖，因此顺序通常无关紧要。

支持的属性包括：

属性	描述
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	color 或 color 列表 或 'face'
facecolor 或 facecolors 或 fc	color 或 color 列表
figure	Figure 或 SubFigure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	未知
hatchcolor	color 或 color 列表 或 'edge'
in_layout	布尔值
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
label	object
linestyle 或 dashes 或 linestyles 或 ls	{'-', '--', '-.', ':', '', ...} 或 (offset, on-off-seq) 或其列表
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

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

自 3.10 版本新增。

set_depthshade(depthshade, depthshade_minalpha=None)

设置是否对集合成员进行深度阴影处理。

参数:

depthshadebool

是否对补丁进行阴影处理以呈现深度感。

depthshade_minalphafloat

设置深度阴影所使用的最小 alpha 值。

于版本 3.11 新增。

set_linewidth(lw)

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

参数:

lwfloat 或 float 列表

set_sizes(sizes, dpi=72.0)

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

参数:

sizesnumpy.ndarray 或 None

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

dpifloat, 默认: 72

画布的 dpi。

set_sort_zpos(val)

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