QTransform Class

Dokumentation der Mitgliedsfunktionen

QTransform::QTransform()

Konstruiert eine Identitätsmatrix.

Alle Elemente werden auf Null gesetzt, außer m11 und m22 (zur Angabe der Skala) und m33, die auf 1 gesetzt werden.

Siehe auch reset().

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

Konstruiert 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)

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

Siehe auch setMatrix().

qreal QTransform::m11() const

Gibt den horizontalen Skalierungsfaktor zurück.

Siehe auch scale() und Basic Matrix Operations.

qreal QTransform::m12() const

Gibt den vertikalen Scherungsfaktor 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 Scherungsfaktor 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 horizontalen Übersetzungsfaktor zurück.

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

qreal QTransform::m32() const

Gibt den vertikalen Übersetzungsfaktor 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 Adjungierten dieser Matrix zurück.

qreal QTransform::determinant() const

Gibt die Determinante der Matrix zurück.

qreal QTransform::dx() const

Gibt den horizontalen Übersetzungsfaktor zurück.

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

qreal QTransform::dy() const

Gibt den vertikalen Translationsfaktor 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 horizontal und sy vertikal entspricht. Dies ist dasselbe wie QTransform().scale(sx, sy), aber 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 ist dasselbe wie QTransform().translate(dx, dy), aber etwas schneller.

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

Gibt eine invertierte Kopie dieser Matrix zurück.

Wenn die Matrix singulär (nicht invertierbar) ist, ist die zurückgegebene Matrix die Identitätsmatrix. Wenn invertible gültig ist (d. h. nicht 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 die Matrix die Identitätsmatrix ist, 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 Art von Drehtransformation 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 translatorische Transformation darstellt, andernfalls false.

Siehe auch reset().

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

Überträgt die angegebenen Koordinaten x und y in das durch diese Matrix definierte Koordinatensystem. Die resultierenden Werte werden in *tx bzw. *ty eingetragen.

Die Koordinaten werden mit Hilfe 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

Dies ist eine überladene Funktion.

Erzeugt und gibt ein QLineF Objekt zurück, das eine Kopie der gegebenen Linie l ist, die auf das durch diese Matrix definierte Koordinatensystem abgebildet wird.

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

Dies ist eine überladene Funktion.

Erzeugt und gibt ein QLine Objekt zurück, das eine Kopie der angegebenen line ist und in das durch diese Matrix definierte Koordinatensystem abgebildet wird. Beachten Sie, dass die transformierten Koordinaten auf die nächste Ganzzahl gerundet werden.

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

Dies ist eine überladene Funktion.

Erzeugt und gibt ein QPainterPath Objekt zurück, das eine Kopie der angegebenen path ist und in das durch diese Matrix definierte Koordinatensystem abgebildet wird.

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

Dies ist eine überladene Funktion.

Erzeugt und gibt ein QPoint Objekt zurück, das eine Kopie der angegebenen point ist und in das durch diese Matrix definierte Koordinatensystem abgebildet wird. Beachten Sie, dass die transformierten Koordinaten auf die nächste Ganzzahl gerundet werden.

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

Dies ist eine überladene Funktion.

Erzeugt und gibt ein QPointF Objekt zurück, das eine Kopie des angegebenen Punktes p ist und in das durch diese Matrix definierte Koordinatensystem abgebildet wird.

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

Dies ist eine überladene Funktion.

Erzeugt und gibt ein QPolygon Objekt zurück, das eine Kopie der angegebenen polygon ist und in das durch diese Matrix definierte Koordinatensystem abgebildet wird. Beachten Sie, dass die transformierten Koordinaten auf die nächste Ganzzahl gerundet werden.

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

Dies ist eine überladene Funktion.

Erstellt ein QPolygonF Objekt, das eine Kopie der angegebenen polygon ist, und gibt es in dem durch diese Matrix definierten Koordinatensystem zurück.

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

Dies ist eine überladene Funktion.

Erzeugt und gibt ein QRegion Objekt zurück, das eine Kopie der angegebenen region ist und in das durch diese Matrix definierte Koordinatensystem abgebildet wird.

Der Aufruf dieser Methode kann ziemlich teuer werden, wenn Rotationen oder Scherungen verwendet werden.

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

Dies ist eine überladene Funktion.

Überträgt die angegebenen Koordinaten x und y in das durch diese Matrix definierte Koordinatensystem. Die resultierenden Werte werden in *tx bzw. *ty eingetragen. Beachten Sie, dass die transformierten Koordinaten auf die nächste Ganzzahl gerundet werden.

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

Erzeugt ein QRectF Objekt, das eine Kopie des angegebenen rectangle ist, und gibt es in das durch diese Matrix definierte Koordinatensystem zurück.

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 begrenzende Rechteck zurück. Um den genauen Bereich zu ermitteln, auf den sich die angegebene rectangle bezieht, verwenden Sie stattdessen die Funktion mapToPolygon().

Siehe auch mapToPolygon() und Basic Matrix Operations.

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

Dies ist eine überladene Funktion.

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

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

Erzeugt und liefert eine QPolygon Darstellung des gegebenen rectangle, die in dem durch diese Matrix definierten 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 leicht unterschiedlich (aufgrund der Rundung ganzer Zahlen), so dass matrix.map(QPolygon(rectangle)) nicht immer mit matrix.mapToPolygon(rectangle) identisch ist.

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 die Umwandlung des Eingabevierecks in ein beliebiges anderes Viereck.

Siehe auch squareToQuad() und quadToSquare().

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

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

Siehe auch squareToQuad() und quadToQuad().

void QTransform::reset()

Setzt die Matrix auf eine Identitätsmatrix zurück, d. h. alle Elemente werden auf Null gesetzt, außer m11 und m22 (Angabe der Skala) und 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 axis im Abstand distanceToPlane vom Bildschirm und gibt einen Verweis auf die Matrix zurück.

Beachten Sie, dass, wenn Sie QTransform auf einen in Widget-Koordinaten definierten Punkt anwenden, die Richtung der Drehung im Uhrzeigersinn ist, da die y-Achse nach unten zeigt.

Der Winkel wird in Grad angegeben.

Wenn distanceToPlane gleich Null ist, wird er ignoriert. Dies eignet sich für die Implementierung orthographischer Projektionen, bei denen die z-Koordinate nicht projiziert, sondern fallen gelassen werden soll.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch setMatrix().

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

Dies ist eine überladene Funktion.

Dreht das Koordinatensystem um den angegebenen Winkel a gegen den Uhrzeigersinn um den angegebenen axis im Abstand 1024.0 vom Bildschirm und gibt eine Referenz auf die Matrix zurück.

Beachten Sie, dass, wenn Sie QTransform auf einen in Widget-Koordinaten definierten Punkt anwenden, die Richtung der Drehung im Uhrzeigersinn sein wird, 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 axis im Abstand distanceToPlane vom Bildschirm und gibt einen Verweis auf die Matrix zurück.

Beachten Sie, dass, wenn Sie QTransform auf einen in Widget-Koordinaten definierten Punkt anwenden, die Richtung der Drehung im Uhrzeigersinn ist, da die y-Achse nach unten zeigt.

Der Winkel wird in Radiant angegeben.

Wenn distanceToPlane gleich Null ist, wird er ignoriert. Dies eignet sich für die Implementierung orthographischer Projektionen, bei denen die z-Koordinate nicht projiziert, sondern fallen gelassen werden soll.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch setMatrix().

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

Dies ist eine überladene Funktion.

Dreht das Koordinatensystem um den angegebenen Winkel a gegen den Uhrzeigersinn um den angegebenen axis im Abstand 1024.0 vom Bildschirm und gibt eine Referenz auf die Matrix zurück.

Beachten Sie, dass, wenn Sie QTransform auf einen in Widget-Koordinaten definierten Punkt anwenden, die Richtung der Drehung im Uhrzeigersinn sein wird, da die y-Achse nach unten zeigt.

Der Winkel wird in Radiant angegeben.

Siehe auch setMatrix().

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

Skaliert das Koordinatensystem um sx horizontal und sy vertikal 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 vorherigen Werte ersetzt. QTransform bietet die Komfortfunktionen translate(), rotate(), scale() und shear(), um die verschiedenen Matrixelemente basierend auf dem aktuell definierten Koordinatensystem zu manipulieren.

Siehe auch QTransform().

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

Schert das Koordinatensystem um sh horizontal und sv vertikal 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, quad, abbildet. Gibt true zurück, wenn die Transformation konstruiert ist, oder false, wenn eine solche Transformation nicht existiert.

Siehe auch quadToSquare() und quadToQuad().

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

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

Siehe auch setMatrix().

QTransform QTransform::transposed() const

Gibt die Transponierung dieser Matrix zurück.

QTransform::TransformationType QTransform::type() const

Gibt den Transformationstyp dieser Matrix zurück.

Der Transformationstyp ist der höchste Aufzählungswert, der alle Transformationen der Matrix erfasst. Wenn die Matrix zum Beispiel sowohl skaliert als auch schert, wäre der Typ TxShear, da TxShear einen höheren Aufzählungswert hat als TxScale.

Die Kenntnis des Transformationstyps einer Matrix ist nützlich für die Optimierung: Sie können bestimmte Typen oft optimaler behandeln als den allgemeinen Fall.

QVariant 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 gleich der angegebenen matrix ist, andernfalls gibt sie false zurück.

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

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

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

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

Dies ist eine überladene Funktion.

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

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

Dies ist eine überladene Funktion.

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

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

Dies ist eine überladene Funktion.

Gibt die Matrix zurück, die durch Addition der angegebenen scalar zu jedem Element dieser Matrix erhalten wird.

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

Dies ist eine überladene Funktion.

Gibt die Matrix zurück, die durch Subtraktion der angegebenen scalar von jedem Element dieser Matrix erhalten wird.

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

Dies ist eine überladene Funktion.

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

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

Weist die Werte der angegebenen matrix dieser Matrix zu.

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

Gibt true zurück, wenn diese Matrix gleich der angegebenen matrix ist, andernfalls gibt sie false zurück.