mpl_toolkits.mplot3d.axes3d.Axes3D.fill_between#
- Axes3D.fill_between(x1, y1, z1, x2, y2, z2, *, where=None, mode='auto', facecolors=None, shade=None, axlim_clip=False, **kwargs)[source]#
填充两个三维曲线之间的区域。
曲线由点 (x1, y1, z1) 和 (x2, y2, z2) 定义。这会创建一个或多个填充的四边形多边形。所有点的长度必须相同 N，或者是一个用于所有点的单个值。
- 参数:
- x1, y1, z1浮点数或一维类数组对象
第一条线的顶点 x、y 和 z 坐标。
- x2, y2, z2浮点数或一维类数组对象
第二条线的顶点 x、y 和 z 坐标。
- where布尔数组（长度 N），可选
定义要排除某些区域不被填充的where参数。填充区域由所有 x、y 和 z 点的坐标
pts[where]定义。更精确地说，如果where[i] and where[i+1]为真，则填充pts[i]和pts[i+1]之间的区域。请注意，此定义意味着在where中两个False值之间的一个孤立的True值不会导致填充。由于相邻的False值，True位置的两侧仍然未填充。- mode{'quad', 'polygon', 'auto'}，默认值: 'auto'
填充模式。以下之一：
'quad'：为两条线中每对相邻的点创建一个单独的四边形多边形。
'polygon'：两条线连接形成一个单一的多边形。这速度更快，并且对于简单形状（例如，在同一平面上的两条线之间填充）可以更清晰地渲染。
'auto'：如果所有点都在同一个三维平面上，则使用 'polygon' 模式。否则，使用 'quad' 模式。
- facecolors颜色列表，默认值: None
每个独立补丁的颜色，或用于所有补丁的单一颜色。
- shade布尔值，默认值: None
是否对表面颜色进行着色。如果为 None，则 'quad' 模式默认为 True，'polygon' 模式默认为 False。
- axlim_clip布尔值, 默认值: False
是否隐藏超出坐标轴视图限制的数据。
自 3.10 版本新增。
- **kwargs
所有其他关键字参数都会传递给
Poly3DCollection。
- 返回:
返回值一个包含绘制的多边形的
Poly3DCollection。
