Files
XCEngine/docs/api/math/frustum/intersects-bounds.md

40 lines
1.4 KiB
Markdown
Raw Normal View History

2026-03-20 02:35:15 +08:00
# Frustum::Intersects
```cpp
bool Intersects(const Bounds& bounds) const
```
2026-03-20 02:35:15 +08:00
检测轴对齐包围盒Axis-Aligned Bounding BoxAABB是否与视锥体相交。判断方式为对每个裁剪平面检查 8 个顶点是否全部在该平面外侧allNegative或全部在内侧allPositive。若存在某个平面使得全部 8 个顶点都在其外侧,则视锥与包围盒不相交;否则认为两者相交。
注意:此方法与 `Contains(Bounds)` 的区别在于——`Contains` 要求包围盒完全在视锥内,而 `Intersects` 只要有任意重叠就返回 `true`
**参数:**
- `bounds` - 要检测的轴对齐包围盒
2026-03-20 02:35:15 +08:00
**返回:** `bool` - 视锥与 Bounds 相交返回 `true`,否则返回 `false`
**线程安全:** ✅(只读操作,不修改状态)
2026-03-20 02:35:15 +08:00
**复杂度:** O(48),即遍历 6 个平面 × 8 个顶点
**示例:**
```cpp
#include <XCEngine/Core/Math/Frustum.h>
#include <XCEngine/Core/Math/Bounds.h>
2026-03-20 02:35:15 +08:00
void FrustumCullingExample(const Frustum& frustum, const std::vector<Bounds>& objectBounds) {
for (const auto& bounds : objectBounds) {
if (frustum.Intersects(bounds)) {
// 物体与视锥相交,需要渲染
Render(bounds);
}
}
}
```
2026-03-20 02:35:15 +08:00
## 相关文档
- [Frustum 总览](frustum.md) - 返回类总览
- [Contains](contains-bounds.md) - 包围盒完全包含检测