Qt3DCore::QTransform Class
class Qt3DCore::QTransformSe utiliza para aplicar transformaciones a las mallas. Más información...
| Encabezado: | #include <QTransform> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3DCore) target_link_libraries(mytarget PRIVATE Qt6::3DCore) |
| qmake: | QT += 3dcore |
| En QML: | Transform |
| Heredan de: | Qt3DCore::QComponent |
| Estado: | Obsoleto |
Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.
Propiedades
|
Funciones públicas
| QTransform(Qt3DCore::QNode *parent = nullptr) | |
| QMatrix4x4 | matrix() const |
| QQuaternion | rotation() const |
| float | rotationX() const |
| float | rotationY() const |
| float | rotationZ() const |
| float | scale() const |
| QVector3D | scale3D() const |
| QVector3D | translation() const |
| QMatrix4x4 | worldMatrix() const |
Ranuras públicas
| void | setMatrix(const QMatrix4x4 &matrix) |
| void | setRotation(const QQuaternion &rotation) |
| void | setRotationX(float rotationX) |
| void | setRotationY(float rotationY) |
| void | setRotationZ(float rotationZ) |
| void | setScale(float scale) |
| void | setScale3D(const QVector3D &scale) |
| void | setTranslation(const QVector3D &translation) |
Señales
| void | matrixChanged() |
| void | rotationChanged(const QQuaternion &rotation) |
| void | rotationXChanged(float rotationX) |
| void | rotationYChanged(float rotationY) |
| void | rotationZChanged(float rotationZ) |
| void | scale3DChanged(const QVector3D &scale) |
| void | scaleChanged(float scale) |
| void | translationChanged(const QVector3D &translation) |
| void | worldMatrixChanged(const QMatrix4x4 &worldMatrix) |
Miembros públicos estáticos
| QQuaternion | fromAxes(const QVector3D &xAxis, const QVector3D &yAxis, const QVector3D &zAxis) |
| QQuaternion | fromAxesAndAngles(const QVector3D &axis1, float angle1, const QVector3D &axis2, float angle2) |
| QQuaternion | fromAxesAndAngles(const QVector3D &axis1, float angle1, const QVector3D &axis2, float angle2, const QVector3D &axis3, float angle3) |
| QQuaternion | fromAxisAndAngle(const QVector3D &axis, float angle) |
| QQuaternion | fromAxisAndAngle(float x, float y, float z, float angle) |
| QQuaternion | fromEulerAngles(const QVector3D &eulerAngles) |
| QQuaternion | fromEulerAngles(float pitch, float yaw, float roll) |
| QMatrix4x4 | rotateAround(const QVector3D &point, float angle, const QVector3D &axis) |
| QMatrix4x4 | rotateFromAxes(const QVector3D &xAxis, const QVector3D &yAxis, const QVector3D &zAxis) |
Descripción detallada
El componente QTransform no se puede compartir entre varios « QEntity ». La transformación se almacena como componentes de escal QVector3D, rotación QQuaternion y traslación QVector3D. Las transformaciones se aplican a la malla en ese orden. Cuando se establece una propied QTransform::matrix, esta se descompone en estos componentes de transformación y se emiten las señales correspondientes.
Se proporcionan varias funciones auxiliares para configurar QTransform; se pueden utilizar fromAxisAndAngle y fromAxesAndAngles para establecer la rotación alrededor de ejes específicos, fromEulerAngles para establecer la rotación basada en ángulos de Euler y rotateAround para rotar el objeto alrededor de un punto específico relativo al origen local.
Documentación de propiedades
matrix : QMatrix4x4
Contiene la matriz de transformación ( QMatrix4x4 ) de la transformación.
Nota: Cuando se establece la propiedad «matrix», esta se descompone en componentes de traslación, rotación y escala.
Funciones de acceso:
| QMatrix4x4 | matrix() const |
| void | setMatrix(const QMatrix4x4 &matrix) |
Señal de notificación:
| void | matrixChanged() |
rotation : QQuaternion
Almacena la rotación de la transformación como « QQuaternion ».
Funciones de acceso:
| QQuaternion | rotation() const |
| void | setRotation(const QQuaternion &rotation) |
Señal de notificación:
| void | rotationChanged(const QQuaternion &rotation) |
rotationX : float
Almacena la rotación en el eje x de la transformación como ángulo de Euler.
Funciones de acceso:
| float | rotationX() const |
| void | setRotationX(float rotationX) |
Señal de notificación:
| void | rotationXChanged(float rotationX) |
rotationY : float
Almacena la rotación «y» de la transformación como ángulo de Euler.
Funciones de acceso:
| float | rotationY() const |
| void | setRotationY(float rotationY) |
Señal de notificación:
| void | rotationYChanged(float rotationY) |
rotationZ : float
Almacena la rotación en el eje z de la transformación como ángulo de Euler.
Funciones de acceso:
| float | rotationZ() const |
| void | setRotationZ(float rotationZ) |
Señal de notificación:
| void | rotationZChanged(float rotationZ) |
scale : float
Almacena la escala uniforme de la transformación. Si la escala se ha establecido mediante ` setScale3D`, solo almacena el valor x.
Funciones de acceso:
| float | scale() const |
| void | setScale(float scale) |
Señal de notificación:
| void | scaleChanged(float scale) |
scale3D : QVector3D
Almacena la escala de la transformación como « QVector3D ».
Funciones de acceso:
| QVector3D | scale3D() const |
| void | setScale3D(const QVector3D &scale) |
Señal de notificación:
| void | scale3DChanged(const QVector3D &scale) |
translation : QVector3D
Almacena la traducción de la transformación como ` QVector3D`.
Funciones de acceso:
| QVector3D | translation() const |
| void | setTranslation(const QVector3D &translation) |
Señal de notificación:
| void | translationChanged(const QVector3D &translation) |
[read-only] worldMatrix : QMatrix4x4
Almacena la matriz de transformación del mundo para la transformación. Esto supone que una QEntity hace referencia al componente « QTransform ». De este modo, resulta más sencillo identificar cuándo una QEntity que forma parte de un subárbol se ha transformado en el mundo, aunque su transformación local no haya cambiado.
Funciones de acceso:
| QMatrix4x4 | worldMatrix() const |
Señal del notificador:
| void | worldMatrixChanged(const QMatrix4x4 &worldMatrix) |
Documentación de las funciones de miembro
[explicit] QTransform::QTransform(Qt3DCore::QNode *parent = nullptr)
Crea un nuevo QTransform con ` parent`.
[static invokable] QQuaternion QTransform::fromAxes(const QVector3D &xAxis, const QVector3D &yAxis, const QVector3D &zAxis)
Crea un QQuaterniom que define una rotación a partir de los ejes xAxis, yAxis y zAxis.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[static invokable] QQuaternion QTransform::fromAxesAndAngles(const QVector3D &axis1, float angle1, const QVector3D &axis2, float angle2)
Crea un objeto « QQuaternion » a partir de « axis1 », « », « angle1 », « axis2 » y « angle2 ». Devuelve el objeto « QQuaternion » resultante.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[static invokable] QQuaternion QTransform::fromAxesAndAngles(const QVector3D &axis1, float angle1, const QVector3D &axis2, float angle2, const QVector3D &axis3, float angle3)
Crea un objeto ` QQuaternion ` a partir de ` axis1`, ` angle1`, ` axis2`, ` angle2`, ` axis3` y ` angle3`. Devuelve el objeto resultante ` QQuaternion`.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[static invokable] QQuaternion QTransform::fromAxisAndAngle(const QVector3D &axis, float angle)
Crea un objeto ` QQuaternion ` a partir de ` axis ` y ` angle`. Devuelve el objeto resultante ` QQuaternion`.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[static invokable] QQuaternion QTransform::fromAxisAndAngle(float x, float y, float z, float angle)
Crea un ` QQuaternion ` a partir de ` x`, ` y`, ` z` y ` angle`. Devuelve el ` QQuaternion` resultante.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[static invokable] QQuaternion QTransform::fromEulerAngles(const QVector3D &eulerAngles)
Crea un ` QQuaternion ` a partir de ` eulerAngles`. Devuelve el ` QQuaternion` resultante.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[static invokable] QQuaternion QTransform::fromEulerAngles(float pitch, float yaw, float roll)
Crea un objeto « QQuaternion » a partir de « pitch », « yaw » y « roll ». Devuelve el objeto resultante « QQuaternion ».
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[static invokable] QMatrix4x4 QTransform::rotateAround(const QVector3D &point, float angle, const QVector3D &axis)
Crea una matriz de rotación a partir de axis y angle alrededor de point. Devuelve la matriz resultante QMatrix4x4.
Nota: Esta función se puede invocar a través del sistema de metaoobjetos y desde QML. Véase Q_INVOKABLE.
[static invokable] QMatrix4x4 QTransform::rotateFromAxes(const QVector3D &xAxis, const QVector3D &yAxis, const QVector3D &zAxis)
Devuelve una matriz de rotación definida a partir de los ejes xAxis, yAxis, zAxis.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
QMatrix4x4 QTransform::worldMatrix() const
Devuelve la matriz de transformación del mundo asociada a la ` QTransform ` cuando a ella hace referencia una `QEntity` que puede formar parte de una jerarquía de `QEntity`.
Nota: Funcióngetter para la propiedad worldMatrix.
© 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.