class QPainterPathStroker#

QPainterPathStroker 类用于为指定的画家路径生成可填充的外轮廓。 更多…

摘要#

方法#

注意

本文档中可能包含自动从C++转换为Python的代码片段。我们始终欢迎对代码片段的翻译作出贡献。如果您发现翻译有问题，您也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建工单的方式告诉我们。

详细描述#

通过调用createStroke() 函数，并将一个给定的QPainterPath 作为参数传递，将创建一个新的表示给定路径轮廓的画家路径。然后，可以填充新创建的画家路径以绘制原始画家路径的轮廓。

您可以使用以下函数控制轮廓的各种设计方面（宽度、端点样式、连接样式和虚线模式）

setDashPattern() 函数接受Qt::PenStyle对象和作为参数的模式列表表示形式。

此外，您还可以使用setCurveThreshold() 函数指定曲线的国值，控制绘制曲线的粒度。默认的国值是一个合适的值（0.25），通常您不需要修改它。然而，通过减小其值可以使曲线的外观更加平滑。

您还可以使用setMiterLimit() 函数来控制生成的轮廓的倒角限制。倒角限制描述了倒角接合可以延伸到连接有多远。限制以单位宽度指定，因此像素级的倒角限制将为 miterlimit * width。此值仅在接合样式为Qt::MiterJoin时才使用。

createStroke() 函数生成的画家路径应仅用于绘制给定画家路径的轮廓。否则可能会引起意外的行为。生成的轮廓还需要使用Qt::WindingFill规则，该规则默认勾选。

另请参阅

QPen QBrush

__init__(pen)#
参数：

pen – QPen

创建一个基于 pen 的新笔刷。

__init__()

创建一个新的笔刷。

capStyle()#
返回类型：

笔帽样式

返回生成轮廓的笔帽样式。

另请参阅

setCapStyle()

createStroke(path)#
参数：

path – QPainterPath

返回类型：

QPainterPath

生成一个新的路径，该路径表示给定 path 的轮廓的填充区域。

轮廓的各个设计方面基于笔刷的属性：width() ， capStyle() ， joinStyle() ， dashPattern() ， curveThreshold() 和 miterLimit() 。

生成的路径只能用来勾勒给定的 painter 路径。否则可能会导致意外行为。生成的轮廓还需要 Qt::WindingFill 规则，默认设置为该规则。

curveThreshold()#
返回类型：

float

返回生成轮廓的曲线平滑阈值。

另请参阅

setCurveThreshold()

dashOffset()#
返回类型：

float

返回生成轮廓的虚线偏移。

另请参阅

setDashOffset()

dashPattern()#
返回类型：

.qreal 列表

返回生成轮廓的虚线模式。

另请参阅

setDashPattern()

joinStyle()#
返回类型：

笔画接合样式

返回生成轮廓的接合样式。

另请参阅

setJoinStyle()

miterLimit()#
返回类型：

float

返回生成轮廓的斜接限制。

另请参阅

setMiterLimit()

setCapStyle(风格)#
参数：

风格 – PenCapStyle

将生成轮廓的帽形风格设置为风格。如果设置了虚线模式，模式中的每个段落都将受帽形风格的影响。

另请参阅

capStyle()

setCurveThreshold(阈值)#
参数：

阈值 – float

指定曲线平滑化阈值，控制生成轮廓曲线的绘制粒度。

默认阈值为调整良好的值（0.25），通常您不需要修改它。但是，您可以将其值减小以使曲线的外观更平滑。

另请参阅

curveThreshold()

setDashOffset(偏移)#
参数：

偏移 – float

将生成轮廓的虚线偏移设置为偏移。

有关虚线偏移的描述，请参阅setDashOffset()的文档。

另请参阅

dashOffset()

setDashPattern(arg__1)#
参数：

arg__1 – PenStyle

将生成轮廓的虚线样式设置为样式。

另请参阅

dashPattern()

setDashPattern(dashPattern)
参数：

dashPattern – .实数列表

这是一个覆盖函数。

将生成轮廓的虚线样式设置为dashPattern。此函数可以使用户指定自定义虚线样式。

列表中的每个元素包含划痕的长度和间隔，从第一个元素中的第一个划痕开始，第二个元素中的第一个间隔开始，交替划痕和间隔的每个后续元素对。

列表可以包含奇数个元素，在这种情况下，最后一个元素将在模式重复时通过首先是元素的长度扩展。

setJoinStyle(风格)#
参数：

样式 – PenJoinStyle

设置生成轮廓的连接样式为style。

另请参阅

joinStyle()

setMiterLimit(length)#
参数：

length – float

设置生成轮廓的斜接限制为limit。

斜接限制描述了斜接连接可以从每个连接延伸多远。该限制以当前设置的宽度为单位指定。因此，像素级的斜接限制将是miterlimit * width。

只有当连接样式为Qt::MiterJoin时，此值才被使用。

另请参阅

miterLimit()

setWidth(width)#
参数：

width – float

设置生成轮廓的宽度为width。

生成的轮廓将扩展到给定输入路径原始轮廓每侧的大约50%。

另请参阅

width()

width()#
返回类型：

float

返回生成的轮廓宽度。

另请参阅

setWidth()