QPainterPathStroker 类

QPainterPathStroker 类用于为给定描绘器路径生成可填充轮廓。更多...

头：	#include <QPainterPathStroker>
CMake:	find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake:	QT += gui

所有成员列表，包括继承成员
QPainterPathStroker 属于描绘类 .

公共函数

	QPainterPathStroker ()
	QPainterPathStroker (const QPen & pen )
	~QPainterPathStroker ()
Qt::PenCapStyle	capStyle () const
QPainterPath	createStroke (const QPainterPath & path ) const
qreal	curveThreshold () const
qreal	dashOffset () const
QList<qreal>	dashPattern () const
Qt::PenJoinStyle	joinStyle () const
qreal	miterLimit () const
void	setCapStyle (Qt::PenCapStyle style )
void	setCurveThreshold (qreal threshold )
void	setDashOffset (qreal offset )
void	setDashPattern (Qt::PenStyle style )
void	setDashPattern (const QList<qreal> & dashPattern )
void	setJoinStyle (Qt::PenJoinStyle style )
void	setMiterLimit (qreal limit )
void	setWidth (qreal width )
qreal	width () const

详细描述

通过调用 createStroke () 函数，传递给定 QPainterPath 作为自变量，创建表示给定路径轮廓的新描绘器路径。然后可以填充新近创建的描绘器路径以绘制原始描绘器路径的轮廓。

可以使用下列函数，控制轮廓描绘的各设计方面 (宽度、帽样式、联接样式及虚线模式)：

The setDashPattern () 函数接受 Qt::PenStyle 对象和模式的列表表示作为自变量。

此外，可以指定曲线的阈值，控制曲线绘制的粒度，使用 setCurveThreshold () 函数。默认阈值的良好调节值是 0.25，且通常应该不需要修改。不管怎样，通过递减其值可以使曲线外观更平滑。

还可以控制生成轮廓的斜接限制使用 setMiterLimit () 函数。斜接限制描述斜接联接，可以从每联接延伸多远。限制以宽度单位指定，所以，像素级斜接限制将为 miterlimit * width 。才使用此值，若联接样式为 Qt::MiterJoin .

描绘器路径的生成通过 createStroke () 函数只应用于轮廓描绘给定描绘器路径。否则可能导致意外行为。生成的轮廓还要求 Qt::WindingFill 规则 (这是默认设置)。

另请参阅 QPen and QBrush .

成员函数文档编制

QPainterPathStroker:: QPainterPathStroker ()

创建新的描边器。

`[explicit]` QPainterPathStroker:: QPainterPathStroker (const QPen & pen )

创建新的描边器基于 pen .

`[noexcept]` QPainterPathStroker:: ~QPainterPathStroker ()

销毁描边器。

Qt::PenCapStyle QPainterPathStroker:: capStyle () const

返回生成轮廓的帽样式。

另请参阅 setCapStyle ().

QPainterPath QPainterPathStroker:: createStroke (const QPainterPath & path ) const

生成是可填充区域的新路径表示轮廓为给定 path .

轮廓的各设计方面是基于描边器特性： width (), capStyle (), joinStyle (), dashPattern (), curveThreshold () 和 miterLimit ().

生成路径只应用于轮廓化给定描绘器路径。否则，可能导致意外行为。生成轮廓还要求 Qt::WindingFill 规则 (这是默认设置)。

qreal QPainterPathStroker:: curveThreshold () const

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

另请参阅 setCurveThreshold ().

qreal QPainterPathStroker:: dashOffset () const

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

另请参阅 setDashOffset ().

QList < qreal > QPainterPathStroker:: dashPattern () const

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

另请参阅 setDashPattern ().

Qt::PenJoinStyle QPainterPathStroker:: joinStyle () const

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

另请参阅 setJoinStyle ().

qreal QPainterPathStroker:: miterLimit () const

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

另请参阅 setMiterLimit ().

void QPainterPathStroker:: setCapStyle ( Qt::PenCapStyle style )

将生成轮廓的帽样式设为 style 。若虚线模式有设置，则模式每段服从帽 style .

另请参阅 capStyle ().

void QPainterPathStroker:: setCurveThreshold ( qreal threshold )

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

默认阈值的良好调节值是 0.25，且通常应该不需要修改。不管怎样，通过递减其值可以使曲线外观更平滑。

另请参阅 curveThreshold ().

void QPainterPathStroker:: setDashOffset ( qreal offset )

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

见文档编制为 QPen::setDashOffset () 了解虚线偏移的描述。

另请参阅 dashOffset ().

void QPainterPathStroker:: setDashPattern ( Qt::PenStyle style )

将生成轮廓的虚线图案设为 style .

另请参阅 dashPattern ().

void QPainterPathStroker:: setDashPattern (const QList < qreal > & dashPattern )

这是重载函数。

将生成轮廓的虚线图案设为 dashPattern 。此函数使之可能指定自定义虚线模式。

列表各元素包含描边虚线和空格的长度，从第一元素第一虚线，第二元素第一空格开始，然后在每后续元素对的虚线和空格之间交替。

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

void QPainterPathStroker:: setJoinStyle ( Qt::PenJoinStyle style )

将生成轮廓的联接样式设为 style .

另请参阅 joinStyle ().

void QPainterPathStroker:: setMiterLimit ( qreal limit )

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

斜接限制描述斜接联接可以从每个联接延伸多远。限制以目前设置的宽度为单位指定。所以，像素级斜接限制将为 miterlimit * width .

才使用此值，若联接样式为 Qt::MiterJoin .

另请参阅 miterLimit ().

void QPainterPathStroker:: setWidth ( qreal width )

将生成轮廓描绘器路径的宽度设为 width .

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

另请参阅 width ().

qreal QPainterPathStroker:: width () const

返回生成轮廓的宽度。

另请参阅 setWidth ().