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()

• 定义 fromAxesAndAngles()

• 定义 fromAxisAndAngle()

• 定义 fromEulerAngles()

• 定义 rotateAround()

• 定义 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 时，否则通过访问器函数。

属性 matrixᅟ: QMatrix4x4

保留变换的 QMatrix4x4。

备注

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

访问函数

• matrix()

• setMatrix()

• 信号 matrixChanged()

属性 rotationᅟ: QQuaternion

以 QQuaternion 的形式保留变换的旋转。

访问函数

• rotation()

• 设置旋转()

• 信号 rotationChanged()

属性rotationX: float

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

访问函数

• rotationX()

• setRotationX()

• 信号 rotationXChanged()

属性rotationY: float

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

访问函数

• rotationY()

• setRotationY()

• 信号 rotationYChanged()

属性rotationZ: float

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

访问函数

• rotationZ()

• setRotationZ()

• 信号 rotationZChanged()

属性scale: float

保存变换的统一缩放。如果缩放已用 setScale3D 设置，则仅保存x值。

访问函数

• scale()

• setScale()

• 信号 scaleChanged()

属性scale3D: QVector3D

保存变换的缩放为QVector3D。

访问函数

• scale3D()

• setScale3D()

• 信号 scale3DChanged()

属性translation: QVector3D

保存变换的位移为QVector3D。

访问函数

• translation()

• setTranslation()

• 信号 translationChanged()

属性 worldMatrix: QMatrix4x4

保存转换的完整世界变换矩阵。这假定 QTransform 组件被一个 QEntity 引用。这使得在子树中即使局部变换没有变化，也更容易识别出哪个 QEntity 部分已经发生了全局变换。

访问函数

• worldMatrix()

• 信号 worldMatrixChanged

__init__([parent=None])

参数:

parent – QNode

构造一个带有 parent 的新 QTransform。

静态 fromAxes(xAxis, yAxis, zAxis)

参数:

• xAxis – QVector3D

• yAxis – QVector3D

• zAxis – QVector3D

返回类型:

QQuaternion

通过定义在不同轴上的旋转来创建一个 QQuaterniom。

静态 fromAxesAndAngles(axis1, angle1, axis2, angle2, axis3, angle3)

参数:

• axis1 – QVector3D

• angle1 – float

• axis2 – QVector3D

• angle2 – float

• axis3 – QVector3D

• angle3 – float

返回类型:

QQuaternion

从 axis1、angle1、axis2、angle2、axis3 和 angle3 创建一个 QQuaternion。返回结果 QQuaternion。

static fromAxesAndAngles(axis1, angle1, axis2, angle2)

参数:

• axis1 – QVector3D

• angle1 – float

• axis2 – QVector3D

• angle2 – float

返回类型:

QQuaternion

从 axis1、angle1、axis2 和 angle2 创建一个 QQuaternion。返回结果 QQuaternion。

static fromAxisAndAngle(axis, angle)

参数:

• axis – QVector3D

• angle – float

返回类型:

QQuaternion

从 axis 和 angle 创建一个 QQuaternion。返回结果 QQuaternion。

static fromAxisAndAngle(x, y, z, angle)

参数:

• x – float

• y – float

• z – float

• angle – float

返回类型:

QQuaternion

从 x、y、z 和 angle 创建一个 QQuaternion。返回结果 QQuaternion。

static fromEulerAngles(eulerAngles)

参数:

eulerAngles – QVector3D

返回类型:

QQuaternion

从 eulerAngles 创建一个 QQuaternion。返回结果 QQuaternion。

static fromEulerAngles(pitch, yaw, roll)

参数:

• pitch – float

• yaw – float

• roll – float

返回类型:

QQuaternion

从 pitch、yaw 和 roll 创建一个 QQuaternion。返回结果 QQuaternion。

矩阵()

返回类型:

QMatrix4x4

另请参阅

setMatrix()

属性获取器 matrix .

matrixChanged()

属性 matrix 的通知信号.

静态rotateAround(point, angle, axis)

参数:

• point – QVector3D

• angle – float

• axis – QVector3D

返回类型:

QMatrix4x4

根据旋转轴 axis 和旋转角度 angle 绕点 point 创建旋转矩阵。返回结果 QMatrix4x4。

静态rotateFromAxes(xAxis, yAxis, zAxis)

参数:

• xAxis – QVector3D

• yAxis – QVector3D

• zAxis – QVector3D

返回类型:

QMatrix4x4

从坐标轴 xAxis、yAxis 和 zAxis 定义旋转矩阵。

rotation()

返回类型:

QQuaternion

另请参阅

设置旋转()

属性获取器 rotation .

rotationChanged(rotation)

参数:

rotation – QQuaternion

属性 rotation 的通知信号.

rotationX()

返回类型:

float

另请参阅

setRotationX()

属性获取器 rotationX .

rotationXChanged(rotationX)

参数:

rotationX – float

属性 rotationX 的通知信号.

rotationY()

返回类型:

float

另请参阅

setRotationY()

属性 rotationYᅟ 的获取器。

rotationYChanged(rotationY)

参数:

rotationY – float

属性 rotationYᅟ 的通知信号。

rotationZ()

返回类型:

float

另请参阅

setRotationZ()

属性 rotationZᅟ 的获取器。

rotationZChanged(rotationZ)

参数:

rotationZ – float

属性 rotationZᅟ 的通知信号。

scale()

返回类型:

float

另请参阅

setScale()

属性 scaleᅟ 的获取器。

scale3D()

返回类型:

QVector3D

另请参阅

setScale3D()

属性 scale3Dᅟ 的获取器。

scale3DChanged(scale)

参数:

scale – QVector3D

属性 scale3Dᅟ 的通知信号。

scaleChanged(scale)

参数:

scale – float

属性 scaleᅟ 的通知信号。

setMatrix(matrix)

参数:

matrix – QMatrix4x4

另请参阅

matrix()

属性 matrixᅟ 的设置器。

setRotation(rotation)

参数:

rotation – QQuaternion

另请参阅

rotation()

属性 rotationᅟ 的设置器。

setRotationX(rotationX)

参数:

rotationX – float

另请参阅

rotationX()

属性 rotationX 的设置器。

setRotationY(rotationY)

参数:

rotationY – float

另请参阅

rotationY()

属性 rotationY 的设置器。

setRotationZ(rotationZ)

参数:

rotationZ – float

另请参阅

rotationZ()

属性 rotationZ 的设置器。

setScale(scale)

参数:

scale – float

另请参阅

scale()

属性 scale 的设置器。

setScale3D(scale)

参数:

scale – QVector3D

另请参阅

scale3D()

属性 scale3D 的设置器。

setTranslation(translation)

参数:

translation – QVector3D

另请参阅

translation()

属性 translation 的设置器。

translation()

返回类型:

QVector3D

另请参阅

setTranslation()

属性 translation 的获取器。

translationChanged(translation)

参数:

translation – QVector3D

属性 translation 的改变通知信号。

worldMatrix()

返回类型:

QMatrix4x4

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

属性 worldMatrix 的获取器。

worldMatrixChanged(worldMatrix)

参数:

worldMatrix – QMatrix4x4

属性 worldMatrix 的通知信号。