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'
“方角”样式。可以将其视为一个圆角,其中拐角的“圆形”部分已被切除。
注意
非常长的斜接尖端会在一个后端依赖的限制(称为“斜接限制”)之后被切除(形成倒角),该限制指定了斜接长度与线宽的最大允许比率。例如,PDF 后端使用 PDF 标准指定的默认值 10,而 SVG 后端甚至没有指定斜接限制,导致 SVG 规范的默认值为 4。Matplotlib 目前不允许用户调整此参数。
斜接限制效果的更详细描述可以在Mozilla 开发者文档中找到
- class matplotlib._enums.CapStyle(*values)[源码]#
定义未闭合线条的两个端点(cap)的绘制方式。
表示闭合曲线(即以
CLOSEPOLY
结尾)的线条的起点和终点绘制方式由线条的JoinStyle
控制。对于所有其他线条,起点和终点的绘制方式由 CapStyle 控制。要直观了解每种 CapStyle,请
在线查看这些文档
或运行CapStyle.demo
。默认情况下,
GraphicsContextBase
将描边线绘制成端点呈方形。支持的值
- 'butt'
线条在其端点处呈方形。
- 'projecting'
线条在其端点处呈方形,与 butt 类似,但填充区域超出端点距离
linewidth/2
。- 'round'
类似于 butt,但在线条末端添加一个半径为
linewidth/2
的半圆形端点。