QTransform Class

class Qt3DCore::QTransform

メッシュに対して変換を実行するために使用する。詳細...

ヘッダー	`#include <QTransform>`
CMake：	`find_package(Qt6 REQUIRED COMPONENTS 3DCore)` `target_link_libraries(mytarget PRIVATE Qt6::3DCore)`
qmake	`QT += 3dcore`
QML で	Transform
を継承しています：	Qt3DCore::QComponent
ステータス	非推奨

継承したメンバを含むすべてのメンバの一覧

プロパティ

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

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

パブリック機能

	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

パブリックスロット

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)

シグナル

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)

静的パブリックメンバ

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)

詳細説明

QTransformコンポーネントは、複数のQEntity'間で共有することはできません。トランスフォームは、QVector3D scale、QQuaternion rotation、QVector3D translation コンポーネントとして保持されます。トランスフォームはこの順番でメッシュに適用されます。QTransform::matrix プロパティが設定されると、これらのトランスフォームコンポーネントに分解され、対応するシグナルが発行されます。

QTransform を設定するために、いくつかのヘルパー関数が提供されています。fromAxisAndAngle とfromAxesAndAngles を使用すると、特定の軸の周りの回転を設定でき、fromEulerAngles を使用すると、オイラー角に基づいて回転を設定でき、rotateAround を使用すると、ローカル原点に対する特定の点の周りにオブジェクトを回転させることができます。

プロパティのドキュメント

matrix : QMatrix4x4

トランスフォームのQMatrix4x4 を保持する。

注意： matrix プロパティが設定されると、並進、回転、スケールの各成分に分解されます。

アクセス関数：

QMatrix4x4	matrix() const
void	setMatrix(const QMatrix4x4 &matrix)

通知シグナル：

void	matrixChanged()

rotation : QQuaternion

変換の回転をQQuaternion として保持します。

アクセス関数：

QQuaternion	rotation() const
void	setRotation(const QQuaternion &rotation)

通知シグナル：

void	rotationChanged(const QQuaternion &rotation)

rotationX : float

変換の x 回転をオイラー角として保持します。

アクセス関数：

float	rotationX() const
void	setRotationX(float rotationX)

通知シグナル

void	rotationXChanged(float rotationX)

rotationY : float

変換の y 回転をオイラー角として保持します。

アクセス関数：

float	rotationY() const
void	setRotationY(float rotationY)

通知シグナル

void	rotationYChanged(float rotationY)

rotationZ : float

変換の z 回転をオイラー角として保持します。

アクセス関数：

float	rotationZ() const
void	setRotationZ(float rotationZ)

通知シグナル

void	rotationZChanged(float rotationZ)

scale : float

変換の一様なスケールを保持する。スケールがsetScale3D で設定されている場合、x 値のみを保持する。

アクセス関数：

float	scale() const
void	setScale(float scale)

通知シグナル：

void	scaleChanged(float scale)

scale3D : QVector3D

変換のスケールをQVector3D として保持します。

アクセス関数：

QVector3D	scale3D() const
void	setScale3D(const QVector3D &scale)

通知シグナル：

void	scale3DChanged(const QVector3D &scale)

translation : QVector3D

トランスフォームの変換をQVector3D として保持します。

アクセス関数：

QVector3D	translation() const
void	setTranslation(const QVector3D &translation)

通知シグナル：

void	translationChanged(const QVector3D &translation)

`[read-only]` worldMatrix : const QMatrix4x4

トランスフォームのワールド変換行列を保持する。これは、QTransform コンポーネントが、QEntity によって参照されていると仮定する。これにより、サブツリーのQEntity 部分が、そのローカル変換が変更されていなくても、ワールド内で変換されたときを識別することがより便利になる。

アクセス関数：

QMatrix4x4 worldMatrix() const

Notifierシグナル：

void	worldMatrixChanged(const QMatrix4x4 &worldMatrix)

メンバ関数ドキュメント

`[explicit]` QTransform::QTransform(Qt3DCore::QNode **parent* = nullptr)

parent で新しい QTransform を構築する。

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

軸xAxis,yAxis およびzAxis から回転を定義する QQuaterniom を作成します。

Note: この関数はメタオブジェクトシステムや QML から呼び出すことができます。Q_INVOKABLE を参照してください。