Sur cette page

QPainterPathStroker Class

La classe `QPainterPathStroker` sert à générer des contours pouvant être remplis à partir d'un tracé de dessin donné. En savoir plus...

En-tête : #include <QPainterPathStroker>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui

Fonctions publiques

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

Description détaillée

En appelant la fonction ` createStroke()` et en lui passant un ` QPainterPath ` donné comme argument, on crée un nouveau tracé de peinture représentant le contour du tracé donné. Le tracé de peinture nouvellement créé peut ensuite être rempli pour dessiner le contour du tracé de peinture d'origine.

Vous pouvez contrôler les différents aspects graphiques (largeur, styles d’extrémités, styles de jonction et motif de trait pointillé) du contour à l’aide des fonctions suivantes :

La fonction setDashPattern() accepte à la fois un objet Qt::PenStyle et une représentation sous forme de liste du motif en tant qu’argument.

De plus, vous pouvez spécifier le seuil d’une courbe, ce qui permet de contrôler la granularité avec laquelle celle-ci est tracée, à l’aide de la fonction setCurveThreshold(). Le seuil par défaut est une valeur bien ajustée (0,25) et, en règle générale, vous ne devriez pas avoir besoin de le modifier. Cependant, vous pouvez rendre l’aspect de la courbe plus lisse en diminuant cette valeur.

Vous pouvez également contrôler la limite de mitre pour le contour généré à l’aide de la fonction ` setMiterLimit()`. La limite de mitre décrit jusqu’à quelle distance de chaque jonction la mitre peut s’étendre. La limite est spécifiée en unités de largeur ; ainsi, la limite de mitre au niveau des pixels sera ` miterlimit * width`. Cette valeur n’est utilisée que si le style de jonction est ` Qt::MiterJoin`.

Le tracé de peinture généré par la fonction createStroke() ne doit être utilisé que pour tracer le contour du tracé de peinture donné. Dans le cas contraire, cela pourrait entraîner un comportement inattendu. Les contours générés nécessitent également la règle Qt::WindingFill, qui est activée par défaut.

Voir également QPen et QBrush.

Documentation des fonctions membres

QPainterPathStroker::QPainterPathStroker()

Crée un nouvel « stroker ».

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

Crée un nouveau « stroker » basé sur pen.

[noexcept] QPainterPathStroker::~QPainterPathStroker()

Il détruit le « stroker ».

Qt::PenCapStyle QPainterPathStroker::capStyle() const

Renvoie le style de lettrage des contours générés.

Voir aussi setCapStyle().

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

Génère un nouveau tracé qui est une zone pouvant être remplie, représentant le contour de l'élément path donné.

Les différents aspects graphiques du contour dépendent des propriétés du « stroker » : width(), capStyle(), joinStyle(), dashPattern(), curveThreshold() et miterLimit().

Le tracé généré ne doit être utilisé que pour tracer le contour du tracé de peinture donné. Dans le cas contraire, cela pourrait entraîner un comportement inattendu. Les contours générés nécessitent également la règle « Qt::WindingFill », qui est activée par défaut.

qreal QPainterPathStroker::curveThreshold() const

Renvoie le seuil d'aplatissement de la courbe pour les contours générés.

Voir également setCurveThreshold().

qreal QPainterPathStroker::dashOffset() const

Renvoie le décalage des tirets pour les contours générés.

Voir aussi setDashOffset().

QList<qreal> QPainterPathStroker::dashPattern() const

Renvoie le motif de tirets utilisé pour les contours générés.

Voir aussi setDashPattern().

Qt::PenJoinStyle QPainterPathStroker::joinStyle() const

Renvoie le style de jonction des contours générés.

Voir aussi setJoinStyle().

qreal QPainterPathStroker::miterLimit() const

Renvoie la limite d'onglet pour les contours générés.

Voir aussi ` setMiterLimit()`.

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

Définit le style d'extrémité des contours générés sur style. Si un motif en pointillés est défini, chaque segment du motif est soumis à l'style d'extrémité.

Voir également capStyle().

void QPainterPathStroker::setCurveThreshold(qreal threshold)

Définit l'threshold d'aplatissement de la courbe, qui contrôle la granularité avec laquelle la courbe des contours générés est dessinée.

Le seuil par défaut est une valeur bien ajustée (0,25) et, en règle générale, vous ne devriez pas avoir besoin de le modifier. Cependant, vous pouvez adoucir l'aspect de la courbe en diminuant cette valeur.

Voir également curveThreshold().

void QPainterPathStroker::setDashOffset(qreal offset)

Définit le décalage des tirets pour les contours générés à offset.

Consultez la documentation relative à la fonction QPen::setDashOffset() pour obtenir une description du décalage des tirets.

Voir également la fonction dashOffset().

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

Définit le motif de tirets des contours générés sur « style ».

Voir également dashPattern().

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

Définit le motif de tirets des contours générés sur « dashPattern ». Cette fonction permet de spécifier des motifs de tirets personnalisés.

Chaque élément de la liste contient les longueurs des traits et des espaces du contour, en commençant par le premier trait dans le premier élément, le premier espace dans le deuxième élément, puis en alternant entre traits et espaces pour chaque paire d'éléments suivante.

La liste peut contenir un nombre impair d’éléments ; dans ce cas, le dernier élément sera prolongé de la longueur du premier élément lorsque le motif se répète.

Il s'agit d'une fonction surchargée.

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

Définit le style de jonction des contours générés sur « style ».

Voir également joinStyle().

void QPainterPathStroker::setMiterLimit(qreal limit)

Définit la limite de chanfrein des contours générés à limit.

La limite de chanfrein décrit jusqu'à quelle distance de chaque jonction le chanfrein peut s'étendre. La limite est spécifiée en unités correspondant à la largeur actuellement définie. Ainsi, la limite de chanfrein en pixels sera de miterlimit * width.

Cette valeur n’est utilisée que si le style de jonction est « Qt::MiterJoin ».

Voir également miterLimit().

void QPainterPathStroker::setWidth(qreal width)

Définit la largeur du tracé généré par l'outil « Outline Painter » à width.

Les contours générés s'étendront d'environ 50 % de width de chaque côté du contour d'origine du tracé d'entrée donné.

Voir également width().

qreal QPainterPathStroker::width() const

Renvoie la largeur des contours générés.

Voir aussi setWidth().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.