PySide6.Qt3DCore.Qt3DCore.QTransform¶

class QTransform¶

用于对网格执行变换。更多…

概要¶

属性¶

• matrixᅟ

• rotationᅟ

• rotationXᅟ

• rotationYᅟ

• rotationZᅟ

• scaleᅟ

• scale3Dᅟ

• translationᅟ

• worldMatrixᅟ

方法¶

• def __init__()

• def matrix()

• def rotation()

• def rotationX()

• def rotationY()

• def rotationZ()

• def scale()

• def scale3D()

• def translation()

• def worldMatrix()

插槽¶

• def setMatrix()

• def setRotation()

• def setRotationX()

• def setRotationY()

• def setRotationZ()

• def setScale()

• def setScale3D()

• def setTranslation()

信号¶

• def matrixChanged()

• def rotationChanged()

• def rotationXChanged()

• def rotationYChanged()

• def rotationZChanged()

• def scale3DChanged()

• def scaleChanged()

• def translationChanged()

• def worldMatrixChanged()

静态函数¶

• def fromAxes()

• def fromAxesAndAngles()

• def fromAxisAndAngle()

• def fromEulerAngles()

• def rotateAround()

• def rotateFromAxes()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

QTransform 组件不能在多个 QEntity 之间共享。变换以 QVector3D 缩放、QQuaternion 旋转和 QVector3D 平移组件的形式保存。变换按此顺序应用于网格。当设置 matrix 属性时，它会被分解为这些变换组件，并发出相应的信号。

提供了几个辅助函数来设置QTransform；fromAxisAndAngle和fromAxesAndAngles可用于设置围绕特定轴的旋转，fromEulerAngles可用于基于欧拉角设置旋转，rotateAround可用于围绕相对于局部原点的特定点旋转对象。

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property matrixᅟ: QMatrix4x4¶

保存变换的QMatrix4x4。

注意

当矩阵属性被设置时，它被分解为平移、旋转和缩放组件。

Access functions:

• matrix()

• setMatrix()

• 信号 matrixChanged()

property rotationᅟ: QQuaternion¶

将变换的旋转保持为QQuaternion。

Access functions:

• rotation()

• setRotation()

• 信号 rotationChanged()

property rotationXᅟ: float¶

保持变换的x旋转作为欧拉角。

Access functions:

• rotationX()

• setRotationX()

• 信号 rotationXChanged()

property rotationYᅟ: float¶

保持变换的y旋转作为欧拉角。

Access functions:

• rotationY()

• setRotationY()

• 信号 rotationYChanged()

property rotationZᅟ: float¶

保持变换的z旋转作为欧拉角。

Access functions:

• rotationZ()

• setRotationZ()

• 信号 rotationZChanged()

property scaleᅟ: float¶

保持变换的统一比例。如果比例已使用setScale3D设置，则仅保持x值。

Access functions:

• scale()

• setScale()

• 信号 scaleChanged()

property scale3Dᅟ: QVector3D¶

保存变换的比例为QVector3D。

Access functions:

• scale3D()

• setScale3D()

• 信号 scale3DChanged()

property translationᅟ: QVector3D¶

保存变换的翻译为QVector3D。

Access functions:

• translation()

• setTranslation()

• 信号 translationChanged()

property worldMatrixᅟ: QMatrix4x4¶

保存变换的世界变换矩阵。这假设QTransform组件被QEntity引用。这使得即使其局部变换可能没有改变，也能更方便地识别子树中的QEntity部分是否在世界中进行了变换。

Access functions:

• worldMatrix()

• 信号 worldMatrixChanged()

__init__([parent=None])¶

Parameters:

parent – QNode

使用parent构造一个新的QTransform。

static fromAxes(xAxis, yAxis, zAxis)¶

Parameters:

• xAxis – QVector3D

• y轴 – QVector3D

• z轴 – QVector3D

Return type:

QQuaternion

创建一个QQuaterniom，定义从轴xAxis、yAxis和zAxis的旋转。

static fromAxesAndAngles(axis1, angle1, axis2, angle2)¶

Parameters:

• axis1 – QVector3D

• angle1 – 浮点数

• axis2 – QVector3D

• angle2 – 浮点数

Return type:

QQuaternion

从axis1、angle1、axis2和angle2创建一个QQuaternion。返回生成的QQuaternion。

static fromAxesAndAngles(axis1, angle1, axis2, angle2, axis3, angle3)

Parameters:

• axis1 – QVector3D

• angle1 – 浮点数

• axis2 – QVector3D

• angle2 – 浮点数

• axis3 – QVector3D

• angle3 – 浮点数

Return type:

QQuaternion

从axis1、angle1、axis2、angle2、axis3和angle3创建一个QQuaternion。返回生成的QQuaternion。

static fromAxisAndAngle(axis, angle)¶

Parameters:

• axis – QVector3D

• angle – 浮点数

Return type:

QQuaternion

从axis和angle创建一个QQuaternion。返回生成的QQuaternion。

static fromAxisAndAngle(x, y, z, angle)

Parameters:

• x – 浮点数

• y – 浮点数

• z – 浮点数

• angle – 浮点数

Return type:

QQuaternion

从 x, y, z, 和 angle 创建一个 QQuaternion。返回生成的 QQuaternion。

static fromEulerAngles(eulerAngles)¶

Parameters:

eulerAngles – QVector3D

Return type:

QQuaternion

从eulerAngles创建一个QQuaternion。返回生成的QQuaternion。

static fromEulerAngles(pitch, yaw, roll)

Parameters:

• pitch – 浮点数

• yaw – 浮点数

• roll – 浮点数

Return type:

QQuaternion

从pitch、yaw和roll创建一个QQuaternion。返回生成的QQuaternion。

matrix()¶

Return type:

QMatrix4x4

另请参阅

setMatrix()

属性 matrixᅟ 的获取器。

matrixChanged()¶

属性 matrixᅟ 的通知信号。

static rotateAround(point, angle, axis)¶

Parameters:

• 点 – QVector3D

• angle – 浮点数

• axis – QVector3D

Return type:

QMatrix4x4

从axis和angle围绕point创建一个旋转矩阵。返回生成的QMatrix4x4。

static rotateFromAxes(xAxis, yAxis, zAxis)¶

Parameters:

• xAxis – QVector3D

• y轴 – QVector3D

• z轴 – QVector3D

Return type:

QMatrix4x4

返回一个由轴xAxis、yAxis、zAxis定义的旋转矩阵。

rotation()¶

Return type:

QQuaternion

另请参阅

setRotation()

属性 rotationᅟ 的获取器。

rotationChanged(rotation)¶

Parameters:

旋转 – QQuaternion

属性 rotationᅟ 的通知信号。

rotationX()¶

Return type:

浮点数

另请参阅

setRotationX()

获取属性 rotationXᅟ 的Getter。

rotationXChanged(rotationX)¶

Parameters:

rotationX – 浮点数

属性 rotationXᅟ 的通知信号。

rotationY()¶

Return type:

浮点数

另请参阅

setRotationY()

属性 rotationYᅟ 的获取器。

rotationYChanged(rotationY)¶

Parameters:

rotationY – 浮点数

属性 rotationYᅟ 的通知信号。

rotationZ()¶

Return type:

浮点数

另请参阅

setRotationZ()

属性 rotationZᅟ 的获取器。

rotationZChanged(rotationZ)¶

Parameters:

rotationZ – 浮点数

属性 rotationZᅟ 的通知信号。

scale()¶

Return type:

浮点数

另请参阅

setScale()

属性 scaleᅟ 的获取器。

scale3D()¶

Return type:

QVector3D

另请参阅

setScale3D()

属性 scale3Dᅟ 的获取器。

scale3DChanged(scale)¶

Parameters:

scale – QVector3D

属性 scale3Dᅟ 的通知信号。

scaleChanged(scale)¶

Parameters:

scale – 浮点数

属性 scaleᅟ 的通知信号。

setMatrix(matrix)¶

Parameters:

矩阵 – QMatrix4x4

另请参阅

matrix()

属性 matrixᅟ 的设置器。

setRotation(rotation)¶

Parameters:

旋转 – QQuaternion

另请参阅

rotation()

属性 rotationᅟ 的设置器。

setRotationX(rotationX)¶

Parameters:

rotationX – 浮点数

另请参阅

rotationX()

属性 rotationXᅟ 的设置器。

setRotationY(rotationY)¶

Parameters:

rotationY – 浮点数

另请参阅

rotationY()

属性 rotationYᅟ 的设置器。

setRotationZ(rotationZ)¶

Parameters:

rotationZ – 浮点数

另请参阅

rotationZ()

属性 rotationZᅟ 的设置器。

setScale(scale)¶

Parameters:

scale – 浮点数

另请参阅

scale()

属性 scaleᅟ 的设置器。

setScale3D(scale)¶

Parameters:

scale – QVector3D

另请参阅

scale3D()

属性 scale3Dᅟ 的设置器。

setTranslation(translation)¶

Parameters:

翻译 – QVector3D

另请参阅

translation()

属性 translationᅟ 的设置器。

translation()¶

Return type:

QVector3D

另请参阅

setTranslation()

属性 translationᅟ 的获取器。

translationChanged(translation)¶

Parameters:

翻译 – QVector3D

属性 translationᅟ 的通知信号。

worldMatrix()¶

Return type:

QMatrix4x4

返回与QTransform相关联的世界变换矩阵，当它被一个可能是QEntity层次结构的一部分的QEntity引用时。

属性 worldMatrixᅟ 的获取器。

worldMatrixChanged(worldMatrix)¶

Parameters:

worldMatrix – QMatrix4x4

属性 worldMatrixᅟ 的通知信号。