QPainterPathStroker Class

Dokumentation der Mitgliedsfunktionen

QPainterPathStroker::QPainterPathStroker()

Erzeugt einen neuen Stroker.

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

Erstellt einen neuen Stroker auf Basis von pen.

[noexcept] QPainterPathStroker::~QPainterPathStroker()

Zerstört den Stroker.

Qt::PenCapStyle QPainterPathStroker::capStyle() const

Gibt den Kappenstil der erzeugten Umrisse zurück.

Siehe auch setCapStyle().

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

Erzeugt einen neuen Pfad, der einen füllbaren Bereich darstellt, der den Umriss des angegebenen path repräsentiert.

Die verschiedenen Designaspekte des Umrisses basieren auf den Eigenschaften des Strokers: width(), capStyle(), joinStyle(), dashPattern(), curveThreshold() und miterLimit().

Der generierte Pfad sollte nur für die Konturierung des angegebenen Malerpfads verwendet werden. Andernfalls kann es zu unerwartetem Verhalten kommen. Generierte Umrisse erfordern auch die Regel Qt::WindingFill, die standardmäßig eingestellt ist.

qreal QPainterPathStroker::curveThreshold() const

Gibt den Schwellenwert für die Abflachung der Kurve für die erzeugten Umrisse zurück.

Siehe auch setCurveThreshold().

qreal QPainterPathStroker::dashOffset() const

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

Siehe auch setDashOffset().

QList<qreal> QPainterPathStroker::dashPattern() const

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

Siehe auch setDashPattern().

Qt::PenJoinStyle QPainterPathStroker::joinStyle() const

Gibt den Verknüpfungsstil der erzeugten Umrisse zurück.

Siehe auch setJoinStyle().

qreal QPainterPathStroker::miterLimit() const

Gibt die Gehrungsgrenze für die erzeugten Umrisse zurück.

Siehe auch setMiterLimit().

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

Setzt den Kappenstil der erzeugten Umrisse auf style. Wenn ein Strichmuster gesetzt ist, unterliegt jedes Segment des Musters der Kappe style.

Siehe auch capStyle().

void QPainterPathStroker::setCurveThreshold(qreal threshold)

Legt die Kurvenabflachung threshold fest, die die Granularität steuert, mit der die Kurve der erzeugten Umrisse gezeichnet wird.

Der Standardschwellenwert ist ein gut eingestellter Wert (0,25), den Sie normalerweise nicht ändern müssen. Sie können jedoch das Aussehen der Kurve glatter gestalten, indem Sie den Wert verringern.

Siehe auch curveThreshold().

void QPainterPathStroker::setDashOffset(qreal offset)

Setzt den Strichversatz für die erzeugten Umrisse auf offset.

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

Siehe auch dashOffset().

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

Setzt das Strichmuster für die erzeugten Umrisse auf style.

Siehe auch dashPattern().

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

Dies ist eine überladene Funktion.

Legt das Strichmuster für die erzeugten Umrisse auf dashPattern fest. Diese Funktion ermöglicht es, eigene Strichmuster anzugeben.

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

Die Liste kann eine ungerade Anzahl von Elementen enthalten. In diesem Fall wird das letzte Element um die Länge des ersten Elements verlängert, wenn das Muster wiederholt wird.

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

Setzt den Verbindungsstil der erzeugten Umrisse auf style.

Siehe auch joinStyle().

void QPainterPathStroker::setMiterLimit(qreal limit)

Setzt die Gehrungsgrenze der erzeugten Umrisse auf limit.

Die Gehrungsgrenze beschreibt, wie weit sich die Gehrungsverbindung von jeder Verbindung ausdehnen kann. Das Limit wird in Einheiten der aktuell eingestellten Breite angegeben. Die pixelweise Gehrungsgrenze ist also miterlimit * width.

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

Siehe auch miterLimit().

void QPainterPathStroker::setWidth(qreal width)

Setzt die Breite des generierten Umrisspfades auf width.

Die generierten Umrisse erstrecken sich etwa 50 % von width zu jeder Seite des ursprünglichen Umrisses des angegebenen Eingabepfads.

Siehe auch width().

qreal QPainterPathStroker::width() const

Gibt die Breite der erzeugten Umrisse zurück.

Siehe auch setWidth().