mpl_toolkits.mplot3d.art3d.Line3DCollection

class mpl_toolkits.mplot3d.art3d.Line3DCollection(lines, axlim_clip=False, **kwargs)

基类: LineCollection

3D 线条集合。

参数:

segments形状为 (N, 2) 的类数组对象列表

序列 [line0, line1, ...]，其中每条线都是一个 (N, 2) 形状的类数组对象，包含点。

line0 = [(x0, y0), (x1, y1), ...]

每条线可以包含不同数量的点。

linewidths浮点数或浮点数列表, 默认值: rcParams["lines.linewidth"] (默认值: 1.5)

每条线的宽度（以点为单位）。

colors颜色 或 颜色列表, 默认值: rcParams["lines.color"] (默认值: 'C0')

RGBA 元组序列（例如，不允许任意颜色字符串等）。

antialiaseds布尔值或布尔值列表, 默认值: rcParams["lines.antialiased"] (默认值: True)

是否对每条线使用抗锯齿。

zorder浮点数, 默认值: 2

绘制后线条的 zorder。

facecolors颜色 或 颜色 列表, 默认值: 'none'

设置 *facecolors* 时，每条线都被解释为区域的边界，隐式地将路径从最后一个点闭合到第一个点。封闭区域将填充 *facecolor*。为了手动指定每条线的“内部”应如何计算，请使用 PathCollection 代替，其中“内部”可以通过适当使用 CLOSEPOLY 来指定。

**kwargs

转发至 Collection。

do_3d_projection()

根据渲染器矩阵投影点。

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>, colors=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gapcolor=<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>, segments=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, sort_zpos=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<UNSET>, verts=<UNSET>, visible=<UNSET>, zorder=<UNSET>)

一次性设置多个属性。

支持的属性包括：

属性	描述
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（颜色）	颜色 或 颜色列表
颜色	颜色 或 颜色列表
edgecolor 或 ec 或 edgecolors	颜色 或 颜色列表 或 'face'
facecolor 或 facecolors 或 fc	颜色 或 颜色列表
figure（图）	Figure 或 SubFigure
gapcolor（间隙颜色）	颜色 或 颜色列表 或 None
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（栅格化）	布尔值
segments（线段）	未知
sketch_params（草图参数）	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap（捕捉）	布尔值或 None
sort_zpos（Z轴排序位置）	未知
transform（变换）	变换
url	str
字符串列表或 None	urls
verts	未知
visible（可见）	布尔值
zorder（Z轴顺序）	浮点数

set_segments(segments)

设置 3D 线段。

set_sort_zpos(val)

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

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

三维茎叶图

三维茎叶图