mpl_toolkits.mplot3d.art3d.Poly3DCollection

mpl_toolkits.mplot3d.art3d类。Poly3DCollection ( verts , * args , zsort = 'average' , ** kwargs )

基地：PolyCollection

3D 多边形的集合。

笔记

填充 3D 多边形

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

在实践中，Matplotlib 填充了多边形的 2D 投影。这只会为平面多边形提供正确的填充外观。对于所有其他多边形，您将找到多边形边缘在投影中相交的方向。这将导致 3D 区域的不正确可视化。

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

参数：

(N, 3) 类数组的verts列表

每个元素将多边形描述为一系列N_i点 。(x, y, z)

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

z 顺序的计算方法。详情请参阅set_zsort。

*args, **kwargs

所有其他参数都转发到PolyCollection.

笔记

请注意，这个类对 _facecolors 和 _edgecolors 属性有一点魔力。

do_3d_projection ( )

为此对象执行 3D 投影。

get_edgecolor ( )

get_facecolor ( )

get_vector ( segments3d )

优化投影点。

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 > , hat=< 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> )

一次设置多个属性。

支持的属性是

财产	描述
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	未知
animated	布尔
antialiased或 aa 或抗锯齿	布尔或布尔列表
array	类数组或无
capstyle	CapStyle或 {'butt', 'projecting', 'round'}
clim	（vmin：浮动，vmax：浮动）
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	Colormap或 str 或 无
color	rgba 元组的颜色或列表
edgecolor或 ec 或 edgecolors	未知
facecolor或 facecolors 或 fc	未知
figure	Figure
gid	字符串
hatch	{'/'、'\'、'|'、'-'、'+'、'x'、'o'、'O'、'.'、'*'}
in_layout	布尔
joinstyle	JoinStyle或 {'miter', 'round', 'bevel'}
label	目的
linestyle或破折号或线条样式或 ls	str 或元组或其列表
linewidth或线宽或lw	浮动或浮动列表
mouseover	布尔
norm	Normalize或 str 或 无
offset_transform或 transOffset	未知
offsets	(N, 2) 或 (2,) 类数组
path_effects	AbstractPathEffect
paths	类似数组的列表
picker	None 或 bool 或 float 或可调用
pickradius	未知
rasterized	布尔
sizes	ndarray 或无
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
sort_zpos	未知
transform	Transform
url	字符串
urls	str 或 None 的列表
verts	未知
verts_and_codes	未知
visible	布尔
zorder	漂浮
zsort	{'平均'，'最小值'，'最大值'}

set_3d_properties ( )

set_alpha ( alpha )

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

参数：

类似于alpha数组或标量或无

所有值都必须在 0-1 范围内（含）。不支持掩码值和 nan。

set_edgecolor (颜色)

设置集合的边缘颜色。

参数：

c颜色或颜色列表或“面”

集合边缘颜色。如果是一个序列，补丁会循环通过它。如果是'face'，匹配facecolor。

set_facecolor (颜色)

设置集合的 facecolor(s)。c可以是一种颜色（所有色块都具有相同的颜色），也可以是一系列颜色；如果它是一个序列，补丁将在序列中循环。

如果c为“none”，则不会填充补丁。

参数：

c颜色或颜色列表

set_sort_zpos ( val )

设置用于 z 排序的位置。

set_verts ( verts , closed = True )

设置 3D 顶点。

set_verts_and_codes (顶点,代码)

使用路径代码设置 3D 顶点。

set_zsort ( zsort )

设置 z 顺序的计算方法。

参数：

zsort {'平均'，'最小值'，'最大值'}

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

的示例mpl_toolkits.mplot3d.art3d.Poly3DCollection

3D 曲面图中的自定义山体阴影

3D 曲面图中的自定义山体阴影

同一图中的 2D 和 3D 轴

2D 和 3D *Axes* 在同一个 *Figure*

生成多边形以填充 3D 折线图

生成多边形以填充 3D 折线图

3D 图作为子图

3D 图作为子图

3D 表面（颜色图）

3D 表面（颜色图）

3D 表面（棋盘）

3D 表面（棋盘）