# CameraComponent

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

**类型**: `class`

**头文件**: `XCEngine/Components/CameraComponent.h`

**描述**: 相机组件，定义视图和投影参数，支持透视和正交两种投影模式。

## 概述

CameraComponent 是 XCEngine ECS 系统中的相机组件，用于定义场景的观察视角。它支持透视投影（Perspective）和正交投影（Orthographic）两种模式，可以设置视场角、近裁剪面、远裁剪面、深度值和清除颜色等参数。

## 枚举

### CameraProjectionType

| 枚举值 | 描述 |
|--------|------|
| `Perspective` | 透视投影，符合人眼观察习惯 |
| `Orthographic` | 正交投影，保持物体真实大小 |

## 公共方法

### 投影设置

| 方法 | 描述 |
|------|------|
| [`GetProjectionType`](get-projection-type.md) | 获取投影类型 |
| [`SetProjectionType`](set-projection-type.md) | 设置投影类型 |
| [`GetFieldOfView`](get-field-of-view.md) | 获取视场角（透视投影） |
| [`SetFieldOfView`](set-field-of-view.md) | 设置视场角 |
| [`GetOrthographicSize`](get-orthographic-size.md) | 获取正交投影大小 |
| [`SetOrthographicSize`](set-orthographic-size.md) | 设置正交投影大小 |

### 裁剪平面

| 方法 | 描述 |
|------|------|
| [`GetNearClipPlane`](get-near-clip-plane.md) | 获取近裁剪面距离 |
| [`SetNearClipPlane`](set-near-clip-plane.md) | 设置近裁剪面距离 |
| [`GetFarClipPlane`](get-far-clip-plane.md) | 获取远裁剪面距离 |
| [`SetFarClipPlane`](set-far-clip-plane.md) | 设置远裁剪面距离 |

### 相机属性

| 方法 | 描述 |
|------|------|
| [`GetDepth`](../../rhi/texture/get-depth.md) | 获取深度值 |
| [`SetDepth`](set-depth.md) | 设置深度值 |
| [`IsPrimary`](is-primary.md) | 检查是否为主相机 |
| [`SetPrimary`](set-primary.md) | 设置为主相机 |
| [`GetClearColor`](get-clear-color.md) | 获取清除颜色 |
| [`SetClearColor`](../../rhi/opengl/pipeline-state/set-clear-color.md) | 设置清除颜色 |

## 使用示例

```cpp
#include <XCEngine/Components/CameraComponent.h>
#include <XCEngine/Components/GameObject.h>

using namespace XCEngine::Components;

void SetupCamera(GameObject* cameraObject) {
    auto camera = cameraObject->AddComponent<CameraComponent>();
    
    camera->SetProjectionType(CameraProjectionType::Perspective);
    camera->SetFieldOfView(60.0f);
    camera->SetNearClipPlane(0.1f);
    camera->SetFarClipPlane(1000.0f);
    camera->SetPrimary(true);
}
```

## 相关文档

- [Components 模块总览](../components.md) - Components 模块总览
- [Component](../component/component.md) - 组件基类
- [TransformComponent](../transform-component/transform-component.md) - 变换组件