En esta página

QGraphicsTransform Class

La clase `QGraphicsTransform` es una clase base abstracta que permite crear transformaciones avanzadas en elementos `QGraphicsItem`. Más información...

Encabezado: #include <QGraphicsTransform>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QObject
Heredado por:

QGraphicsRotation y QGraphicsScale

Funciones públicas

QGraphicsTransform(QObject *parent = nullptr)
virtual ~QGraphicsTransform()
virtual void applyTo(QMatrix4x4 *matrix) const = 0

Ranuras protegidas

void update()

Descripción detallada

Como alternativa a ` QGraphicsItem::transform`, `QGraphicsTransform` permite crear y controlar transformaciones avanzadas que se pueden configurar de forma independiente mediante propiedades especializadas.

QGraphicsItem permite asignar cualquier número de instancias de `QGraphicsTransform` a un ` QGraphicsItem`. Cada `QGraphicsTransform` se aplica en orden, de uno en uno, a la ` QGraphicsItem ` a la que está asignado.

QGraphicsTransform resulta especialmente útil para las animaciones. Mientras que QGraphicsItem::setTransform() permite asignar cualquier transformación directamente a un elemento, no existe una forma directa de interpolar entre dos transformaciones diferentes (por ejemplo, al realizar una transición entre dos estados, cada uno de los cuales tiene asignada al elemento una transformación arbitraria diferente). Mediante QGraphicsTransform se pueden interpolar los valores de las propiedades de cada transformación independiente. La operación resultante se combina entonces en una única transformación que se aplica a QGraphicsItem.

Las transformaciones se calculan en un espacio 3D real utilizando QMatrix4x4. Cuando la transformación se aplica a un QGraphicsItem, se proyecta de nuevo a un QTransform en 2D. Cuando se aplican varios objetos `QGraphicsTransform` a un ` QGraphicsItem`, todas las transformaciones se calculan en un espacio 3D real, y la proyección de vuelta a 2D solo se produce después de aplicar el último `QGraphicsTransform`. La excepción a esto es ` QGraphicsRotation`, que se proyecta de vuelta a 2D después de cada rotación para conservar el efecto de perspectiva alrededor de los ejes X e Y.

Si deseas crear tu propia transformación configurable, puedes crear una subclase de `QGraphicsTransform` (o de cualquiera de las subclases existentes) y reimplementar la función virtual pura ` applyTo()`, que toma un puntero a un ` QMatrix4x4`. Cada operación que desee aplicar debe exponerse como propiedades (por ejemplo, customTransform->setVerticalShear(2.5)). Dentro de su reimplementación de applyTo(), puede modificar la transformación proporcionada según corresponda.

QGraphicsTransform se puede utilizar junto con QGraphicsItem::setTransform(), QGraphicsItem::setRotation() y QGraphicsItem::setScale().

Véase también QGraphicsItem::transform(), QGraphicsScale y QGraphicsRotation.

Documentación de funciones de miembro

QGraphicsTransform::QGraphicsTransform(QObject *parent = nullptr)

Crea un nuevo objeto `QGraphicsTransform` con el ` parent` indicado.

[virtual noexcept] QGraphicsTransform::~QGraphicsTransform()

Elimina la transformación gráfica.

[pure virtual] void QGraphicsTransform::applyTo(QMatrix4x4 *matrix) const

Este método virtual puro debe reimplementarse en las clases derivadas.

Aplica esta transformación a matrix.

Véanse también QGraphicsItem::transform() y QMatrix4x4::toTransform().

[protected slot] void QGraphicsTransform::update()

Indica que esta operación de transformación ha modificado sus parámetros de tal forma que applyTo() devolverá un resultado diferente al anterior.

Al implementar tu propia transformación gráfica personalizada, debes llamar a esta función cada vez que modifiques un parámetro, para indicar a QGraphicsItem que es necesario actualizar su transformación.

Véase también applyTo().

© 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.