matplotlib._enums

表示 Matplotlib 用作输入参数的字符串集合的枚举。

Matplotlib 经常使用简单的数据类型，如字符串或元组来定义一个概念；例如，线条的端点样式可以指定为 'butt'、'round' 或 'projecting' 之一。本模块中的类在内部使用，并用于正式记录这些概念。

作为终端用户，您不会直接使用这些类，而只会使用它们定义的值。

class matplotlib._enums.JoinStyle(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

定义两条线段之间的连接方式。

要直观了解每种 JoinStyle，请 在线查看这些文档 ，或运行 JoinStyle.demo。

在 Matplotlib 中，线条通常由一维 Path 和有限的 linewidth 定义，其中底层的一维 Path 表示描边线条的中心。

默认情况下，GraphicsContextBase 将描边线条的边界定义为中心线任何点周围一定半径 linewidth/2 内的所有点。然而，这会导致角落看起来“圆润”，如果你在绘制，例如，多边形或尖星，这可能不是期望的行为。

支持的值：

'miter'

“箭头尖端”样式。填充区域的每个边界将在与拐角相遇的点处沿与中心线切向量平行的直线延伸，直到它们在一个尖锐的点相遇。

'round'

在中心线 linewidth/2 半径范围内的每个点上施加斯托克斯力。

'斜角'

“方形”风格。可以将其视为一个圆角，其中角的“圆形”部分已被切除。

备注

很长的斜接尖端在达到一个称为“斜接限制”的后端依赖限制后会被切断（形成一个 斜面），该限制指定了斜接长度与线宽的最大允许比率。例如，PDF 后端使用 PDF 标准指定的默认值 10，而 SVG 后端甚至没有指定斜接限制，根据 SVG 规范，这导致默认值为 4。Matplotlib 目前不允许用户调整此参数。

关于斜接限制效果的更详细描述可以在 Mozilla 开发者文档 中找到。

(Source code, 2x.png, png)

static demo()

展示每种 JoinStyle 在不同连接角度下的外观。

class matplotlib._enums.CapStyle(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

定义未闭合线条的两个端点（帽）的绘制方式。

如何绘制表示闭合曲线（即以 CLOSEPOLY 结束的曲线）的线的起点和终点，由线的 JoinStyle 控制。对于所有其他线，起点和终点的绘制方式由 CapStyle 控制。

要直观了解每种 CapStyle，请 在线查看这些文档 或运行 CapStyle.demo。

默认情况下，GraphicsContextBase 在端点处绘制一条方形截断的描边线。

支持的值：

'屁股'

线条在其端点处被截断。

'投影'

这条线像 butt 那样被截断，但填充区域在终点之外延伸了 linewidth/2 的距离。

'round'

像 butt，但在线的末端添加了一个半圆形的盖子，半径为 linewidth/2。

(Source code, 2x.png, png)

static demo()

展示每种 CapStyle 对于粗线段的外观效果。