QTransform Class

Documentación de la función miembro

QTransform::QTransform()

Construye una matriz de identidad.

Todos los elementos se ponen a cero excepto m11 y m22 (especificando la escala) y m33 que se ponen a 1.

Véase también reset().

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

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

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

Véase también setMatrix().

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 cizalladura 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 cizalladura 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 el adjunto 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 horizontalmente y sy verticalmente. Esto 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. Esto 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 verdadero si la matriz es invertible, de lo contrario se establece en falso.

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.

Véase también reset().

bool QTransform::isScaling() const

Devuelve true si la matriz representa una transformación de escala, 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 en el sistema de coordenadas definido por esta matriz. Los valores resultantes se colocan 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, mapeada en el sistema de coordenadas definido por esta matriz.

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

Crea y devuelve un objeto QLine que es una copia del line dado , mapeado en el sistema de coordenadas definido por esta matriz. Tenga en cuenta que las coordenadas transformadas se redondean al entero más próximo.

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

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

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

Crea y devuelve un objeto QPoint que es una copia del point dado , mapeado en el sistema de coordenadas definido por esta matriz. Tenga en cuenta que las coordenadas transformadas se redondean al entero más próximo.

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

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

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

Crea y devuelve un objeto QPolygon que es una copia del polygon dado , mapeado en el sistema de coordenadas definido por esta matriz. Tenga en cuenta que las coordenadas transformadas se redondean al entero más próximo.

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

Crea y devuelve un objeto QPolygonF que es una copia del polygon dado, mapeado en el sistema de coordenadas definido por esta matriz.

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

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

Llamar a este método puede ser bastante caro si se utilizan rotaciones o cizallamientos.

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

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

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

Crea y devuelve un objeto QRectF que es una copia del rectangle dado, mapeado 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 rotación o cizalladura, esta función devuelve el rectángulo delimitador. Para obtener la región exacta a la que se refiere rectangle, utilice 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 rectangle dado , mapeado en el sistema de coordenadas definido por esta matriz. Tenga en cuenta que las coordenadas transformadas se redondean al entero más próximo.

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

Crea y devuelve una representación QPolygon del rectangle dado, mapeado 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 cuando se transforman (debido al redondeo de enteros), por lo que matrix.map(QPolygon(rectangle)) no siempre es lo mismo que 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.

Este método combina los métodos quadToSquare() y squareToQuad(). Permite transformar el cuadrado de entrada en cualquier otro cuadrado.

Véase 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 la transformación está construida o false si tal transformación no existe.

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

void QTransform::reset()

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

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

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

Rota el sistema de coordenadas en el sentido contrario a las agujas del reloj el ángulo dado a alrededor del punto especificado axis a la distancia distanceToPlane de la pantalla y devuelve una referencia a la matriz.

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

El ángulo se especifica en grados.

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

Esta función se introdujo en Qt 6.5.

Véase también setMatrix().

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

Rota el sistema de coordenadas en el sentido contrario a las agujas del reloj en el ángulo dado a alrededor del axis especificado a una distancia de 1024.0 de la pantalla y devuelve una referencia a la matriz.

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

El ángulo se especifica en grados.

Véase también setMatrix.

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

Rota el sistema de coordenadas en el sentido contrario a las agujas del reloj el ángulo dado a alrededor del punto especificado axis a la distancia distanceToPlane de la pantalla y devuelve una referencia a la matriz.

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

El ángulo se especifica en radianes.

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

Esta función se introdujo en Qt 6.5.

Véase también setMatrix().

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

Rota el sistema de coordenadas en el sentido contrario a las agujas del reloj en el ángulo dado a alrededor del axis especificado a una distancia de 1024.0 de la pantalla y devuelve una referencia a la matriz.

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

El ángulo se especifica en radianes.

Véase también setMatrix().

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

Escala el sistema de coordenadas en sx horizontalmente y sy verticalmente, 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 a los valores especificados, m11, m12, m13 m21 , m22, m23 m31 , m32 y m33. Observe que esta función sustituye a los valores anteriores. QTransform proporciona las funciones de conveniencia translate(), rotate(), scale() y shear() para manipular los distintos elementos de la matriz basándose en el sistema de coordenadas definido actualmente.

Véase también QTransform().

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

Corta el sistema de coordenadas en sh horizontalmente y sv verticalmente, 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 asigna un cuadrado unitario a un polígono de cuatro lados, quad. Devuelve true si la transformación está construida o false si tal transformación no existe.

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

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

Mueve 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 transposición 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 captura todas las transformaciones de la matriz. Por ejemplo, si la matriz escala y cizalla, el tipo sería TxShear, porque TxShear tiene un valor de enumeración mayor que TxScale.

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

QTransform::operator QVariant() const

Devuelve la transformación como 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 dada matrix.

Tenga 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 matrix.

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

Devuelve el resultado de realizar una multiplicación por elementos de esta matriz con la dirección scalar.

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

Devuelve la matriz obtenida añadiendo el scalar dado a cada elemento de esta matriz.

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

Devuelve la matriz obtenida restando el scalar dado 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 dirección scalar.

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

Asigna los valores de 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.