QTransform Class

class Qt3DCore::QTransform

Used to perform transforms on meshes. More...

Header:	#include <QTransform>
CMake:	find_package(Qt6 COMPONENTS 3dcore REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::3dcore)
qmake:	QT += 3dcore
Since:	Qt 5.6
Instantiated By:	Transform
Inherits:	Qt3DCore::QComponent

• List of all members, including inherited members

Properties

matrix : QMatrix4x4 rotation : QQuaternion rotationX : float rotationY : float rotationZ : float

scale : float scale3D : QVector3D translation : QVector3D worldMatrix : const QMatrix4x4

Public Functions

	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

Public Slots

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)

Signals

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)

Static Public Members

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)

Detailed Description

The QTransform component is not shareable between multiple QEntity's. The transformation is held as QVector3D scale, QQuaternion rotation and QVector3D translation components. The transformations are applied to the mesh in that order. When QTransform::matrix property is set, it is decomposed to these transform components and corresponding signals are emitted.

Several helper functions are provided to set up the QTransform; fromAxisAndAngle and fromAxesAndAngles can be used to set the rotation around specific axes, fromEulerAngles can be used to set the rotation based on euler angles and rotateAround can be used to rotate the object around specific point relative to local origin.

Member Function Documentation

QTransform::QTransform(Qt3DCore::QNode *parent = nullptr)

Constructs a new QTransform with parent.

[static invokable, since 5.11] QQuaternion QTransform::fromAxes(const QVector3D &xAxis, const QVector3D &yAxis, const QVector3D &zAxis)

Creates a QQuaterniom definining a rotation from the axes xAxis, yAxis and zAxis.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

This function was introduced in Qt 5.11.

[static invokable] QQuaternion QTransform::fromAxesAndAngles(const QVector3D &axis1, float angle1, const QVector3D &axis2, float angle2)

Creates a QQuaternion from axis1, angle1, axis2, and angle2. Returns the resulting QQuaternion.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

[static invokable] QQuaternion QTransform::fromAxesAndAngles(const QVector3D &axis1, float angle1, const QVector3D &axis2, float angle2, const QVector3D &axis3, float angle3)

Creates a QQuaternion from axis1, angle1, axis2, angle2, axis3, and angle3. Returns the resulting QQuaternion.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

[static invokable] QQuaternion QTransform::fromAxisAndAngle(const QVector3D &axis, float angle)

Creates a QQuaternion from axis and angle. Returns the resulting QQuaternion.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

[static invokable] QQuaternion QTransform::fromAxisAndAngle(float x, float y, float z, float angle)

Creates a QQuaternion from x, y, z, and angle. Returns the resulting QQuaternion.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

[static invokable] QQuaternion QTransform::fromEulerAngles(const QVector3D &eulerAngles)

Creates a QQuaternion from eulerAngles. Returns the resulting QQuaternion.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

[static invokable] QQuaternion QTransform::fromEulerAngles(float pitch, float yaw, float roll)

Creates a QQuaternion from pitch, yaw, and roll. Returns the resulting QQuaternion.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

[static invokable] QMatrix4x4 QTransform::rotateAround(const QVector3D &point, float angle, const QVector3D &axis)

Creates a rotation matrix from axis and angle around point. Returns the resulting QMatrix4x4.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

[static invokable, since 5.11] QMatrix4x4 QTransform::rotateFromAxes(const QVector3D &xAxis, const QVector3D &yAxis, const QVector3D &zAxis)

Returns a rotation matrix defined from the axes xAxis, yAxis, zAxis.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

This function was introduced in Qt 5.11.

[since 5.14] QMatrix4x4 QTransform::worldMatrix() const

Returns the world transformation matrix associated to the QTransform when referenced by a QEntity which may be part of a QEntity hierarchy.

Note: Getter function for property worldMatrix.

This function was introduced in Qt 5.14.