XCEngine/docs/api/math/frustum/contains-sphere.md

# Frustum::Contains

```cpp
bool Contains(const Sphere& sphere) const
```

检测球体是否完全位于视锥体内。判断方式为：依次计算球心到 6 个裁剪平面的有符号距离，若任意一个距离小于 `-radius`（即球心到平面的距离小于球半径的负数，说明球体完全在平面外侧），则视锥体不包含该球体。

**参数：**
- `sphere` - 要检测的球体，包含圆心 `center` 和半径 `radius`

**返回：** `bool` - 球体完全在视锥内返回 `true`，否则返回 `false`

**线程安全：** ✅（只读操作，不修改状态）

**复杂度：** O(6)，即遍历 6 个裁剪平面

**示例：**

```cpp
#include <XCEngine/Core/Math/Frustum.h>
#include <XCEngine/Core/Math/Sphere.h>

void CheckSphereInFrustum(const Frustum& frustum, const Sphere& sphere) {
    if (frustum.Contains(sphere)) {
        // 球体完全在视锥内
    }
}
```

## 相关文档

- [Frustum 总览](frustum.md) - 返回类总览
- [Intersects](intersects-sphere.md) - 球体与视锥相交检测