QTransform Class

Documentation sur les fonctions membres

QTransform::QTransform()

Crée une matrice identité.

Tous les éléments sont mis à zéro, à l'exception de m11 et m22 (qui spécifient l'échelle) ainsi que m33, qui sont mis à 1.

Voir également reset().

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

Crée une matrice dont les éléments sont : m11, m12, m21, m22, dx et dy.

Voir également setMatrix().

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

Crée une matrice dont les éléments sont : m11, m12, m13, m21, m22, m23, m31, m32, m33.

Voir également setMatrix().

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

Crée une instance d'QTransform par copie.

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

Crée par « move » une instance de ` QTransform`.

qreal QTransform::m11() const

Renvoie le facteur d'échelle horizontal.

Voir également scale() et Basic Matrix Operations.

qreal QTransform::m12() const

Renvoie le facteur de cisaillement vertical.

Voir également shear() et Basic Matrix Operations.

qreal QTransform::m13() const

Renvoie le facteur de projection horizontale.

Voir également translate() et Basic Matrix Operations.

qreal QTransform::m21() const

Renvoie le facteur de cisaillement horizontal.

Voir également shear() et Basic Matrix Operations.

qreal QTransform::m22() const

Renvoie le facteur d'échelle vertical.

Voir également scale() et Basic Matrix Operations.

qreal QTransform::m23() const

Renvoie le facteur de projection verticale.

Voir également translate() et Basic Matrix Operations.

qreal QTransform::m31() const

Renvoie le facteur de translation horizontale.

Voir également dx(), translate() et Basic Matrix Operations.

qreal QTransform::m32() const

Renvoie le facteur de translation verticale.

Voir également dy(), translate() et Basic Matrix Operations.

qreal QTransform::m33() const

Renvoie le facteur de division.

Voir également translate() et Basic Matrix Operations.

QTransform QTransform::adjoint() const

Renvoie l'adjoint de cette matrice.

qreal QTransform::determinant() const

Renvoie le déterminant de la matrice.

qreal QTransform::dx() const

Renvoie le facteur de translation horizontale.

Voir également m31(), translate() et Basic Matrix Operations.

qreal QTransform::dy() const

Renvoie le facteur de translation verticale.

Voir également translate() et Basic Matrix Operations.

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

Crée une matrice correspondant à une mise à l'échelle de sx à l'horizontale et de sy à la verticale. Cette fonction est identique à QTransform().scale(sx, sy), mais légèrement plus rapide.

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

Crée une matrice correspondant à une translation de dx le long de l'axe x et de dy le long de l'axe y. Cette fonction est identique à QTransform().translate(dx, dy), mais légèrement plus rapide.

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

Renvoie une copie inversée de cette matrice.

Si la matrice est singulière (non inversible), la matrice renvoyée est la matrice identité. Si invertible est valide (c'est-à-dire différent de 0), sa valeur est définie sur true si la matrice est inversible, sinon elle est définie sur false.

Voir également isInvertible().

bool QTransform::isAffine() const

Renvoie « true » si la matrice représente une transformation affine ; sinon, renvoie « false ».

bool QTransform::isIdentity() const

Renvoie « true » si la matrice est la matrice identité ; sinon, renvoie « false ».

Voir aussi reset().

bool QTransform::isInvertible() const

Renvoie ` true ` si la matrice est inversible, sinon renvoie ` false`.

Voir également inverted().

bool QTransform::isRotating() const

Renvoie « true » si la matrice représente une transformation de rotation, sinon renvoie « false ».

Voir également reset().

bool QTransform::isScaling() const

Renvoie ` true ` si la matrice représente une transformation d'échelle, sinon renvoie ` false`.

Voir également reset().

bool QTransform::isTranslating() const

Renvoie « true » si la matrice représente une transformation de translation ; sinon, renvoie « false ».

Voir également reset().

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

Convertit les coordonnées données x et y dans le système de coordonnées défini par cette matrice. Les valeurs obtenues sont stockées respectivement dans *tx et *ty.

La transformation des coordonnées s'effectue à l'aide des formules suivantes :

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

Le point (x, y) est le point d'origine, et (x', y') est le point transformé.

Voir également Basic Matrix Operations.

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

Crée et renvoie un objet ` QLineF ` qui est une copie de la ligne donnée, ` l`, transposée dans le système de coordonnées défini par cette matrice.

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

Crée et renvoie un objet ` QLine ` qui est une copie de l'objet ` line` donné, transposé dans le système de coordonnées défini par cette matrice. Notez que les coordonnées transformées sont arrondies à l'entier le plus proche.

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

Crée et renvoie un objet ` QPainterPath ` qui est une copie de l'objet ` path` donné, transposé dans le système de coordonnées défini par cette matrice.

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

Crée et renvoie un objet ` QPoint ` qui est une copie de l'objet ` point` donné, transposé dans le système de coordonnées défini par cette matrice. Notez que les coordonnées transformées sont arrondies à l'entier le plus proche.

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

Crée et renvoie un objet ` QPointF ` qui est une copie du point donné, ` p`, transposé dans le système de coordonnées défini par cette matrice.

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

Crée et renvoie un objet ` QPolygon ` qui est une copie de l'objet ` polygon` donné, transposé dans le système de coordonnées défini par cette matrice. Notez que les coordonnées transformées sont arrondies à l'entier le plus proche.

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

Crée et renvoie un objet ` QPolygonF ` qui est une copie de l'objet ` polygon` donné, transposé dans le système de coordonnées défini par cette matrice.

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

Crée et renvoie un objet ` QRegion ` qui est une copie de l'objet ` region` donné, transposé dans le système de coordonnées défini par cette matrice.

L'appel de cette méthode peut s'avérer assez coûteux si des rotations ou des cisaillements sont utilisés.

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

Convertit les coordonnées données x et y dans le système de coordonnées défini par cette matrice. Les valeurs obtenues sont stockées respectivement dans *tx et *ty. Notez que les coordonnées transformées sont arrondies à l'entier le plus proche.

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

Crée et renvoie un objet ` QRectF ` qui est une copie de l'objet ` rectangle` donné, transposé dans le système de coordonnées défini par cette matrice.

Les coordonnées du rectangle sont transformées à l’aide des formules suivantes :

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

Si une rotation ou un cisaillement a été spécifié, cette fonction renvoie le rectangle englobant. Pour récupérer la région exacte à laquelle correspond l’objet ` rectangle ` donné, utilisez plutôt la fonction ` mapToPolygon()`.

Voir également mapToPolygon() et Basic Matrix Operations.

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

Crée et renvoie un objet ` QRect ` qui est une copie de l'objet ` rectangle` donné, transposé dans le système de coordonnées défini par cette matrice. Notez que les coordonnées transformées sont arrondies à l'entier le plus proche.

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

Crée et renvoie une représentation de type « QPolygon » de l'rectangle donné, projetée dans le système de coordonnées défini par cette matrice.

Les coordonnées du rectangle sont transformées à l'aide des formules suivantes :

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

Les polygones et les rectangles se comportent légèrement différemment lors de la transformation (en raison de l'arrondi des nombres entiers) ; par conséquent, ` matrix.map(QPolygon(rectangle)) ` n'est pas toujours identique à ` matrix.mapToPolygon(rectangle)`.

Voir également mapRect() et Basic Matrix Operations.

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

Crée une matrice de transformation, trans, qui fait correspondre un polygone à quatre côtés, one, à un autre polygone à quatre côtés, two. Renvoie true si la transformation est possible ; sinon, renvoie false.

Il s'agit d'une méthode pratique combinant les méthodes quadToSquare() et squareToQuad(). Elle permet de transformer le quadrilatère d'entrée en n'importe quel autre quadrilatère.

Voir également squareToQuad() et quadToSquare().

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

Crée une matrice de transformation, trans, qui transforme un polygone à quatre côtés, quad, en un carré unitaire. Renvoie true si la transformation est construite, ou false si une telle transformation n'existe pas.

Voir également squareToQuad() et quadToQuad().

void QTransform::reset()

Réinitialise la matrice en matrice identité, c'est-à-dire que tous les éléments sont mis à zéro, à l'exception de m11 et m22 (qui définissent l'échelle) ainsi que m33, qui sont mis à 1.

Voir également QTransform(), isIdentity() et Basic Matrix Operations.

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

Fait pivoter le système de coordonnées dans le sens antihoraire d'un angle donné a autour de l'axis e spécifiée, située à une distance distanceToPlane de l'écran, et renvoie une référence à la matrice.

Notez que si vous appliquez une QTransform à un point défini dans les coordonnées du widget, le sens de la rotation sera dans le sens des aiguilles d’une montre, car l’axe y est orienté vers le bas.

L'angle est spécifié en degrés.

Si l'distanceToPlane est nulle, elle sera ignorée. Cela convient à la mise en œuvre de projections orthographiques où la coordonnée z doit être supprimée plutôt que projetée.

Cette fonction a été introduite dans Qt 6.5.

Voir également setMatrix().

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

Fait pivoter le système de coordonnées dans le sens inverse des aiguilles d'une montre selon l'angle donné a autour du point spécifié axis situé à une distance de 1024,0 de l'écran, et renvoie une référence à la matrice.

Notez que si vous appliquez une rotation ( QTransform ) à un point défini dans les coordonnées du widget, la rotation s’effectuera dans le sens des aiguilles d’une montre, car l’axe y est orienté vers le bas.

L'angle est spécifié en degrés.

Voir également setMatrix.

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

Fait pivoter le système de coordonnées dans le sens antihoraire selon l'angle a autour du point axis situé à une distance distanceToPlane de l'écran, et renvoie une référence à la matrice.

Notez que si vous appliquez un QTransform à un point défini dans les coordonnées du widget, le sens de rotation sera dans le sens des aiguilles d’une montre, car l’axe y est orienté vers le bas.

L'angle est spécifié en radians.

Si l'distanceToPlane est nulle, elle sera ignorée. Cela convient à la mise en œuvre de projections orthographiques où la coordonnée z doit être supprimée plutôt que projetée.

Cette fonction a été introduite dans Qt 6.5.

Voir également setMatrix().

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

Fait pivoter le système de coordonnées dans le sens antihoraire selon l'angle a autour du point axis situé à une distance de 1024,0 de l'écran, puis renvoie une référence à la matrice.

Notez que si vous appliquez une QTransform à un point défini dans les coordonnées du widget, le sens de la rotation sera dans le sens des aiguilles d’une montre, car l’axe y est orienté vers le bas.

L'angle est spécifié en radians.

Voir également setMatrix().

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

Mise à l'échelle du système de coordonnées selon sx à l'horizontale et sy à la verticale, puis renvoie une référence à la matrice.

Voir également setMatrix().

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

Définit les éléments de la matrice aux valeurs spécifiées : m11, m12, m13, m21, m22, m23, m31, m32 et m33. Notez que cette fonction remplace les valeurs précédentes. QTransform fournit les fonctions pratiques translate(), rotate(), scale() et shear() pour manipuler les différents éléments de la matrice en fonction du système de coordonnées actuellement défini.

Voir également QTransform().

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

Décale le système de coordonnées horizontalement de sh et verticalement de sv, puis renvoie une référence à la matrice.

Voir également setMatrix().

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

Crée une matrice de transformation, trans, qui transforme un carré unitaire en un polygone à quatre côtés, quad. Renvoie true si la transformation est construite, ou false si une telle transformation n'existe pas.

Voir également quadToSquare() et quadToQuad().

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

Déplace le système de coordonnées de dx le long de l'axe x et de dy le long de l'axe y, puis renvoie une référence à la matrice.

Voir également setMatrix().

QTransform QTransform::transposed() const

Renvoie la transposée de cette matrice.

QTransform::TransformationType QTransform::type() const

Renvoie le type de transformation de cette matrice.

Le type de transformation correspond à la valeur d'énumération la plus élevée englobant toutes les transformations de la matrice. Par exemple, si la matrice effectue à la fois une mise à l'échelle et un cisaillement, le type sera TxShear, car TxShear possède une valeur d'énumération supérieure à TxScale.

Connaître le type de transformation d’une matrice est utile pour l’optimisation : il est souvent possible de traiter certains types spécifiques de manière plus optimale que le cas générique.

QTransform::operator QVariant() const

Renvoie la transformation sous la forme d'un objet ` QVariant`.

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

Renvoie ` true ` si cette matrice n'est pas égale à ` matrix` ; sinon, renvoie ` false`.

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

Renvoie le résultat de la multiplication de cette matrice par l'matrix on fournie.

Notez que la multiplication matricielle n'est pas commutative, c'est-à-dire que a*b ≠ b*a.

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

Renvoie le résultat de la multiplication de cette matrice par l'matrix on fournie.

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

Renvoie le résultat de la multiplication élément par élément de cette matrice par l'scalar on fournie.

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

Renvoie la matrice obtenue en ajoutant l'scalar e donnée à chaque élément de cette matrice.

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

Renvoie la matrice obtenue en soustrayant l'scalar e donnée de chaque élément de cette matrice.

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

Renvoie le résultat de la division élément par élément de cette matrice par l'scalar on fournie.

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

Cette commande attribue la table « other » à cette instance « QTransform ».

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

Attribue à cette matrice les valeurs de l'matrix on indiquée.

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

Renvoie ` true ` si cette matrice est égale à celle fournie ` matrix`, sinon renvoie ` false`.