Auf dieser Seite

QPainterPathStroker Class

Die Klasse „QPainterPathStroker“ dient dazu, aus einem vorgegebenen Malpfad ausfüllbare Konturen zu erzeugen. Mehr...

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

Öffentliche Funktionen

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

Ausführliche Beschreibung

Durch Aufruf der Funktion „ createStroke()“ unter Übergabe eines bestimmten „ QPainterPath “ als Argument wird ein neuer Painter-Pfad erstellt, der den Umriss des angegebenen Pfads darstellt. Der neu erstellte Painter-Pfad kann anschließend gefüllt werden, um den Umriss des ursprünglichen Painter-Pfads zu zeichnen.

Mit den folgenden Funktionen können Sie die verschiedenen Gestaltungsaspekte (Breite, Endpunktstile, Verbindungsstile und Strichmuster) der Konturierung steuern:

Die Funktion ` setDashPattern()` akzeptiert sowohl ein ` Qt::PenStyle `-Objekt als auch eine Listendarstellung des Musters als Argument.

Darüber hinaus können Sie mit der Funktion „ setCurveThreshold()“ den Schwellenwert einer Kurve festlegen und so die Granularität steuern, mit der eine Kurve gezeichnet wird. Der Standardschwellenwert ist ein gut angepasster Wert (0,25), und normalerweise sollten Sie ihn nicht ändern müssen. Sie können das Erscheinungsbild der Kurve jedoch glatter gestalten, indem Sie diesen Wert verringern.

Mit der Funktion ` setMiterLimit()` können Sie außerdem die Gehrungsgrenze für den generierten Umriss steuern. Die Gehrungsgrenze beschreibt, wie weit sich die Gehrungsverbindung von jeder Verbindungsstelle aus erstrecken darf. Die Grenze wird in Breiteeinheiten angegeben, sodass die Gehrungsgrenze in Pixeln ` miterlimit * width` beträgt. Dieser Wert wird nur verwendet, wenn der Verbindungsstil ` Qt::MiterJoin` ist.

Der von der Funktion ` createStroke()` generierte Malpfad sollte ausschließlich zum Umreißen des angegebenen Malpfads verwendet werden. Andernfalls kann dies zu unerwartetem Verhalten führen. Generierte Umrisse erfordern außerdem die Regel ` Qt::WindingFill `, die standardmäßig gesetzt ist.

Siehe auch „ QPen “ und „ QBrush “.

Dokumentation zu den Member-Funktionen

QPainterPathStroker::QPainterPathStroker()

Erstellt einen neuen Stroker.

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

Erstellt einen neuen Stroker auf der Grundlage von pen.

[noexcept] QPainterPathStroker::~QPainterPathStroker()

Zerstört den Stroker.

Qt::PenCapStyle QPainterPathStroker::capStyle() const

Gibt den Großbuchstabenstil der generierten Umrisse zurück.

Siehe auch „ setCapStyle()“.

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

Erzeugt einen neuen Pfad, der einen ausfüllbaren Bereich darstellt, der dem Umriss des angegebenen path entspricht.

Die verschiedenen gestalterischen Aspekte der Kontur basieren auf den Eigenschaften des „Stroker“: „ width “ (), „ capStyle “ (), „ joinStyle “ (), „ dashPattern “ (), „ curveThreshold “ () und „ miterLimit “ ().

Der generierte Pfad sollte ausschließlich zum Umreißen des angegebenen Malerpfads verwendet werden. Andernfalls kann es zu unerwartetem Verhalten kommen. Generierte Umrisse erfordern außerdem die Regel „ Qt::WindingFill “, die standardmäßig gesetzt ist.

qreal QPainterPathStroker::curveThreshold() const

Gibt den Schwellenwert für die Kurvenabflachung der generierten Konturen zurück.

Siehe auch „ setCurveThreshold()“.

qreal QPainterPathStroker::dashOffset() const

Gibt den Strichversatz für die generierten Umrisse zurück.

Siehe auch „ setDashOffset()“.

QList<qreal> QPainterPathStroker::dashPattern() const

Gibt das Strichmuster für die generierten Umrisse zurück.

Siehe auch „ setDashPattern()“.

Qt::PenJoinStyle QPainterPathStroker::joinStyle() const

Gibt den Verbindungsstil der generierten Umrisse zurück.

Siehe auch „ setJoinStyle()“.

qreal QPainterPathStroker::miterLimit() const

Gibt den Gehrungsgrenzwert für die generierten Konturen zurück.

Siehe auch „ setMiterLimit()“.

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

Legt den Endstückstil der erzeugten Konturen auf „ style “ fest. Wenn ein Strichmuster festgelegt ist, wird das Endstück „ style “ auf jedes Segment des Musters angewendet.

Siehe auch „ capStyle()“.

void QPainterPathStroker::setCurveThreshold(qreal threshold)

Legt den Kurvenabflachungs threshold fest, der die Granularität steuert, mit der die Kurve der erzeugten Konturen gezeichnet wird.

Der Standardschwellenwert ist ein gut angepasster Wert (0,25), und normalerweise sollten Sie ihn nicht ändern müssen. Sie können das Erscheinungsbild der Kurve jedoch glätten, indem Sie diesen Wert verringern.

Siehe auch „ curveThreshold()“.

void QPainterPathStroker::setDashOffset(qreal offset)

Legt den Strichversatz für die generierten Umrisse auf „ offset “ fest.

Eine Beschreibung des Strichversatzes finden Sie in der Dokumentation zu ` QPen::setDashOffset()` ().

Siehe auch ` dashOffset()`.

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

Legt das Strichmuster für die generierten Umrisse auf „ style “ fest.

Siehe auch ` dashPattern()`.

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

Legt das Strichmuster für die generierten Umrisse auf „ dashPattern “ fest. Diese Funktion ermöglicht es, benutzerdefinierte Strichmuster festzulegen.

Jedes Element in der Liste enthält die Längen der Striche und Lücken im Strich, beginnend mit dem ersten Strich im ersten Element, der ersten Lücke im zweiten Element und abwechselnd zwischen Strichen und Lücken für jedes folgende Elementpaar.

Die Liste kann eine ungerade Anzahl von Elementen enthalten; in diesem Fall wird das letzte Element bei Wiederholung des Musters um die Länge des ersten Elements verlängert.

Dies ist eine überladene Funktion.

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

Legt den Verbindungsstil der generierten Umrisse auf „ style “ fest.

Siehe auch „ joinStyle()“.

void QPainterPathStroker::setMiterLimit(qreal limit)

Legt die Gehrungsgrenze der generierten Konturen auf „ limit “ fest.

Die Gehrungsbegrenzung beschreibt, wie weit sich die Gehrungsverbindung von jeder Verbindungsstelle aus erstrecken darf. Die Begrenzung wird in Einheiten der aktuell eingestellten Breite angegeben. Die Gehrungsbegrenzung in Pixeln beträgt somit miterlimit * width.

Dieser Wert wird nur verwendet, wenn der Verbindungsstil „ Qt::MiterJoin “ ist.

Siehe auch ` miterLimit()`.

void QPainterPathStroker::setWidth(qreal width)

Legt die Breite des generierten Konturpfads auf width fest.

Die generierten Konturen erstrecken sich zu beiden Seiten der ursprünglichen Kontur des angegebenen Eingabepfads um etwa 50 % von width.

Siehe auch ` width()` .

qreal QPainterPathStroker::width() const

Gibt die Breite der generierten Konturen zurück.

Siehe auch „ 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.