matplotlib._enums

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

Matplotlib 通常使用字符串或元组等简单数据类型来定义概念；例如，线段连接样式（capstyle）可以指定为 'butt'、'round' 或 'projecting' 之一。此模块中的类在内部使用，用于正式记录这些概念。

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

class matplotlib._enums.JoinStyle(*values)

定义如何绘制两条线段之间的连接处。

要查看每种 JoinStyle 的视觉效果，请在线查看这些文档，或运行 JoinStyle.demo。

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

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

支持的值

'miter'

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

'round'

填充中心线半径为 linewidth/2 范围内的所有点。

'bevel'

“平截”样式。可以将其视为圆角被切掉后的样子。

注意

非常长的尖角（miter tips）会在超过名为“斜接限制”（miter limit）的后端相关限制后被切掉（形成 bevel），该限制指定了斜接长度与线宽的最大允许比率。例如，PDF 后端使用 PDF 标准规定的默认值 10，而 SVG 后端甚至没有指定斜接限制，根据 SVG 规范，其默认值为 4。Matplotlib 目前不允许用户调整此参数。

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

(源代码, 2x.png, png)

static demo()

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

class matplotlib._enums.CapStyle(*values)

定义如何绘制非闭合线段的两个端点（线帽）。

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

要查看每种 CapStyle 的视觉效果，请在线查看这些文档，或运行 CapStyle.demo。

默认情况下，GraphicsContextBase 将描边线条的端点绘制为平头。

支持的值

'butt'

线条在其端点处平齐。

'projecting'

线条像 butt 一样平齐，但填充区域会延伸到超出端点 linewidth/2 的距离。

'round'

类似于 butt，但在线条末端添加一个半径为 linewidth/2 的半圆形线帽。

(源代码, 2x.png, png)

static demo()

演示每种 CapStyle 在粗线段上的外观。