mpl_toolkits.mplot3d.art3d.Patch3DCollection

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

基类： PatchCollection

一个三维补丁集合。

创建一个平面三维补丁集合，其法向量指向 zdir 方向，位于 zdir 轴上的 zs 处。'zs' 可以是标量，也可以是与集合中补丁数量相同长度的类数组。

构造函数参数与 PatchCollection 相同。此外，还支持关键词 zs=0 和 zdir='z'。

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

do_3d_projection()

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>, 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 或 SubFigure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
孵化线宽	未知
在布局中	布尔值
连接样式	JoinStyle 或 {'miter', 'round', 'bevel'}
标签	对象
linestyle 或 dashes 或 linestyles 或 ls	字符串或元组或其列表
linewidth 或 linewidths 或 lw	浮点数或浮点数列表
鼠标悬停	布尔值
norm	Normalize 或 字符串 或 None
offset_transform 或 transOffset	变换
offsets	(N, 2) 或 (2,) 类数组
path_effects	AbstractPathEffect 列表
路径	未知
选择器	None 或 布尔值 或 浮点数 或 可调用对象
选择半径	浮点数
栅格化	布尔值
草图参数	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
对齐	布尔值或 None
sort_zpos（Z轴排序位置）	未知
变换	变换
网址	str
字符串列表或 None	urls
可见	布尔值
Z轴顺序	浮点数

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：bool

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

set_sort_zpos(val)

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