En esta página

QTransform Class

La clase QTransform define las transformaciones bidimensionales de un sistema de coordenadas. Más información...

Encabezado: #include <QTransform>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Tipos públicos

enum TransformationType { TxNone, TxTranslate, TxScale, TxRotate, TxShear, TxProject }

Funciones públicas

QTransform()
QTransform(qreal m11, qreal m12, qreal m21, qreal m22, qreal dx, qreal dy)
QTransform(qreal m11, qreal m12, qreal m13, qreal m21, qreal m22, qreal m23, qreal m31, qreal m32, qreal m33)
QTransform(const QTransform &other)
QTransform(QTransform &&other)
qreal m11() const
qreal m12() const
qreal m13() const
qreal m21() const
qreal m22() const
qreal m23() const
qreal m31() const
qreal m32() const
qreal m33() const
QTransform adjoint() const
qreal determinant() const
qreal dx() const
qreal dy() const
QTransform inverted(bool *invertible = nullptr) const
bool isAffine() const
bool isIdentity() const
bool isInvertible() const
bool isRotating() const
bool isScaling() const
bool isTranslating() const
void map(qreal x, qreal y, qreal *tx, qreal *ty) const
QLine map(const QLine &l) const
QLineF map(const QLineF &line) const
QPainterPath map(const QPainterPath &path) const
QPoint map(const QPoint &point) const
QPointF map(const QPointF &p) const
QPolygon map(const QPolygon &polygon) const
QPolygonF map(const QPolygonF &polygon) const
QRegion map(const QRegion &region) const
void map(int x, int y, int *tx, int *ty) const
QRectF mapRect(const QRectF &rectangle) const
QRect mapRect(const QRect &rectangle) const
QPolygon mapToPolygon(const QRect &rectangle) const
void reset()
(since 6.5) QTransform &rotate(qreal a, Qt::Axis axis, qreal distanceToPlane)
QTransform &rotate(qreal a, Qt::Axis axis = Qt::ZAxis)
(since 6.5) QTransform &rotateRadians(qreal a, Qt::Axis axis, qreal distanceToPlane)
QTransform &rotateRadians(qreal a, Qt::Axis axis = Qt::ZAxis)
QTransform &scale(qreal sx, qreal sy)
void setMatrix(qreal m11, qreal m12, qreal m13, qreal m21, qreal m22, qreal m23, qreal m31, qreal m32, qreal m33)
QTransform &shear(qreal sh, qreal sv)
QTransform &translate(qreal dx, qreal dy)
QTransform transposed() const
QTransform::TransformationType type() const
operator QVariant() const
bool operator!=(const QTransform &matrix) const
QTransform operator*(const QTransform &matrix) const
QTransform &operator*=(const QTransform &matrix)
QTransform &operator*=(qreal scalar)
QTransform &operator+=(qreal scalar)
QTransform &operator-=(qreal scalar)
QTransform &operator/=(qreal scalar)
QTransform &operator=(QTransform &&other)
QTransform &operator=(const QTransform &matrix)
bool operator==(const QTransform &matrix) const

Miembros públicos estáticos

QTransform fromScale(qreal sx, qreal sy)
QTransform fromTranslate(qreal dx, qreal dy)
bool quadToQuad(const QPolygonF &one, const QPolygonF &two, QTransform &trans)
bool quadToSquare(const QPolygonF &quad, QTransform &trans)
bool squareToQuad(const QPolygonF &quad, QTransform &trans)
bool qFuzzyCompare(const QTransform &t1, const QTransform &t2)
size_t qHash(const QTransform &key, size_t seed = 0)
QLine operator*(const QLine &line, const QTransform &matrix)
QLineF operator*(const QLineF &line, const QTransform &matrix)
QPainterPath operator*(const QPainterPath &path, const QTransform &matrix)
QPoint operator*(const QPoint &point, const QTransform &matrix)
QPointF operator*(const QPointF &point, const QTransform &matrix)
QPolygon operator*(const QPolygon &polygon, const QTransform &matrix)
QPolygonF operator*(const QPolygonF &polygon, const QTransform &matrix)
QRegion operator*(const QRegion &region, const QTransform &matrix)
QDataStream &operator<<(QDataStream &stream, const QTransform &matrix)
QDataStream &operator>>(QDataStream &stream, QTransform &matrix)

Descripción detallada

Una transformación especifica cómo trasladar, escalar, sesgar, rotar o proyectar el sistema de coordenadas, y se utiliza habitualmente al renderizar gráficos.

Se puede crear un objeto `QTransform` utilizando las funciones ` setMatrix()`, ` scale()`, ` rotate()`, ` translate()` y ` shear()`. Alternativamente, se puede crear aplicando ` basic matrix operations`. La matriz también se puede definir en el momento de la construcción, y se puede restablecer a la matriz identidad (el valor por defecto) utilizando la función ` reset()`.

La clase `QTransform` admite la transformación de primitivas gráficas: un punto, una línea, un polígono, una región o una ruta de dibujo dados pueden transformarse al sistema de coordenadas definido por esta matriz mediante la función ` map()`. En el caso de un rectángulo, sus coordenadas pueden transformarse mediante la función ` mapRect()`. Un rectángulo también puede transformarse en un polígono (asignado al sistema de coordenadas definido por esta matriz) mediante la función mapToPolygon().

QTransform proporciona la función isIdentity(), que devuelve true si la matriz es la matriz identidad, y la función isInvertible(), que devuelve true si la matriz es no singular (es decir, AB = BA = I). La función ` inverted()` devuelve una copia invertida de esta matriz si es invertible (en caso contrario, devuelve la matriz identidad), y ` adjoint()` devuelve la adjunta clásica de la matriz. Además, QTransform proporciona la función ` determinant()`, que devuelve el determinante de la matriz.

Por último, la clase QTransform admite la multiplicación, la suma y la resta de matrices, y los objetos de la clase pueden transmitirse en flujo y compararse.

Representación de gráficos

Al renderizar gráficos, la matriz define las transformaciones, pero la transformación real la llevan a cabo las rutinas de dibujo de QPainter.

Por defecto, ` QPainter ` opera en el propio sistema de coordenadas del dispositivo asociado. El sistema de coordenadas estándar de un ` QPaintDevice ` tiene su origen situado en la posición superior izquierda. Los valores de x aumentan hacia la derecha; los valores de y aumentan hacia abajo. Para obtener una descripción completa, consulta la documentación sobre el sistema de coordenadas.

QPainter dispone de funciones para desplazar, escalar, inclinar y rotar el sistema de coordenadas sin utilizar un QTransform. Por ejemplo:

Texto girado 45 grados
void SimpleTransformation::paintEvent(QPaintEvent *)
{
    QPainter painter(this);
    painter.setPen(QPen(Qt::blue, 1, Qt::DashLine));
    painter.drawRect(0, 0, 100, 100);

    painter.rotate(45);

    painter.setFont(QFont("Helvetica", 24));
    painter.setPen(QPen(Qt::black, 1));
    painter.drawText(20, 10, "QTransform");
}

Aunque estas funciones son muy prácticas, puede resultar más eficiente crear un QTransform y llamar a QPainter::setTransform() si se desea realizar más de una operación de transformación. Por ejemplo:

Texto escalado, girado y desplazado
void CombinedTransformation::paintEvent(QPaintEvent *)
{
    QPainter painter(this);
    painter.setPen(QPen(Qt::blue, 1, Qt::DashLine));
    painter.drawRect(0, 0, 100, 100);

    QTransform transform;
    transform.translate(50, 50);
    transform.rotate(45);
    transform.scale(0.5, 1.0);
    painter.setTransform(transform);

    painter.setFont(QFont("Helvetica", 24));
    painter.setPen(QPen(Qt::black, 1));
    painter.drawText(20, 10, "QTransform");
}

Operaciones básicas con matrices

Ilustración que muestra un objeto que contiene una matriz de 3x3 en la que cada fila es un elemento diferente

Un objeto QTransform contiene una matriz de 3 × 3. Los elementos m31 (dx) y m32 (dy) especifican la traslación horizontal y vertical. Los elementos m11 y m22 especifican el escalado horizontal y vertical. Los elementos m21 y m12 especifican el sesgado horizontal y vertical. Y, por último, los elementos m13 y m23 especifican la proyección horizontal y vertical, con m33 como factor de proyección adicional.

QTransform transforma un punto del plano en otro punto utilizando las siguientes fórmulas:

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

El punto (x, y) es el punto original, y (x', y') es el punto transformado. (x', y') puede transformarse de nuevo en (x, y) realizando la misma operación sobre la matriz inverted().

Los distintos elementos de la matriz se pueden establecer al construirla o utilizando posteriormente la función setMatrix(). También se pueden manipular mediante las funciones de conveniencia translate(), rotate(), scale() y shear(). Los valores establecidos actualmente se pueden recuperar mediante las funciones m11(), m12(), m13(), m21(), m22(), m23(), m31(), m32(), m33(), dx() y dy().

La traslación es la transformación más sencilla. Al establecer dx y dy, el sistema de coordenadas se desplazará dx unidades a lo largo del eje X y dy unidades a lo largo del eje Y. El escalado se puede realizar estableciendo m11 y m22. Por ejemplo, al establecer m11 en 2 y m22 en 1,5, se duplicará la altura y se aumentará la anchura en un 50 %. La matriz de identidad tiene m11, m22 y m33 establecidos en 1 (todos los demás se establecen en 0), lo que mapea un punto sobre sí mismo. El desplazamiento se controla mediante m12 y m21. Establecer estos elementos en valores distintos de cero distorsionará el sistema de coordenadas. La rotación se consigue ajustando tanto los factores de desplazamiento como los de escala. La transformación en perspectiva se consigue ajustando tanto los factores de proyección como los factores de escala.

Combinación de transformaciones

A continuación se muestra un ejemplo de transformaciones combinadas utilizando operaciones matriciales básicas:

Texto con transformación matricial combinada
void BasicOperations::paintEvent(QPaintEvent *)
{
    const double a = qDegreesToRadians(45.0);
    double sina = sin(a);
    double cosa = cos(a);

    QTransform scale(0.5, 0, 0, 1.0, 0, 0);
    QTransform rotate(cosa, sina, -sina, cosa, 0, 0);
    QTransform translate(1, 0, 0, 1, 50.0, 50.0);

    QTransform transform = scale * rotate * translate;

    QPainter painter(this);
    painter.setPen(QPen(Qt::blue, 1, Qt::DashLine));
    painter.drawRect(0, 0, 100, 100);

    painter.setTransform(transform);

    painter.setFont(QFont("Helvetica", 24));
    painter.setPen(QPen(Qt::black, 1));
    painter.drawText(20, 10, "QTransform");
}

La transformación combinada primero escala cada operando, luego lo gira y, por último, lo traslada, tal y como se escribe el producto de sus factores. Esto significa que el punto al que se aplican las transformaciones se multiplica implícitamente por la izquierda con la transformación situada a su derecha.

Relación con la notación matricial

La notación matricial en QTransform es la transpuesta de una convención que se enseña habitualmente y que representa las transformaciones y los puntos como matrices y vectores. Esa convención multiplica la matriz situada a la izquierda por el vector de columnas situado a la derecha. En otras palabras, cuando se aplican varias transformaciones a un punto, la matriz situada más a la derecha actúa directamente sobre el vector en primer lugar. A continuación, la siguiente matriz a la izquierda actúa sobre el resultado de la primera operación, y así sucesivamente. Como resultado, esa convención multiplica las matrices que componen una transformación compuesta en el orden inverso al de QTransform, tal y como se puede ver en Combining Transforms. Al transponer las matrices y combinarlas a la derecha de un vector de fila que representa el punto, las matrices de las transformaciones aparecen, en su producto, en el orden en el que concebimos que se aplican las transformaciones al punto.

Véase también QPainter, «Sistema de coordenadas», «Ejemplo de transformaciones afines» y «Ejemplo de transformaciones».

Documentación sobre tipos de miembros

enum QTransform::TransformationType

ConstanteValor
QTransform::TxNone0x00
QTransform::TxTranslate0x01
QTransform::TxScale0x02
QTransform::TxRotate0x04
QTransform::TxShear0x08
QTransform::TxProject0x10

Documentación de funciones de miembro

QTransform::QTransform()

Crea una matriz identidad.

Todos los elementos se establecen en cero, excepto m11 y m22 (que especifican la escala) y m33, que se establecen en 1.

Véase también reset().

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

Crea una matriz con los elementos: m11, m12, m21, m22, dx y dy.

Véase también setMatrix().

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

Crea una matriz con los elementos: m11, m12, m13, m21, m22, m23, m31, m32, m33.

Véase también setMatrix().

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

Crea una instancia de ` QTransform` mediante copia.

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

Crea una instancia de ` QTransform` mediante el operador `move`.

qreal QTransform::m11() const

Devuelve el factor de escala horizontal.

Véase también scale() y Basic Matrix Operations.

qreal QTransform::m12() const

Devuelve el factor de deformación vertical.

Véase también shear() y Basic Matrix Operations.

qreal QTransform::m13() const

Devuelve el factor de proyección horizontal.

Véase también translate() y Basic Matrix Operations.

qreal QTransform::m21() const

Devuelve el factor de deformación horizontal.

Véase también shear() y Basic Matrix Operations.

qreal QTransform::m22() const

Devuelve el factor de escala vertical.

Véase también scale() y Basic Matrix Operations.

qreal QTransform::m23() const

Devuelve el factor de proyección vertical.

Véase también translate() y Basic Matrix Operations.

qreal QTransform::m31() const

Devuelve el factor de traslación horizontal.

Véase también dx(), translate() y Basic Matrix Operations.

qreal QTransform::m32() const

Devuelve el factor de traslación vertical.

Véase también dy(), translate() y Basic Matrix Operations.

qreal QTransform::m33() const

Devuelve el factor de división.

Véase también translate() y Basic Matrix Operations.

QTransform QTransform::adjoint() const

Devuelve la adjunta de esta matriz.

qreal QTransform::determinant() const

Devuelve el determinante de la matriz.

qreal QTransform::dx() const

Devuelve el factor de traslación horizontal.

Véase también m31(), translate() y Basic Matrix Operations.

qreal QTransform::dy() const

Devuelve el factor de traslación vertical.

Véase también translate() y Basic Matrix Operations.

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

Crea una matriz que corresponde a una escala de sx en horizontal y sy en vertical. Es lo mismo que QTransform().scale(sx, sy), pero ligeramente más rápido.

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

Crea una matriz que corresponde a una traslación de dx a lo largo del eje x y dy a lo largo del eje y. Es lo mismo que QTransform().translate(dx, dy), pero ligeramente más rápido.

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

Devuelve una copia invertida de esta matriz.

Si la matriz es singular (no invertible), la matriz devuelta es la matriz identidad. Si invertible es válido (es decir, no es 0), su valor se establece en «true» si la matriz es invertible; en caso contrario, se establece en «false».

Véase también isInvertible().

bool QTransform::isAffine() const

Devuelve ` true ` si la matriz representa una transformación afín; en caso contrario, devuelve ` false`.

bool QTransform::isIdentity() const

Devuelve ` true ` si la matriz es la matriz identidad; en caso contrario, devuelve ` false`.

Véase también reset().

bool QTransform::isInvertible() const

Devuelve ` true ` si la matriz es invertible; en caso contrario, devuelve ` false`.

Véase también inverted().

bool QTransform::isRotating() const

Devuelve « true » si la matriz representa algún tipo de transformación de rotación; en caso contrario, devuelve « false ».

Nota: Una transformación de rotación de 180 grados y/o 360 grados se considera una transformación de escalado.

Véase también reset().

bool QTransform::isScaling() const

Devuelve ` true ` si la matriz representa una transformación de escalado; en caso contrario, devuelve ` false`.

Véase también reset().

bool QTransform::isTranslating() const

Devuelve ` true ` si la matriz representa una transformación de traslación; en caso contrario, devuelve ` false`.

Véase también reset().

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

Mapea las coordenadas dadas x y y al sistema de coordenadas definido por esta matriz. Los valores resultantes se almacenan en *tx y *ty, respectivamente.

Las coordenadas se transforman utilizando las siguientes fórmulas:

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

El punto (x, y) es el punto original, y (x', y') es el punto transformado.

Véase también Basic Matrix Operations.

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

Crea y devuelve un objeto ` QLineF ` que es una copia de la línea dada, ` l`, proyectada en el sistema de coordenadas definido por esta matriz.

Esta es una función sobrecargada.

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

Crea y devuelve un objeto ` QLine ` que es una copia del objeto ` line` proporcionado, transformado al sistema de coordenadas definido por esta matriz. Ten en cuenta que las coordenadas transformadas se redondean al entero más cercano.

Esta es una función sobrecargada.

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

Crea y devuelve un objeto ` QPainterPath ` que es una copia del objeto ` path` dado, proyectado en el sistema de coordenadas definido por esta matriz.

Esta es una función sobrecargada.

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

Crea y devuelve un objeto ` QPoint ` que es una copia del objeto ` point` dado, transformado al sistema de coordenadas definido por esta matriz. Ten en cuenta que las coordenadas transformadas se redondean al entero más cercano.

Esta es una función sobrecargada.

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

Crea y devuelve un objeto ` QPointF ` que es una copia del punto dado, ` p`, proyectado en el sistema de coordenadas definido por esta matriz.

Esta es una función sobrecargada.

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

Crea y devuelve un objeto ` QPolygon ` que es una copia del objeto ` polygon` dado, transformado al sistema de coordenadas definido por esta matriz. Ten en cuenta que las coordenadas transformadas se redondean al entero más cercano.

Esta es una función sobrecargada.

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

Crea y devuelve un objeto ` QPolygonF ` que es una copia del objeto ` polygon` proporcionado, transformado al sistema de coordenadas definido por esta matriz.

Esta es una función sobrecargada.

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

Crea y devuelve un objeto ` QRegion ` que es una copia del objeto ` region` proporcionado, proyectado en el sistema de coordenadas definido por esta matriz.

La llamada a este método puede resultar bastante costosa si se utilizan rotaciones o deformaciones.

Se trata de una función sobrecargada.

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

Asigna las coordenadas dadas x y y al sistema de coordenadas definido por esta matriz. Los valores resultantes se almacenan en *tx y *ty, respectivamente. Ten en cuenta que las coordenadas transformadas se redondean al entero más cercano.

Esta es una función sobrecargada.

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

Crea y devuelve un objeto ` QRectF ` que es una copia del objeto ` rectangle` dado, proyectado en el sistema de coordenadas definido por esta matriz.

Las coordenadas del rectángulo se transforman utilizando las siguientes fórmulas:

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 se ha especificado una rotación o un sesgo, esta función devuelve el rectángulo delimitador. Para obtener la región exacta a la que se mapea el objeto ` rectangle ` dado, utilice en su lugar la función ` mapToPolygon()`.

Véase también mapToPolygon() y Basic Matrix Operations.

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

Crea y devuelve un objeto ` QRect ` que es una copia del objeto ` rectangle` dado, mapeado al sistema de coordenadas definido por esta matriz. Ten en cuenta que las coordenadas transformadas se redondean al entero más cercano.

Esta es una función sobrecargada.

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

Crea y devuelve una representación de tipo « QPolygon » del « rectangle » dado, proyectado en el sistema de coordenadas definido por esta matriz.

Las coordenadas del rectángulo se transforman utilizando las siguientes fórmulas:

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

Los polígonos y los rectángulos se comportan de forma ligeramente diferente al transformarse (debido al redondeo de los números enteros), por lo que matrix.map(QPolygon(rectangle)) no siempre es igual a matrix.mapToPolygon(rectangle).

Véase también mapRect() y Basic Matrix Operations.

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

Crea una matriz de transformación, trans, que mapea un polígono de cuatro lados, one, a otro polígono de cuatro lados, two. Devuelve true si la transformación es posible; en caso contrario, devuelve false.

Se trata de un método de conveniencia que combina los métodos quadToSquare() y squareToQuad(). Permite transformar el polígono de cuatro lados de entrada en cualquier otro polígono de cuatro lados.

Véanse también squareToQuad() y quadToSquare().

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

Crea una matriz de transformación, trans, que mapea un polígono de cuatro lados, quad, a un cuadrado unitario. Devuelve true si se construye la transformación o «false» si dicha transformación no existe.

Véanse también squareToQuad() y quadToQuad().

void QTransform::reset()

Restablece la matriz a una matriz identidad, es decir, todos los elementos se establecen en cero, excepto m11 y m22 (que especifican la escala) y m33, que se establecen en 1.

Véanse también QTransform(), isIdentity() y Basic Matrix Operations.

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

Gira el sistema de coordenadas en sentido antihorario en el ángulo indicado a alrededor del punto especificado axis situado a una distancia distanceToPlane de la pantalla y devuelve una referencia a la matriz.

Ten en cuenta que, si aplicas un QTransform a un punto definido en coordenadas del widget, la rotación será en sentido horario, ya que el eje y apunta hacia abajo.

El ángulo se especifica en grados.

Si distanceToPlane es cero, se ignorará. Esto resulta adecuado para implementar proyecciones ortográficas en las que la coordenada z debe omitirse en lugar de proyectarse.

Esta función se introdujo en Qt 6.5.

Véase también setMatrix().

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

Gira el sistema de coordenadas en sentido antihorario en el ángulo indicado a alrededor del punto especificado axis, situado a una distancia de 1024,0 de la pantalla, y devuelve una referencia a la matriz.

Ten en cuenta que, si aplicas un QTransform a un punto definido en coordenadas de widget, la dirección de la rotación será en el sentido de las agujas del reloj, ya que el eje y apunta hacia abajo.

El ángulo se especifica en grados.

Esta es una función sobrecargada.

Véase también setMatrix.

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

Gira el sistema de coordenadas en sentido antihorario en el ángulo indicado a alrededor del punto especificado axis situado a una distancia distanceToPlane de la pantalla y devuelve una referencia a la matriz.

Ten en cuenta que, si aplicas un QTransform a un punto definido en coordenadas de widget, la dirección de la rotación será en el sentido de las agujas del reloj, ya que el eje y apunta hacia abajo.

El ángulo se especifica en radianes.

Si distanceToPlane es cero, se ignorará. Esto resulta adecuado para implementar proyecciones ortográficas en las que la coordenada z debe omitirse en lugar de proyectarse.

Esta función se introdujo en Qt 6.5.

Véase también setMatrix().

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

Gira el sistema de coordenadas en sentido antihorario en el ángulo indicado a alrededor del punto especificado axis, situado a una distancia de 1024,0 de la pantalla, y devuelve una referencia a la matriz.

Ten en cuenta que, si aplicas un QTransform a un punto definido en coordenadas de widget, la dirección de la rotación será en el sentido de las agujas del reloj, ya que el eje y apunta hacia abajo.

El ángulo se especifica en radianes.

Esta es una función sobrecargada.

Véase también setMatrix().

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

Escala el sistema de coordenadas en sx en horizontal y sy en vertical, y devuelve una referencia a la matriz.

Véase también setMatrix().

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

Establece los elementos de la matriz en los valores especificados: m11, m12, m13, m21, m22, m23, m31, m32 y m33. Ten en cuenta que esta función sustituye los valores anteriores. QTransform proporciona las funciones de conveniencia translate(), rotate(), scale() y shear() para manipular los distintos elementos de la matriz en función del sistema de coordenadas definido actualmente.

Véase también QTransform().

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

Transforma el sistema de coordenadas mediante sh en horizontal y sv en vertical, y devuelve una referencia a la matriz.

Véase también setMatrix().

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

Crea una matriz de transformación, trans, que mapea un cuadrado unitario a un polígono de cuatro lados, quad. Devuelve true si se construye la transformación o «false» si dicha transformación no existe.

Véanse también quadToSquare() y quadToQuad().

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

Desplaza el sistema de coordenadas « dx » a lo largo del eje x y « dy » a lo largo del eje y, y devuelve una referencia a la matriz.

Véase también setMatrix().

QTransform QTransform::transposed() const

Devuelve la transpuesta de esta matriz.

QTransform::TransformationType QTransform::type() const

Devuelve el tipo de transformación de esta matriz.

El tipo de transformación es el valor de enumeración más alto que engloba todas las transformaciones de la matriz. Por ejemplo, si la matriz realiza tanto una escala como un sesgo, el tipo sería « TxShear », ya que « TxShear » tiene un valor de enumeración más alto que « TxScale ».

Conocer el tipo de transformación de una matriz resulta útil para la optimización: a menudo se pueden gestionar tipos específicos de forma más óptima que el caso genérico.

QTransform::operator QVariant() const

Devuelve la transformación como un objeto ` QVariant`.

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

Devuelve ` true ` si esta matriz no es igual a la dada ` matrix`; en caso contrario, devuelve ` false`.

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

Devuelve el resultado de multiplicar esta matriz por la matriz dada matrix.

Ten en cuenta que la multiplicación de matrices no es conmutativa, es decir, a*b ≠ b*a.

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

Devuelve el resultado de multiplicar esta matriz por el matrix dado.

Se trata de una función sobrecargada.

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

Devuelve el resultado de realizar una multiplicación elemento por elemento de esta matriz con el scalar dado.

Se trata de una función sobrecargada.

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

Devuelve la matriz obtenida al sumar el valor dado scalar a cada elemento de esta matriz.

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

Devuelve la matriz obtenida al restar el valor dado scalar de cada elemento de esta matriz.

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

Devuelve el resultado de realizar una división elemento a elemento de esta matriz por la matriz dada scalar.

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

Asigna « other » a esta instancia de « QTransform ». .

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

Asigna los valores de la matriz « matrix » a esta matriz.

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

Devuelve ` true ` si esta matriz es igual a la dada ` matrix`; en caso contrario, devuelve ` false`.

Elementos no miembros relacionados

[noexcept] bool qFuzzyCompare(const QTransform &t1, const QTransform &t2)

Devuelve « true » si « t1 » y « t2 » son iguales, teniendo en cuenta un pequeño margen de imprecisión para las comparaciones de números de coma flotante; en caso contrario, devuelve «false».

[noexcept] size_t qHash(const QTransform &key, size_t seed = 0)

Devuelve el valor hash de key, utilizando seed como semilla para el cálculo.

QLine operator*(const QLine &line, const QTransform &matrix)

Esto equivale a ` matrix.map(line)`.

Véase también QTransform::map().

QLineF operator*(const QLineF &line, const QTransform &matrix)

Esto equivale a ` matrix.map(line)`.

Véase también QTransform::map().

QPainterPath operator*(const QPainterPath &path, const QTransform &matrix)

Esto equivale a ` matrix.map(path)`.

Véase también QTransform::map().

QPoint operator*(const QPoint &point, const QTransform &matrix)

Esto equivale a ` matrix.map(point)`.

Véase también QTransform::map().

QPointF operator*(const QPointF &point, const QTransform &matrix)

Es lo mismo que matrix.map(point).

Véase también QTransform::map().

QPolygon operator*(const QPolygon &polygon, const QTransform &matrix)

Esto equivale a ` matrix.map(polygon)`.

Véase también QTransform::map().

QPolygonF operator*(const QPolygonF &polygon, const QTransform &matrix)

Esto equivale a ` matrix.map(polygon)`.

Véase también QTransform::map().

QRegion operator*(const QRegion &region, const QTransform &matrix)

Esto equivale a ` matrix.map(region)`.

Véase también QTransform::map().

QDataStream &operator<<(QDataStream &stream, const QTransform &matrix)

Escribe el objeto « matrix » especificado en el objeto « stream » especificado y devuelve una referencia al flujo.

Véase también «Serialización detipos de datos de Qt».

QDataStream &operator>>(QDataStream &stream, QTransform &matrix)

Lee el objeto ` matrix ` especificado a partir del objeto ` stream ` especificado y devuelve una referencia al flujo.

Véase también «Serialización detipos de datos de Qt».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.