QTransform

Used to perform transforms on meshes. More

Synopsis

Functions

Slots

Signals

Static functions

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

class PySide2.Qt3DCore.QTransform([parent=None])
param parent

PySide2.Qt3DCore.QNode

Constructs a new QTransform with parent .

static PySide2.Qt3DCore.QTransform.fromAxes(xAxis, yAxis, zAxis)
Parameters
Return type

PySide2.QtGui.QQuaternion

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

static PySide2.Qt3DCore.QTransform.fromAxesAndAngles(axis1, angle1, axis2, angle2)
Parameters
Return type

PySide2.QtGui.QQuaternion

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

static PySide2.Qt3DCore.QTransform.fromAxesAndAngles(axis1, angle1, axis2, angle2, axis3, angle3)
Parameters
Return type

PySide2.QtGui.QQuaternion

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

static PySide2.Qt3DCore.QTransform.fromAxisAndAngle(x, y, z, angle)
Parameters
  • x – float

  • y – float

  • z – float

  • angle – float

Return type

PySide2.QtGui.QQuaternion

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

static PySide2.Qt3DCore.QTransform.fromAxisAndAngle(axis, angle)
Parameters
Return type

PySide2.QtGui.QQuaternion

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

static PySide2.Qt3DCore.QTransform.fromEulerAngles(eulerAngles)
Parameters

eulerAnglesPySide2.QtGui.QVector3D

Return type

PySide2.QtGui.QQuaternion

Creates a QQuaternion from eulerAngles . Returns the resulting QQuaternion .

static PySide2.Qt3DCore.QTransform.fromEulerAngles(pitch, yaw, roll)
Parameters
  • pitch – float

  • yaw – float

  • roll – float

Return type

PySide2.QtGui.QQuaternion

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

PySide2.Qt3DCore.QTransform.matrix()
Return type

PySide2.QtGui.QMatrix4x4

Holds the QMatrix4x4 of the transform.

Note

When the matrix property is set, it is decomposed to translation, rotation and scale components.

PySide2.Qt3DCore.QTransform.matrixChanged()
static PySide2.Qt3DCore.QTransform.rotateAround(point, angle, axis)
Parameters
Return type

PySide2.QtGui.QMatrix4x4

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

static PySide2.Qt3DCore.QTransform.rotateFromAxes(xAxis, yAxis, zAxis)
Parameters
Return type

PySide2.QtGui.QMatrix4x4

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

PySide2.Qt3DCore.QTransform.rotation()
Return type

PySide2.QtGui.QQuaternion

Holds the rotation of the transform as QQuaternion .

PySide2.Qt3DCore.QTransform.rotationChanged(rotation)
Parameters

rotationPySide2.QtGui.QQuaternion

PySide2.Qt3DCore.QTransform.rotationX()
Return type

float

Holds the x rotation of the transform as Euler angle.

PySide2.Qt3DCore.QTransform.rotationXChanged(rotationX)
Parameters

rotationX – float

PySide2.Qt3DCore.QTransform.rotationY()
Return type

float

Holds the y rotation of the transform as Euler angle.

PySide2.Qt3DCore.QTransform.rotationYChanged(rotationY)
Parameters

rotationY – float

PySide2.Qt3DCore.QTransform.rotationZ()
Return type

float

Holds the z rotation of the transform as Euler angle.

PySide2.Qt3DCore.QTransform.rotationZChanged(rotationZ)
Parameters

rotationZ – float

PySide2.Qt3DCore.QTransform.scale()
Return type

float

Holds the uniform scale of the transform. If the scale has been set with setScale3D , holds the x value only.

PySide2.Qt3DCore.QTransform.scale3D()
Return type

PySide2.QtGui.QVector3D

Holds the scale of the transform as QVector3D .

PySide2.Qt3DCore.QTransform.scale3DChanged(scale)
Parameters

scalePySide2.QtGui.QVector3D

PySide2.Qt3DCore.QTransform.scaleChanged(scale)
Parameters

scale – float

PySide2.Qt3DCore.QTransform.setMatrix(matrix)
Parameters

matrixPySide2.QtGui.QMatrix4x4

Holds the QMatrix4x4 of the transform.

Note

When the matrix property is set, it is decomposed to translation, rotation and scale components.

PySide2.Qt3DCore.QTransform.setRotation(rotation)
Parameters

rotationPySide2.QtGui.QQuaternion

Holds the rotation of the transform as QQuaternion .

PySide2.Qt3DCore.QTransform.setRotationX(rotationX)
Parameters

rotationX – float

Holds the x rotation of the transform as Euler angle.

PySide2.Qt3DCore.QTransform.setRotationY(rotationY)
Parameters

rotationY – float

Holds the y rotation of the transform as Euler angle.

PySide2.Qt3DCore.QTransform.setRotationZ(rotationZ)
Parameters

rotationZ – float

Holds the z rotation of the transform as Euler angle.

PySide2.Qt3DCore.QTransform.setScale(scale)
Parameters

scale – float

Holds the uniform scale of the transform. If the scale has been set with setScale3D , holds the x value only.

PySide2.Qt3DCore.QTransform.setScale3D(scale)
Parameters

scalePySide2.QtGui.QVector3D

Holds the scale of the transform as QVector3D .

PySide2.Qt3DCore.QTransform.setTranslation(translation)
Parameters

translationPySide2.QtGui.QVector3D

Holds the translation of the transform as QVector3D .

PySide2.Qt3DCore.QTransform.translation()
Return type

PySide2.QtGui.QVector3D

Holds the translation of the transform as QVector3D .

PySide2.Qt3DCore.QTransform.translationChanged(translation)
Parameters

translationPySide2.QtGui.QVector3D

PySide2.Qt3DCore.QTransform.worldMatrix()
Return type

PySide2.QtGui.QMatrix4x4

Holds the world transformation matrix for the transform. This assumes the QTransform component is being referenced by a QEntity . This makes it more convenient to identify when a QEntity part of a subtree has been transformed in the world even though its local transformation might not have changed.

PySide2.Qt3DCore.QTransform.worldMatrixChanged(worldMatrix)
Parameters

worldMatrixPySide2.QtGui.QMatrix4x4