QTransform Class

Dokumentation zu Member-Funktionen

QTransform::QTransform()

Erstellt eine Identitätsmatrix.

Alle Elemente werden auf Null gesetzt, mit Ausnahme von m11 und m22 (die den Maßstab festlegen) sowie m33, die auf 1 gesetzt werden.

Siehe auch reset().

QTransform::QTransform(qreal m11, qreal m12, qreal m21, qreal m22, qreal dx, qreal dy)

Erstellt eine Matrix mit den Elementen m11, m12, m21, m22, dx und dy.

Siehe auch setMatrix().

QTransform::QTransform(qreal m11, qreal m12, qreal m13, qreal m21, qreal m22, qreal m23, qreal m31, qreal m32, qreal m33)

Erstellt eine Matrix mit den Elementen m11, m12, m13, m21, m22, m23, m31, m32, m33.

Siehe auch setMatrix().

[constexpr noexcept default] QTransform::QTransform(const QTransform &other)

Erstellt eine Instanz von „ QTransform “ durch Kopieren.

[constexpr noexcept default] QTransform::QTransform(QTransform &&other)

Erstellt eine Instanz von „ QTransform “ mithilfe von „Move“.

qreal QTransform::m11() const

Gibt den horizontalen Skalierungsfaktor zurück.

Siehe auch scale() und Basic Matrix Operations.

qreal QTransform::m12() const

Gibt den vertikalen Scherfaktor zurück.

Siehe auch shear() und Basic Matrix Operations.

qreal QTransform::m13() const

Gibt den horizontalen Projektionsfaktor zurück.

Siehe auch translate() und Basic Matrix Operations.

qreal QTransform::m21() const

Gibt den horizontalen Scherfaktor zurück.

Siehe auch shear() und Basic Matrix Operations.

qreal QTransform::m22() const

Gibt den vertikalen Skalierungsfaktor zurück.

Siehe auch scale() und Basic Matrix Operations.

qreal QTransform::m23() const

Gibt den vertikalen Projektionsfaktor zurück.

Siehe auch translate() und Basic Matrix Operations.

qreal QTransform::m31() const

Gibt den Faktor für die horizontale Verschiebung zurück.

Siehe auch dx(), translate() und Basic Matrix Operations.

qreal QTransform::m32() const

Gibt den vertikalen Verschiebungsfaktor zurück.

Siehe auch dy(), translate() und Basic Matrix Operations.

qreal QTransform::m33() const

Gibt den Divisionsfaktor zurück.

Siehe auch translate() und Basic Matrix Operations.

QTransform QTransform::adjoint() const

Gibt den Adjunkten dieser Matrix zurück.

qreal QTransform::determinant() const

Gibt die Determinante der Matrix zurück.

qreal QTransform::dx() const

Gibt den Faktor für die horizontale Verschiebung zurück.

Siehe auch m31(), translate() und Basic Matrix Operations.

qreal QTransform::dy() const

Gibt den vertikalen Verschiebungsfaktor zurück.

Siehe auch translate() und Basic Matrix Operations.

[static] QTransform QTransform::fromScale(qreal sx, qreal sy)

Erzeugt eine Matrix, die einer Skalierung von sx in horizontaler Richtung und sy in vertikaler Richtung entspricht. Dies entspricht der Funktion QTransform().scale(sx, sy), ist jedoch etwas schneller.

[static] QTransform QTransform::fromTranslate(qreal dx, qreal dy)

Erzeugt eine Matrix, die einer Verschiebung von dx entlang der x-Achse und dy entlang der y-Achse entspricht. Dies entspricht der Funktion QTransform().translate(dx, dy), ist jedoch etwas schneller.

QTransform QTransform::inverted(bool *invertible = nullptr) const

Gibt eine invertierte Kopie dieser Matrix zurück.

Ist die Matrix singulär (nicht invertierbar), ist die zurückgegebene Matrix die Einheitsmatrix. Ist ` invertible ` gültig (d. h. ungleich 0), wird sein Wert auf `true` gesetzt, wenn die Matrix invertierbar ist, andernfalls auf `false`.

Siehe auch ` isInvertible()`.

bool QTransform::isAffine() const

Gibt „ true “ zurück, wenn die Matrix eine affine Transformation darstellt; andernfalls wird „ false “ zurückgegeben.

bool QTransform::isIdentity() const

Gibt „ true “ zurück, wenn es sich bei der Matrix um die Einheitsmatrix handelt, andernfalls „ false “.

Siehe auch reset().

bool QTransform::isInvertible() const

Gibt „ true “ zurück, wenn die Matrix invertierbar ist, andernfalls „ false “.

Siehe auch inverted().

bool QTransform::isRotating() const

Gibt „ true “ zurück, wenn die Matrix eine Rotationstransformation darstellt, andernfalls „ false “.

Siehe auch reset().

bool QTransform::isScaling() const

Gibt „ true “ zurück, wenn die Matrix eine Skalierungstransformation darstellt, andernfalls „ false “.

Siehe auch reset().

bool QTransform::isTranslating() const

Gibt „ true “ zurück, wenn die Matrix eine Translationstransformation darstellt, andernfalls „ false “.

Siehe auch reset().

void QTransform::map(qreal x, qreal y, qreal *tx, qreal *ty) const

Ordnet die angegebenen Koordinaten x und y dem durch diese Matrix definierten Koordinatensystem zu. Die resultierenden Werte werden jeweils in *tx und *ty gespeichert.

Die Koordinaten werden anhand der folgenden Formeln transformiert:

x' = m11*x + m21*y + dx
y' = m22*y + m12*x + dy
if (!isAffine()) {
    w' = m13*x + m23*y + m33
    x' /= w'
    y' /= w'
}

Der Punkt (x, y) ist der ursprüngliche Punkt, und (x', y') ist der transformierte Punkt.

Siehe auch Basic Matrix Operations.

QLine QTransform::map(const QLine &l) const

Erzeugt und gibt ein „ QLineF “-Objekt zurück, das eine Kopie der angegebenen Linie „ l “ darstellt, die in das durch diese Matrix definierte Koordinatensystem abgebildet wurde.

QLineF QTransform::map(const QLineF &line) const

Erzeugt und gibt ein ` QLine `-Objekt zurück, das eine Kopie des angegebenen ` line` darstellt, abgebildet auf das durch diese Matrix definierte Koordinatensystem. Beachten Sie, dass die transformierten Koordinaten auf die nächste ganze Zahl gerundet werden.

QPainterPath QTransform::map(const QPainterPath &path) const

Erzeugt und gibt ein „ QPainterPath “-Objekt zurück, das eine Kopie des angegebenen „ path “ darstellt und in das durch diese Matrix definierte Koordinatensystem abgebildet ist.

QPoint QTransform::map(const QPoint &point) const

Erzeugt und gibt ein ` QPoint `-Objekt zurück, das eine Kopie des angegebenen ` point` darstellt, abgebildet auf das durch diese Matrix definierte Koordinatensystem. Beachten Sie, dass die transformierten Koordinaten auf die nächste ganze Zahl gerundet werden.

QPointF QTransform::map(const QPointF &p) const

Erzeugt und gibt ein ` QPointF `-Objekt zurück, das eine Kopie des angegebenen Punktes ` p` darstellt, der in das durch diese Matrix definierte Koordinatensystem abgebildet wurde.

QPolygon QTransform::map(const QPolygon &polygon) const

Erzeugt und gibt ein ` QPolygon `-Objekt zurück, das eine Kopie des angegebenen ` polygon` darstellt, abgebildet auf das durch diese Matrix definierte Koordinatensystem. Beachten Sie, dass die transformierten Koordinaten auf die nächste ganze Zahl gerundet werden.

QPolygonF QTransform::map(const QPolygonF &polygon) const

Erzeugt und gibt ein ` QPolygonF `-Objekt zurück, das eine Kopie des angegebenen ` polygon` darstellt, abgebildet auf das durch diese Matrix definierte Koordinatensystem.

QRegion QTransform::map(const QRegion &region) const

Erstellt und gibt ein „ QRegion “-Objekt zurück, das eine Kopie des angegebenen „ region “ darstellt, abgebildet auf das durch diese Matrix definierte Koordinatensystem.

Der Aufruf dieser Methode kann bei Verwendung von Rotationen oder Scherungen relativ rechenintensiv sein.

void QTransform::map(int x, int y, int *tx, int *ty) const

Ordnet die angegebenen Koordinaten x und y dem durch diese Matrix definierten Koordinatensystem zu. Die resultierenden Werte werden jeweils in *tx und *ty gespeichert. Beachten Sie, dass die transformierten Koordinaten auf die nächste ganze Zahl gerundet werden.

QRectF QTransform::mapRect(const QRectF &rectangle) const

Erzeugt und gibt ein „ QRectF “-Objekt zurück, das eine Kopie des angegebenen „ rectangle “ darstellt und in das durch diese Matrix definierte Koordinatensystem abgebildet wird.

Die Koordinaten des Rechtecks werden anhand der folgenden Formeln transformiert:

x' = m11*x + m21*y + dx
y' = m22*y + m12*x + dy
if (!isAffine()) {
    w' = m13*x + m23*y + m33
    x' /= w'
    y' /= w'
}

Wenn eine Drehung oder Scherung angegeben wurde, gibt diese Funktion das umschließende Rechteck zurück. Um den genauen Bereich abzurufen, auf den das angegebene ` rectangle ` abgebildet wird, verwenden Sie stattdessen die Funktion ` mapToPolygon()`.

Siehe auch „ mapToPolygon()“ und „ Basic Matrix Operations “.

QRect QTransform::mapRect(const QRect &rectangle) const

Erzeugt und gibt ein ` QRect `-Objekt zurück, das eine Kopie des angegebenen ` rectangle` darstellt und in das durch diese Matrix definierte Koordinatensystem abgebildet wird. Beachten Sie, dass die transformierten Koordinaten auf die nächste ganze Zahl gerundet werden.

QPolygon QTransform::mapToPolygon(const QRect &rectangle) const

Erzeugt und gibt eine Darstellung „ QPolygon “ des angegebenen „ rectangle “ zurück, das in das durch diese Matrix definierte Koordinatensystem abgebildet wird.

Die Koordinaten des Rechtecks werden anhand der folgenden Formeln transformiert:

x' = m11*x + m21*y + dx
y' = m22*y + m12*x + dy
if (!isAffine()) {
    w' = m13*x + m23*y + m33
    x' /= w'
    y' /= w'
}

Polygone und Rechtecke verhalten sich bei der Transformation (aufgrund der Rundung auf ganze Zahlen) etwas unterschiedlich, sodass ` matrix.map(QPolygon(rectangle)) ` nicht immer mit ` matrix.mapToPolygon(rectangle)` übereinstimmt.

Siehe auch ` mapRect()` und ` Basic Matrix Operations`.

[static] bool QTransform::quadToQuad(const QPolygonF &one, const QPolygonF &two, QTransform &trans)

Erstellt eine Transformationsmatrix, trans, die ein vierseitiges Polygon, one, auf ein anderes vierseitiges Polygon, two, abbildet. Gibt „ true “ zurück, wenn die Transformation möglich ist; andernfalls wird „false“ zurückgegeben.

Dies ist eine Komfortmethode, die die Methoden „ quadToSquare()“ und „ squareToQuad()“ kombiniert. Sie ermöglicht es, das eingegebene Viereck in ein beliebiges anderes Viereck zu transformieren.

Siehe auch squareToQuad() und quadToSquare().

[static] bool QTransform::quadToSquare(const QPolygonF &quad, QTransform &trans)

Erstellt eine Transformationsmatrix, trans, die ein vierseitiges Polygon, quad, auf ein Einheitsquadrat abbildet. Gibt true zurück, wenn die Transformation konstruiert wurde, oder „false“, wenn eine solche Transformation nicht existiert.

Siehe auch squareToQuad() und quadToQuad().

void QTransform::reset()

Setzt die Matrix auf eine Einheitsmatrix zurück, d. h., alle Elemente werden auf Null gesetzt, mit Ausnahme von m11 und m22 (die den Skalierungsfaktor angeben) sowie m33, die auf 1 gesetzt werden.

Siehe auch QTransform(), isIdentity() und Basic Matrix Operations.

[since 6.5] QTransform &QTransform::rotate(qreal a, Qt::Axis axis, qreal distanceToPlane)

Dreht das Koordinatensystem um den angegebenen Winkel „ a “ gegen den Uhrzeigersinn um den angegebenen Punkt „ axis “ im Abstand „ distanceToPlane “ vom Bildschirm und gibt einen Verweis auf die Matrix zurück.

Beachten Sie: Wenn Sie eine Drehung ` QTransform ` auf einen in Widget-Koordinaten definierten Punkt anwenden, erfolgt die Drehung im Uhrzeigersinn, da die y-Achse nach unten zeigt.

Der Winkel wird in Grad angegeben.

Ist „ distanceToPlane “ gleich Null, wird der Wert ignoriert. Dies eignet sich zur Implementierung orthogonaler Projektionen, bei denen die z-Koordinate verworfen statt projiziert werden soll.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch setMatrix().

QTransform &QTransform::rotate(qreal a, Qt::Axis axis = Qt::ZAxis)

Dreht das Koordinatensystem um den angegebenen Winkel „ a “ gegen den Uhrzeigersinn um den angegebenen Punkt „ axis “ im Abstand von 1024,0 vom Bildschirm und gibt einen Verweis auf die Matrix zurück.

Beachten Sie: Wenn Sie eine Drehung ( QTransform ) auf einen in Widget-Koordinaten definierten Punkt anwenden, erfolgt die Drehung im Uhrzeigersinn, da die y-Achse nach unten zeigt.

Der Winkel wird in Grad angegeben.

Siehe auch „ setMatrix “.

[since 6.5] QTransform &QTransform::rotateRadians(qreal a, Qt::Axis axis, qreal distanceToPlane)

Dreht das Koordinatensystem um den angegebenen Winkel „ a “ gegen den Uhrzeigersinn um den angegebenen Punkt „ axis “ im Abstand „ distanceToPlane “ vom Bildschirm und gibt einen Verweis auf die Matrix zurück.

Beachten Sie: Wenn Sie eine Drehung ` QTransform ` auf einen in Widget-Koordinaten definierten Punkt anwenden, erfolgt die Drehung im Uhrzeigersinn, da die y-Achse nach unten zeigt.

Der Winkel wird in Radianten angegeben.

Ist „ distanceToPlane “ gleich Null, wird der Wert ignoriert. Dies eignet sich zur Implementierung orthogonaler Projektionen, bei denen die z-Koordinate verworfen statt projiziert werden soll.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch ` setMatrix()`.

QTransform &QTransform::rotateRadians(qreal a, Qt::Axis axis = Qt::ZAxis)

Dreht das Koordinatensystem um den angegebenen Winkel „ a “ gegen den Uhrzeigersinn um den angegebenen Punkt „ axis “ im Abstand von 1024,0 zum Bildschirm und gibt einen Verweis auf die Matrix zurück.

Beachten Sie: Wenn Sie eine QTransform auf einen in Widget-Koordinaten definierten Punkt anwenden, erfolgt die Drehung im Uhrzeigersinn, da die y-Achse nach unten zeigt.

Der Winkel wird in Radianten angegeben.

Siehe auch setMatrix().

QTransform &QTransform::scale(qreal sx, qreal sy)

Skaliert das Koordinatensystem horizontal um sx und vertikal um sy und gibt einen Verweis auf die Matrix zurück.

Siehe auch setMatrix().

void QTransform::setMatrix(qreal m11, qreal m12, qreal m13, qreal m21, qreal m22, qreal m23, qreal m31, qreal m32, qreal m33)

Setzt die Matrixelemente auf die angegebenen Werte: m11, m12, m13, m21, m22, m23, m31, m32 und m33. Beachten Sie, dass diese Funktion die bisherigen Werte überschreibt. QTransform stellt die Hilfsfunktionen translate(), rotate(), scale() und shear() zur Verfügung, um die verschiedenen Matrixelemente basierend auf dem aktuell definierten Koordinatensystem zu bearbeiten.

Siehe auch QTransform().

QTransform &QTransform::shear(qreal sh, qreal sv)

Verschiebt das Koordinatensystem horizontal um sh und vertikal um sv und gibt einen Verweis auf die Matrix zurück.

Siehe auch setMatrix().

[static] bool QTransform::squareToQuad(const QPolygonF &quad, QTransform &trans)

Erstellt eine Transformationsmatrix, trans, die ein Einheitsquadrat auf ein vierseitiges Polygon abbildet, quad. Gibt true zurück, wenn die Transformation konstruiert wurde, oder „false“, wenn eine solche Transformation nicht existiert.

Siehe auch quadToSquare() und quadToQuad().

QTransform &QTransform::translate(qreal dx, qreal dy)

Verschiebt das Koordinatensystem um dx entlang der x-Achse und um dy entlang der y-Achse und gibt einen Verweis auf die Matrix zurück.

Siehe auch setMatrix().

QTransform QTransform::transposed() const

Gibt die Transponierte dieser Matrix zurück.

QTransform::TransformationType QTransform::type() const

Gibt den Transformationstyp dieser Matrix zurück.

Der Transformationstyp ist der höchste Enumerationswert, der alle Transformationen der Matrix umfasst. Wenn die Matrix beispielsweise sowohl skaliert als auch verschiebt, wäre der Typ „ TxShear “, da „ TxShear “ einen höheren Enumerationswert hat als „ TxScale “.

Die Kenntnis des Transformationstyps einer Matrix ist für die Optimierung nützlich: Oft lassen sich bestimmte Typen optimaler behandeln als der allgemeine Fall.

QTransform::operator QVariant() const

Gibt die Transformation als ` QVariant` zurück.

bool QTransform::operator!=(const QTransform &matrix) const

Gibt „ true “ zurück, wenn diese Matrix nicht mit der angegebenen „ matrix “ übereinstimmt; andernfalls wird „ false “ zurückgegeben.

QTransform QTransform::operator*(const QTransform &matrix) const

Gibt das Ergebnis der Multiplikation dieser Matrix mit dem angegebenen matrix zurück.

Beachten Sie, dass die Matrixmultiplikation nicht kommutativ ist, d. h. a*b ≠ b*a.

QTransform &QTransform::operator*=(const QTransform &matrix)

Gibt das Ergebnis der Multiplikation dieser Matrix mit dem angegebenen „ matrix “ zurück.

QTransform &QTransform::operator*=(qreal scalar)

Gibt das Ergebnis einer elementweisen Multiplikation dieser Matrix mit dem angegebenen ` scalar` zurück.

QTransform &QTransform::operator+=(qreal scalar)

Gibt die Matrix zurück, die entsteht, wenn zu jedem Element dieser Matrix der angegebene Wert ` scalar ` addiert wird.

QTransform &QTransform::operator-=(qreal scalar)

Gibt die Matrix zurück, die entsteht, wenn von jedem Element dieser Matrix der angegebene Wert ` scalar ` abgezogen wird.

QTransform &QTransform::operator/=(qreal scalar)

Gibt das Ergebnis einer elementweisen Division dieser Matrix durch die angegebene Matrix ` scalar` zurück.

[noexcept default] QTransform &QTransform::operator=(QTransform &&other)

Weist „ other “ dieser „ QTransform “-Instanz zu.

[noexcept default] QTransform &QTransform::operator=(const QTransform &matrix)

Weist dieser Matrix die Werte der angegebenen „ matrix “ zu.

bool QTransform::operator==(const QTransform &matrix) const

Gibt „ true “ zurück, wenn diese Matrix mit der angegebenen „ matrix “ übereinstimmt, andernfalls „ false “.