mpl_toolkits.mplot3d.art3d.Poly3DCollection

class mpl_toolkits.mplot3d.art3d.Poly3DCollection(verts, *args, zsort='average', shade=False, lightsource=None, axlim_clip=False, **kwargs)

基类： PolyCollection

三维多边形集合。

注意

三维多边形的填充

除非多边形是平面的，否则三维多边形的封闭表面没有简单的定义。

实际上，Matplotlib 会填充多边形的二维投影。这种填充方式仅对平面多边形能提供正确的视觉效果。对于所有其他多边形，您会发现在某些方向上，多边形的边在投影中会相交。这将导致三维区域的显示不正确。

如果您需要填充区域，建议通过 plot_trisurf 创建它们，该函数会生成三角剖分，从而创建一致的表面。

参数:

verts(N, 3) 数组状对象的列表

多边形序列 [verts0, verts1, ...]，其中每个元素 verts_i 定义了多边形 i 的顶点，为一个形状为 (N, 3) 的二维数组状对象。

zsort{'average', 'min', 'max'}，默认值：'average'

z 序的计算方法。详见 set_zsort。

shade布尔值，默认值：False

是否对 facecolors 和 edgecolors 进行着色。启用 shade 时，必须提供 facecolors 和/或 edgecolors。

版本 3.7 新增。

lightsourceLightSource，可选

当 *shade* 为 True 时使用的光源。

版本 3.7 新增。

axlim_clip布尔值, 默认值: False

是否隐藏顶点超出视图限制的多边形。

*args, **kwargs

所有其他参数都会转发给 PolyCollection。

备注

请注意，此类对 _facecolors 和 _edgecolors 属性做了一些特殊处理。

do_3d_projection()

执行此对象的三维投影。

get_edgecolor()

get_facecolor()

get_vector(segments3d)

[已弃用]

备注

自 3.10 版本起已弃用

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>, 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>, verts=<UNSET>, verts_and_codes=<UNSET>, visible=<UNSET>, zorder=<UNSET>, zsort=<UNSET>)

一次性设置多个属性。

支持的属性包括：

属性	描述
3d_properties	未知
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
alpha	未知
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 元组列表
edgecolor 或 ec 或 edgecolors	未知
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	numpy.ndarray 或 None
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
sort_zpos（Z轴排序位置）	未知
transform	变换
url	str
字符串列表或 None	urls
verts	(N, 3) 数组状对象的列表
verts_and_codes	未知
visible	布尔值
zorder	浮点数
zsort	{'average', 'min', 'max'}

set_3d_properties(axlim_clip=False)

set_alpha(alpha)

设置用于混合的alpha值 - 不支持所有后端。

参数:

alpha数组状对象或浮点数或 None

所有值都必须在 [0, 1] 范围内（包含边界）。不支持遮罩值和 NaN。

set_edgecolor(colors)

设置集合的边颜色。

参数:

c颜色 或 颜色 列表 或 'face'

集合的边颜色。如果是序列，则补丁会循环使用这些颜色。如果为 'face'，则与面颜色匹配。

set_facecolor(colors)

设置集合的面颜色。c 可以是单一颜色（所有补丁具有相同的颜色），也可以是颜色序列；如果它是序列，则补丁将循环使用该序列中的颜色。

如果 c 为 'none'，则补丁将不被填充。

参数:

c颜色 或 颜色 列表

set_sort_zpos(val)

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

set_verts(verts, closed=True)

设置三维顶点。

参数:

verts(N, 3) 数组状对象的列表

多边形序列 [verts0, verts1, ...]，其中每个元素 verts_i 定义了多边形 i 的顶点，为一个形状为 (N, 3) 的二维数组状对象。

closed布尔值，默认值：True

是否通过在末尾添加 CLOSEPOLY 连接来闭合多边形。

set_verts_and_codes(verts, codes)

使用路径代码设置三维顶点。

set_zsort(zsort)

设置 z 序的计算方法。

参数:

zsort{'average', 'min', 'max'}

应用于观看者坐标系中顶点 z 坐标的函数，用于确定 z 序。

使用 mpl_toolkits.mplot3d.art3d.Poly3DCollection 的示例

三维曲面图中的自定义山体阴影

三维曲面图中的自定义山体阴影

同一图形中的二维和三维坐标轴

同一图形中的二维和三维坐标轴

生成三维多边形

生成三维多边形

作为子图的三维图

作为子图的三维图

三维曲面（色彩映射）

三维曲面（色彩映射）

三维曲面（棋盘格）

三维曲面（棋盘格）