XCEngine/docs/api/math/frustum/frustum.md

# Frustum

**命名空间**: `XCEngine::Math`

**类型**: `class`

**头文件**: `XCEngine/Core/Math/Frustum.h`

**描述**: 视锥体，用于 3D 裁剪和可见性判断

## 概述

Frustum 表示一个视锥体，由 6 个裁剪平面组成（左、右、底、顶、近、远）。主要用于视锥剔除（Frustum Culling），在渲染前判断场景物体是否与相机视锥相交或完全在内，从而决定是否需要渲染该物体，提升渲染性能。

## 公共方法

| 方法 | 描述 |
|------|------|
| [`Contains(Point)`](contains-point.md) | 点是否完全在视锥内 |
| [`Contains(Sphere)`](contains-sphere.md) | 球体是否完全在视锥内 |
| [`Contains(Bounds)`](contains-bounds.md) | Bounds 是否完全在视锥内 |
| [`Intersects(Bounds)`](intersects-bounds.md) | Bounds 是否与视锥相交 |
| [`Intersects(Sphere)`](intersects-sphere.md) | 球体是否与视锥相交 |

## 嵌套类型

| 类型 | 描述 |
|------|------|
| `PlaneIndex` | 平面索引枚举（Left, Right, Bottom, Top, Near, Far） |

## 使用示例

```cpp
Frustum frustum = camera.CalculateFrustum();
Bounds objectBounds = object.GetWorldBounds();

if (frustum.Contains(objectBounds)) {
    // 物体完全在视锥内，必须渲染
    Render(object);
} else if (frustum.Intersects(objectBounds)) {
    // 物体与视锥相交，可能需要渲染
    Render(object);
}
```

## 相关文档

- [Math 模块总览](../math.md) - Math 模块总览
- [Plane](../plane/plane.md) - 平面类型
- [Bounds](../bounds/bounds.md) - 包围盒类型
- [Sphere](../sphere/sphere.md) - 球体类型