docs: update math API docs

This commit is contained in:
2026-03-20 02:35:15 +08:00
parent e165dbea1c
commit c5b17239ca
243 changed files with 5307 additions and 1327 deletions

View File

@@ -1,40 +1,30 @@
# Quaternion::Normalized / Normalize
## 实例方法
# Quaternion::Normalized
```cpp
Quaternion Normalized() const
Quaternion Normalized() const;
```
返回当前四元数的归一化副本(不修改原四元数)
返回归一化(单位化)后的四元数。如果模长接近 0返回单位四元数
**返回:** `Quaternion` - 归一化后的四元数副本
**返回:** 归一化后的四元数
**线程安全:**
**复杂度:** O(1)
**示例:**
```cpp
Quaternion unit = quat.Normalized(); // quat 保持不变
#include <XCEngine/Math/Quaternion.h>
using namespace XCEngine::Math;
Quaternion q = Quaternion::FromAxisAngle(Vector3::Up(), Math::Radians(90.0f));
Quaternion normalized = q.Normalized();
```
## 静态方法
## 相关文档
```cpp
static Quaternion Normalize(const Quaternion& q)
```
归一化四元数。
**参数:**
- `q` - 要归一化的四元数
**返回:** `Quaternion` - 归一化后的四元数
**复杂度:** O(1)
**示例:**
```cpp
Quaternion unit = Quaternion::Normalize(quat);
```
- [Quaternion](quaternion.md) - 返回类总览
- [Normalize](normalize.md) - 静态归一化方法
- [Magnitude](magnitude.md) - 求模长