ssdfasd
0f0ab8922a
threading/: - Rename 19 camelCase method files to hyphenated names - task-system: createtaskgroup→create-task-group, etc. - tasksystemconfig: enabletaskprofiling→enable-task-profiling, etc. - thread: getcurrentid→get-current-id, etc. - task: addref→add-ref, getid→get-id, etc. math/: - Rename underscore operator files to hyphenated - vector3: operator_add→operator-add, etc. - matrix4: gettranslation→get-translation, etc. - vector4: tovector3→to-vector3, constructor_vector3→constructor-vector3 - sphere: sphere_constructor→sphere-constructor, etc. memory/: - Remove duplicate memorymanager/ folder (kept manager/ which was correct) core/: - filewriter: Consolidate ctor-default.md and ctor-file.md into constructor.md - Rename dtor.md→destructor.md debug/: - filelogsink: Rename construct.md→constructor.md, ~filelogsink.md→destructor.md All overview pages updated with new file references.
72 lines
2.0 KiB
Markdown
72 lines
2.0 KiB
Markdown
# Vector4
|
||
|
||
**命名空间**: `XCEngine::Math`
|
||
|
||
**类型**: `struct`
|
||
|
||
**头文件**: `XCEngine/Math/Vector4.h`
|
||
|
||
**描述**: 四维向量，用于齐次坐标变换和四元数相关计算
|
||
|
||
## 概述
|
||
|
||
Vector4 是四维向量结构体，常用于：
|
||
- 齐次坐标变换（x, y, z, w）
|
||
- RGBA 颜色表示
|
||
- SIMD 矢量操作
|
||
- 四元数分量存储
|
||
|
||
## 结构体成员
|
||
|
||
| 成员 | 类型 | 描述 | 默认值 |
|
||
|------|------|------|--------|
|
||
| `x` | `float` | X 分量 | `0.0f` |
|
||
| `y` | `float` | Y 分量 | `0.0f` |
|
||
| `z` | `float` | Z 分量 | `0.0f` |
|
||
| `w` | `float` | W 分量（齐次坐标） | `0.0f` |
|
||
|
||
## 公共方法
|
||
|
||
| 方法 | 描述 |
|
||
|------|------|
|
||
| [`Vector4()`](constructor-default.md) | 默认构造函数，创建零向量 |
|
||
| [`Vector4(x, y, z, w)`](constructor.md) | 从四个分量构造向量 |
|
||
| [`Vector4(Vector3, w)`](constructor-vector3.md) | 从 Vector3 构造（w 默认 0） |
|
||
| [`Zero`](zero.md) | 返回零向量 (0, 0, 0, 0) |
|
||
| [`One`](one.md) | 返回单位向量 (1, 1, 1, 1) |
|
||
| [`Dot`](dot.md) | 计算两个向量的点积 |
|
||
| [`Project`](project.md) | 将向量投影到法线向量上 |
|
||
| [`ToVector3`](to-vector3.md) | 转换为 Vector3 |
|
||
| [`operator[]`](./operator-brackets.md) | 下标访问分量 |
|
||
| [`operator+`](operator-add.md) | 向量加法 |
|
||
| [`operator-`](operator-sub.md) | 向量减法 |
|
||
| [`operator*`](operator-mul.md) | 向量数乘 |
|
||
| [`operator==`](operator-eq.md) | 相等比较 |
|
||
| [`operator!=`](operator-ne.md) | 不等比较 |
|
||
|
||
## 使用示例
|
||
|
||
```cpp
|
||
#include <XCEngine/Math/Vector4.h>
|
||
#include <XCEngine/Math/Vector3.h>
|
||
#include <cstdio>
|
||
|
||
int main() {
|
||
Vector4 a(1.0f, 2.0f, 3.0f, 4.0f);
|
||
Vector4 b(4.0f, 3.0f, 2.0f, 1.0f);
|
||
|
||
Vector4 sum = a + b;
|
||
Vector4 scaled = a * 2.0f;
|
||
float dot = Vector4::Dot(a, b);
|
||
|
||
Vector4 projected = Vector4::Project(a, Vector4(1.0f, 0.0f, 0.0f, 0.0f));
|
||
Vector3 v3 = a.ToVector3();
|
||
|
||
return 0;
|
||
}
|
||
```
|
||
|
||
## 相关文档
|
||
|
||
- [Math 模块总览](../math.md) - Math 模块总览
|