36 lines
1.1 KiB
Markdown
36 lines
1.1 KiB
Markdown
# Frustum::Contains
|
||
|
||
```cpp
|
||
bool Contains(const Bounds& bounds) const
|
||
```
|
||
|
||
检测轴对齐包围盒（Axis-Aligned Bounding Box，AABB）是否完全位于视锥体内。判断方式为：先取出 Bounds 的 8 个顶点坐标，然后对每个裁剪平面，检查所有 8 个顶点是否都在该平面外侧（距离小于 0）。若存在某个平面使得全部 8 个顶点都在其外侧，则包围盒完全在视锥外；否则认为包围盒至少部分在视锥内。
|
||
|
||
**参数：**
|
||
- `bounds` - 要检测的轴对齐包围盒
|
||
|
||
**返回：** `bool` - Bounds 完全在视锥内返回 `true`，否则返回 `false`
|
||
|
||
**线程安全：** ✅（只读操作，不修改状态）
|
||
|
||
**复杂度：** O(48)，即遍历 6 个平面 × 8 个顶点
|
||
|
||
**示例：**
|
||
|
||
```cpp
|
||
#include <XCEngine/Math/Frustum.h>
|
||
#include <XCEngine/Math/Bounds.h>
|
||
|
||
void CheckBoundsInFrustum(const Frustum& frustum, const Bounds& bounds) {
|
||
if (frustum.Contains(bounds)) {
|
||
// 包围盒完全在视锥内，必须渲染
|
||
Render();
|
||
}
|
||
}
|
||
```
|
||
|
||
## 相关文档
|
||
|
||
- [Frustum 总览](frustum.md) - 返回类总览
|
||
- [Intersects](intersects-bounds.md) - 包围盒与视锥相交检测
|