PySide6.QtGui.QPainterPathStroker

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__()

创建一个新的描边器。

__init__(pen)
Parameters:

笔 – QPen

基于pen创建一个新的描边器。

capStyle()
Return type:

PenCapStyle

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

另请参阅

setCapStyle()

createStroke(path)
Parameters:

路径 – QPainterPath

Return type:

QPainterPath

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

轮廓的各种设计方面基于描边器的属性：width()、capStyle()、joinStyle()、dashPattern()、curveThreshold() 和 miterLimit()。

生成的路径应仅用于勾勒给定的绘制路径。否则可能会导致意外行为。生成的轮廓还需要默认设置的Qt::WindingFill规则。

curveThreshold()
Return type:

浮点数

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

另请参阅

setCurveThreshold()

dashOffset()
Return type:

浮点数

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

另请参阅

setDashOffset()

dashPattern()
Return type:

.qreal列表

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

另请参阅

setDashPattern()

joinStyle()
Return type:

PenJoinStyle

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

另请参阅

setJoinStyle()

miterLimit()
Return type:

浮点数

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

另请参阅

setMiterLimit()

setCapStyle(style)
Parameters:

样式 – PenCapStyle

将生成轮廓的端点样式设置为style。如果设置了虚线模式，模式的每个段都将受到端点style的影响。

另请参阅

capStyle()

setCurveThreshold(threshold)
Parameters:

threshold – 浮点数

指定曲线扁平化的threshold，控制生成轮廓的曲线绘制的精细程度。

默认阈值是一个经过良好调整的值（0.25），通常您不需要修改它。然而，您可以通过减小其值来使曲线的外观更加平滑。

另请参阅

curveThreshold()

setDashOffset(offset)
Parameters:

offset – 浮点数

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

请参阅setDashOffset()的文档以了解虚线偏移的描述。

另请参阅

dashOffset()

setDashPattern(style)
Parameters:

样式 – PenStyle

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

另请参阅

dashPattern()

setDashPattern(dashPattern)
Parameters:

dashPattern – .qreal的列表

这是一个重载函数。

设置生成轮廓的虚线模式为dashPattern。此函数使得可以指定自定义的虚线模式。

列表中的每个元素包含笔画中短划线和空格的长度，从第一个元素中的第一个短划线开始，第二个元素中的第一个空格，然后交替为每对后续元素中的短划线和空格。

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

setJoinStyle(style)
Parameters:

样式 – PenJoinStyle

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

另请参阅

joinStyle()

setMiterLimit(length)
Parameters:

长度 – 浮点数

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

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

此值仅在连接样式为 Qt::MiterJoin 时使用。

另请参阅

miterLimit()

setWidth(width)
Parameters:

width – 浮点数

将生成的轮廓绘制路径的宽度设置为 width。

生成的轮廓将向给定输入路径原始轮廓的每一侧延伸大约50%的width。

另请参阅

width()

width()
Return type:

浮点数

返回生成轮廓的宽度。

另请参阅

setWidth()