64 lines
1.4 KiB
Markdown
64 lines
1.4 KiB
Markdown
# Box
|
||
|
||
带变换的有向包围盒 (OBB) 结构体。
|
||
|
||
## 头文件
|
||
|
||
```cpp
|
||
#include <XCEngine/Math/Box.h>
|
||
```
|
||
|
||
## 命名空间
|
||
|
||
`XCEngine::Math`
|
||
|
||
## 结构体定义
|
||
|
||
```cpp
|
||
struct Box {
|
||
Vector3 center = Vector3::Zero();
|
||
Vector3 extents = Vector3::Zero(); // 半长
|
||
Matrix4x4 transform = Matrix4x4::Identity();
|
||
};
|
||
```
|
||
|
||
OBB 由中心点、半长向量和变换矩阵定义。
|
||
|
||
## 构造函数
|
||
|
||
- `Box()` - 默认构造
|
||
- `Box(const Vector3& center, const Vector3& extents)` - 从中心和半长构造
|
||
|
||
## 实例方法
|
||
|
||
| 方法 | 返回值 | 描述 |
|
||
|------|--------|------|
|
||
| `GetMin()` | `Vector3` | 局部空间最小点 (-extents) |
|
||
| `GetMax()` | `Vector3` | 局部空间最大点 (+extents) |
|
||
| `Contains(point)` | `bool` | 点是否在盒内（变换到局部空间检测） |
|
||
| `Intersects(Sphere)` | `bool` | 与球体相交 |
|
||
| `Intersects(Box)` | `bool` | 与另一个 OBB 相交（SAT 算法） |
|
||
| `Intersects(Ray, t)` | `bool` | 与射线相交，输出距离 t |
|
||
|
||
## 使用示例
|
||
|
||
```cpp
|
||
Box box(Vector3(0.0f), Vector3(1.0f)); // 2x2x2 盒子
|
||
box.transform = Matrix4::TRS(position, rotation, scale);
|
||
|
||
// 点检测
|
||
if (box.Contains(testPoint)) { ... }
|
||
|
||
// 球体相交
|
||
if (box.Intersects(sphere)) { ... }
|
||
|
||
// OBB 相交
|
||
if (box.Intersects(otherBox)) { ... }
|
||
|
||
// 射线相交
|
||
float t;
|
||
if (box.Intersects(ray, t)) {
|
||
Vector3 hit = ray.GetPoint(t);
|
||
}
|
||
```
|