QTransform Class

Documentation des fonctions membres

QTransform::QTransform()

Construit une matrice d'identité.

Tous les éléments sont mis à zéro sauf m11 et m22 (spécifiant l'échelle) et m33 qui sont mis à 1.

Voir aussi reset().

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

Construit une matrice avec les éléments m11, m12, m21, m22, dx et dy.

Voir aussi setMatrix().

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

Construit une matrice avec les éléments m11, m12, m13, m21, m22, m23, m31, m32, m33.

Voir également setMatrix().

qreal QTransform::m11() const

Renvoie le facteur d'échelle horizontale.

Voir aussi scale() et Basic Matrix Operations.

qreal QTransform::m12() const

Renvoie le facteur de cisaillement vertical.

Voir aussi shear() et Basic Matrix Operations.

qreal QTransform::m13() const

Renvoie le facteur de projection horizontale.

Voir aussi translate() et Basic Matrix Operations.

qreal QTransform::m21() const

Renvoie le facteur de cisaillement horizontal.

Voir aussi shear() et Basic Matrix Operations.

qreal QTransform::m22() const

Renvoie le facteur d'échelle verticale.

Voir aussi scale() et Basic Matrix Operations.

qreal QTransform::m23() const

Renvoie le facteur de projection verticale.

Voir aussi translate() et Basic Matrix Operations.

qreal QTransform::m31() const

Renvoie le facteur de translation horizontale.

Voir aussi dx(), translate(), et Basic Matrix Operations.

qreal QTransform::m32() const

Renvoie le facteur de translation verticale.

Voir aussi dy(), translate(), et Basic Matrix Operations.

qreal QTransform::m33() const

Renvoie le facteur de division.

Voir aussi 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 aussi m31(), translate(), et Basic Matrix Operations.

qreal QTransform::dy() const

Renvoie le facteur de translation verticale.

Voir aussi translate() et Basic Matrix Operations.

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

Crée une matrice qui correspond à une mise à l'échelle de sx horizontalement et de sy verticalement. C'est la même chose que QTransform().scale(sx, sy) mais un peu plus rapide.

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

Crée une matrice qui correspond à une translation de dx le long de l'axe x et de dy le long de l'axe y. C'est la même chose que QTransform().translate(dx, dy) mais un peu 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 retournée est la matrice identité. Si invertible est valide (c'est-à-dire différent de 0), sa valeur est fixée à true si la matrice est inversible, sinon elle est fixée à false.

Voir aussi 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 aussi inverted().

bool QTransform::isRotating() const

Renvoie true si la matrice représente une sorte de transformation rotative, sinon renvoie false.

Voir aussi 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 aussi reset().

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

Transpose les coordonnées x et y dans le système de coordonnées défini par cette matrice. Les valeurs résultantes sont placées dans *tx et *ty, respectivement.

Les coordonnées 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'
}

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

Voir aussi 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, 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é, transformé dans le système de coordonnées défini par cette matrice. 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é, mappé 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é, transformé dans le système de coordonnées défini par cette matrice. 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, 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é, transformé dans le système de coordonnées défini par cette matrice. 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é, mappé 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é, mappé dans le système de coordonnées défini par cette matrice.

L'appel à cette méthode peut être assez coûteux si des rotations ou des cisaillements sont utilisés.

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

Transpose les coordonnées x et y dans le système de coordonnées défini par cette matrice. Les valeurs résultantes sont placées dans *tx et *ty, respectivement. 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é, mappé 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 de délimitation. Pour récupérer la région exacte à laquelle correspond le site rectangle, utilisez plutôt la fonction mapToPolygon().

Voir aussi 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é, transformé dans le système de coordonnées défini par cette matrice. 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 QPolygon du rectangle donné rectangle, 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 lorsqu'ils sont transformés (en raison de l'arrondissement des nombres entiers), de sorte que 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 de commodité 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 aussi squareToQuad() et quadToSquare().

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

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

Voir aussi squareToQuad() et quadToQuad().

void QTransform::reset()

Réinitialise la matrice à une matrice d'identité, c'est-à-dire que tous les éléments sont mis à zéro, à l'exception de m11 et m22 (spécifiant l'échelle) et 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 inverse des aiguilles d'une montre de l'angle donné a autour du point spécifié axis à la distance distanceToPlane de l'écran et renvoie une référence à la matrice.

Notez que si vous appliquez un QTransform à un point défini en coordonnées widget, la direction de la rotation sera dans le sens des aiguilles d'une montre car l'axe y pointe vers le bas.

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

Si distanceToPlane est égal à zéro, il sera ignoré. Cette fonction 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 aussi 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 de l'angle donné a autour du point spécifié axis à une distance de 1024,0 de l'écran et renvoie une référence à la matrice.

Notez que si vous appliquez un QTransform à un point défini en coordonnées widget, la direction de la rotation sera dans le sens des aiguilles d'une montre car l'axe y pointe 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 inverse des aiguilles d'une montre de l'angle donné a autour du point spécifié axis à la distance distanceToPlane de l'écran et renvoie une référence à la matrice.

Notez que si vous appliquez un QTransform à un point défini en coordonnées widget, la direction de la rotation sera dans le sens des aiguilles d'une montre car l'axe y pointe vers le bas.

L'angle est spécifié en radians.

Si distanceToPlane est égal à zéro, il sera ignoré. Cette fonction 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 aussi setMatrix().

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

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

Notez que si vous appliquez un QTransform à un point défini en coordonnées widget, la direction de la rotation sera dans le sens des aiguilles d'une montre car l'axe y pointe vers le bas.

L'angle est spécifié en radians.

Voir également setMatrix().

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

Met à l'échelle le système de coordonnées par sx horizontalement et sy verticalement, et renvoie une référence à la matrice.

Voir aussi 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 de commodité 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)

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

Voir aussi setMatrix().

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

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

Voir aussi quadToSquare() et quadToQuad().

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

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

Voir aussi setMatrix().

QTransform QTransform::transposed() const

Renvoie la transposition de cette matrice.

QTransform::TransformationType QTransform::type() const

Renvoie le type de transformation de cette matrice.

Le type de transformation est la valeur d'énumération la plus élevée capturant toutes les transformations de la matrice. Par exemple, si la matrice est à la fois échelonnée et cisaillée, le type serait TxShear, car TxShear a une valeur d'énumération plus élevée que TxScale.

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

QTransform::operator QVariant() const

Retourne la transformation sous forme de QVariant.

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

Renvoie true si cette matrice n'est pas égale à la matrice donnée matrix, sinon renvoie false.

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

Renvoie le résultat de la multiplication de cette matrice par la valeur donnée matrix.

Notez que la multiplication des matrices 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 la valeur donnée matrix.

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

Renvoie le résultat de la multiplication par éléments de cette matrice avec la valeur donnée scalar.

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

Renvoie la matrice obtenue en ajoutant la valeur scalar à chaque élément de cette matrice.

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

Renvoie la matrice obtenue en soustrayant l'adresse scalar 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 la valeur donnée scalar.

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

Affecte les valeurs de matrix à cette matrice.

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

Renvoie true si cette matrice est égale à la matrice donnée matrix, sinon renvoie false.