QPainterPathStroker Class
La classe QPainterPathStroker est utilisée pour générer des contours à remplir pour un chemin de peinture donné. Plus d'informations...
| En-tête : | #include <QPainterPathStroker> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
- Liste de tous les membres, y compris les membres hérités
- QPainterPathStroker fait partie des classes de peinture.
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(), en passant un QPainterPath donné comme argument, un nouveau chemin de peintre représentant le contour du chemin donné est créé. Le chemin de peinture nouvellement créé peut ensuite être rempli pour dessiner le contour du chemin de peinture original.
Vous pouvez contrôler les différents aspects de la conception (largeur, styles de capuchon, styles de jointure et motif de tiret) du tracé à l'aide des fonctions suivantes :
La fonction setDashPattern() accepte comme argument un objet Qt::PenStyle et une représentation sous forme de liste du motif.
En outre, vous pouvez spécifier le seuil d'une courbe, en contrôlant la granularité avec laquelle une courbe est dessinée, à l'aide de la fonction setCurveThreshold(). Le seuil par défaut est une valeur bien ajustée (0,25), et vous ne devriez normalement pas avoir besoin de le modifier. Cependant, vous pouvez rendre l'apparence de la courbe plus lisse en diminuant sa valeur.
Vous pouvez également contrôler la limite d'onglet du contour généré à l'aide de la fonction setMiterLimit(). La limite d'onglet décrit la distance à laquelle le joint d'onglet peut s'étendre à partir de chaque joint. La limite est spécifiée en unités de largeur, de sorte que la limite d'onglet par pixel sera miterlimit * width. Cette valeur n'est utilisée que si le style de jointure est Qt::MiterJoin.
Le chemin de peinture généré par la fonction createStroke() ne doit être utilisé que pour délimiter le chemin de peinture donné. Dans le cas contraire, il peut entraîner un comportement inattendu. Les contours générés nécessitent également la règle Qt::WindingFill qui est définie par défaut.
Voir également QPen et QBrush.
Documentation des fonctions membres
QPainterPathStroker::QPainterPathStroker()
Création d'une nouvelle flèche.
[explicit] QPainterPathStroker::QPainterPathStroker(const QPen &pen)
Crée un nouveau stroker basé sur pen.
[noexcept] QPainterPathStroker::~QPainterPathStroker()
Détruit le stroboscope.
Qt::PenCapStyle QPainterPathStroker::capStyle() const
Renvoie le style de chapeau des contours générés.
Voir aussi setCapStyle().
QPainterPath QPainterPathStroker::createStroke(const QPainterPath &path) const
Génère un nouveau chemin qui est une zone remplissable représentant le contour de l'objet donné path.
Les différents aspects de la conception du contour sont basés sur les propriétés du stroboscope : width(), capStyle(), joinStyle(), dashPattern(), curveThreshold() et miterLimit().
Le chemin généré ne doit être utilisé que pour tracer le chemin du peintre donné. Dans le cas contraire, il peut entraîner un comportement inattendu. Les contours générés nécessitent également la règle Qt::WindingFill qui est définie par défaut.
qreal QPainterPathStroker::curveThreshold() const
Renvoie le seuil d'aplatissement des courbes pour les contours générés.
Voir également setCurveThreshold().
qreal QPainterPathStroker::dashOffset() const
Renvoie le décalage du tiret pour les contours générés.
Voir également setDashOffset().
QList<qreal> QPainterPathStroker::dashPattern() const
Renvoie le modèle de tirets pour les contours générés.
Voir également setDashPattern().
Qt::PenJoinStyle QPainterPathStroker::joinStyle() const
Renvoie le style de jointure des contours générés.
Voir également setJoinStyle().
qreal QPainterPathStroker::miterLimit() const
Renvoie la limite d'onglet pour les contours générés.
Voir également setMiterLimit().
void QPainterPathStroker::setCapStyle(Qt::PenCapStyle style)
Définit le style de chapeau des contours générés à style. Si un motif de tirets est défini, chaque segment du motif est soumis au chapeau style.
Voir également capStyle().
void QPainterPathStroker::setCurveThreshold(qreal threshold)
Spécifie l'aplatissement de la courbe threshold, contrôlant 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 il n'est normalement pas nécessaire de le modifier. Cependant, vous pouvez rendre l'apparence de la courbe plus lisse en diminuant sa valeur.
Voir aussi curveThreshold().
void QPainterPathStroker::setDashOffset(qreal offset)
Définit le décalage du tiret pour les contours générés à offset.
Voir la documentation de QPen::setDashOffset() pour une description du décalage du tiret.
Voir également dashOffset().
void QPainterPathStroker::setDashPattern(Qt::PenStyle style)
Définit le modèle de tirets pour les contours générés à style.
Voir aussi dashPattern().
void QPainterPathStroker::setDashPattern(const QList<qreal> &dashPattern)
Définit le modèle de tirets pour les contours générés à dashPattern. Cette fonction permet de spécifier des modèles de tirets personnalisés.
Chaque élément de la liste contient les longueurs des tirets et des espaces du trait, en commençant par le premier tiret du premier élément, le premier espace du deuxième élément et en alternant les tirets et les espaces pour chaque paire d'éléments suivante.
La liste peut contenir un nombre impair d'éléments, auquel 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 jointure des contours générés à style.
Voir aussi joinStyle().
void QPainterPathStroker::setMiterLimit(qreal limit)
Fixe la limite d'onglet des contours générés à limit.
La limite d'onglet décrit la distance à laquelle le joint d'onglet peut s'étendre à partir de chaque joint. La limite est spécifiée en unités de la largeur actuellement définie. Ainsi, la limite d'onglet par pixel sera de miterlimit * width.
Cette valeur n'est utilisée que si le style de jointure est Qt::MiterJoin.
Voir également miterLimit().
void QPainterPathStroker::setWidth(qreal width)
Définit la largeur du chemin de peinture de contour généré à width.
Les contours générés s'étendront approximativement à 50 % de width de chaque côté du contour original du chemin 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.