Files
XCEngine/docs/api/math/matrix4/decompose.md
ssdfasd 63d0271a5b Fix broken links in Math API docs
Fix 30+ broken cross-references in docs/api/math/:
- viewport: viewport-getaspectratio/getrect -> getaspectratio/getrect
- matrix4: ../color/operator-mul -> operator_mul, operator-index -> operator_index
- matrix4/get-*: gettranslation/getscale/getrotation -> get-translation/-scale/-rotation
- vector3 operator links: operator_*_assign -> operator-*-assign
- vector3 operator links: operator_sub/add -> operator-sub/add
- vector3 operator-eq/neq: swap mutual references to use hyphen naming
- vector4: ../plane/constructor-default -> constructor_default
- Linter fixes: aabb and rectint relative paths corrected
2026-03-26 01:43:14 +08:00

1.2 KiB

Matrix4x4::Decompose

void Decompose(Vector3& translation, Quaternion& rotation, Vector3& scale) const

将变换矩阵分解为平移、旋转和缩放三个独立分量。

参数:

  • translation - 输出参数,接收平移向量
  • rotation - 输出参数,接收旋转四元数
  • scale - 输出参数,接收缩放向量

返回: (无)

线程安全:

复杂度: O(1)

示例:

#include "XCEngine/Math/Matrix4.h"
#include "XCEngine/Math/Vector3.h"
#include "XCEngine/Math/Quaternion.h"

using namespace XCEngine::Math;

Matrix4 transform = Matrix4::TRS(
    Vector3(1.0f, 2.0f, 3.0f),
    Quaternion::FromEuler(45.0f, 0.0f, 0.0f),
    Vector3(2.0f, 2.0f, 2.0f)
);

Vector3 translation;
Quaternion rotation;
Vector3 scale;
transform.Decompose(translation, rotation, scale);
// translation = (1.0f, 2.0f, 3.0f)
// rotation 表示 45 度 X 轴旋转
// scale = (2.0f, 2.0f, 2.0f)

相关文档