70 lines
1.5 KiB
Markdown
70 lines
1.5 KiB
Markdown
|
# Matrix3 / Matrix3x3
|
|||
|
|
|
|||
|
|
3x3 矩阵结构体，用于表示 3D 旋转和缩放变换。
|
|||
|
|
|
|||
|
|
## 头文件
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
#include <XCEngine/Math/Matrix3.h>
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 命名空间
|
|||
|
|
|
|||
|
|
`XCEngine::Math`
|
|||
|
|
|
|||
|
|
## 类型别名
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
using Matrix3 = Matrix3x3;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 存储方式
|
|||
|
|
|
|||
|
|
行优先存储 (row-major)：
|
|||
|
|
```
|
|||
|
|
m[row][col]
|
|||
|
|
m[0][0] m[0][1] m[0][2]
|
|||
|
|
m[1][0] m[1][1] m[1][2]
|
|||
|
|
m[2][0] m[2][1] m[2][2]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 构造函数
|
|||
|
|
|
|||
|
|
- 默认构造函数初始化为零矩阵
|
|||
|
|
|
|||
|
|
## 静态工厂方法
|
|||
|
|
|
|||
|
|
| 方法 | 返回值 | 描述 |
|
|||
|
|
|------|--------|------|
|
|||
|
|
| `Identity()` | `Matrix3` | 单位矩阵 |
|
|||
|
|
| `Zero()` | `Matrix3` | 零矩阵 |
|
|||
|
|
| `RotationX(float radians)` | `Matrix3` | X 轴旋转矩阵 |
|
|||
|
|
| `RotationY(float radians)` | `Matrix3` | Y 轴旋转矩阵 |
|
|||
|
|
| `RotationZ(float radians)` | `Matrix3` | Z 轴旋转矩阵 |
|
|||
|
|
| `Scale(const Vector3& scale)` | `Matrix3` | 缩放矩阵 |
|
|||
|
|
|
|||
|
|
## 实例方法
|
|||
|
|
|
|||
|
|
| 方法 | 返回值 | 描述 |
|
|||
|
|
|------|--------|------|
|
|||
|
|
| `Transpose()` | `Matrix3` | 转置矩阵 |
|
|||
|
|
| `Inverse()` | `Matrix3` | 逆矩阵 |
|
|||
|
|
| `Determinant()` | `float` | 行列式 |
|
|||
|
|
|
|||
|
|
## 运算符
|
|||
|
|
|
|||
|
|
| 运算符 | 描述 |
|
|||
|
|
|--------|------|
|
|||
|
|
| `operator*(Matrix3, Matrix3)` | 矩阵乘法 |
|
|||
|
|
| `operator*(Matrix3, Vector3)` | 矩阵-向量乘法 |
|
|||
|
|
|
|||
|
|
## 使用示例
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
Matrix3 rotX = Matrix3::RotationX(Math::HALF_PI);
|
|||
|
|
Matrix3 rotY = Matrix3::RotationY(0.0f);
|
|||
|
|
Matrix3 scale = Matrix3::Scale(Vector3(2.0f, 2.0f, 2.0f));
|
|||
|
|
Matrix3 combined = rotX * scale;
|
|||
|
|
Vector3 transformed = combined * Vector3(1.0f, 0.0f, 0.0f);
|
|||
|
|
```
|