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

Frustum::Contains

bool Contains(const Sphere& sphere) const

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

参数：

• sphere - 要检测的球体，包含圆心 center 和半径 radius

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

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

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

示例：

#include <XCEngine/Math/Frustum.h>
#include <XCEngine/Math/Sphere.h>

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

相关文档

• Frustum 总览 - 返回类总览
• Intersects - 球体与视锥相交检测