docs: 更新 resources, rhi, scene 模块及新增 camera-component 方法文档

- resources: 更新 asyncloader, audioclip, mesh-import-settings, texture-loader 文档
- rhi: 更新 opengl render-target-view 文档
- components: 新增 camera-component 全部方法文档 (15个文件)

docs/api/components/camera-component/get-clear-color.md

@@ -0,0 +1,38 @@
+# GetClearColor
+
+**所属类**: `CameraComponent`
+
+**头文件**: `XCEngine/Components/CameraComponent.h`
+
+**描述**: 获取摄像机的清除颜色。
+
+## 函数签名
+
+```cpp
+const Math::Color& GetClearColor() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `const Math::Color&` | 清除颜色引用，默认值为深蓝色 (0.192f, 0.302f, 0.475f, 1.0f) |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/CameraComponent.h>
+
+using namespace XCEngine::Components;
+
+void PrintClearColor(CameraComponent* camera) {
+    const auto& color = camera->GetClearColor();
+    printf("Clear color: (%.2f, %.2f, %.2f, %.2f)\n",
+           color.r, color.g, color.b, color.a);
+}
+```
+
+## 相关文档
+
+- [CameraComponent](camera-component.md) - 摄像机组件
+- [SetClearColor](set-clear-color.md) - 设置清除颜色

docs/api/components/camera-component/get-depth.md

@@ -0,0 +1,37 @@
+# GetDepth
+
+**所属类**: `CameraComponent`
+
+**头文件**: `XCEngine/Components/CameraComponent.h`
+
+**描述**: 获取摄像机的深度值。
+
+## 函数签名
+
+```cpp
+float GetDepth() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `float` | 摄像机深度值，用于确定渲染顺序 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/CameraComponent.h>
+
+using namespace XCEngine::Components;
+
+void PrintCameraDepth(CameraComponent* camera) {
+    float depth = camera->GetDepth();
+    printf("Camera depth: %.2f\n", depth);
+}
+```
+
+## 相关文档
+
+- [CameraComponent](camera-component.md) - 摄像机组件
+- [SetDepth](set-depth.md) - 设置深度值

docs/api/components/camera-component/get-far-clip-plane.md

@@ -0,0 +1,37 @@
+# GetFarClipPlane
+
+**所属类**: `CameraComponent`
+
+**头文件**: `XCEngine/Components/CameraComponent.h`
+
+**描述**: 获取摄像机的远裁剪平面距离。
+
+## 函数签名
+
+```cpp
+float GetFarClipPlane() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `float` | 远裁剪平面距离，默认值为 1000.0 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/CameraComponent.h>
+
+using namespace XCEngine::Components;
+
+void PrintFarPlane(CameraComponent* camera) {
+    float far = camera->GetFarClipPlane();
+    printf("Far clip plane: %.2f\n", far);
+}
+```
+
+## 相关文档
+
+- [CameraComponent](camera-component.md) - 摄像机组件
+- [SetFarClipPlane](set-far-clip-plane.md) - 设置远裁剪平面

docs/api/components/camera-component/get-field-of-view.md

@@ -0,0 +1,37 @@
+# GetFieldOfView
+
+**所属类**: `CameraComponent`
+
+**头文件**: `XCEngine/Components/CameraComponent.h`
+
+**描述**: 获取摄像机的视场角（仅在透视投影模式下有效）。
+
+## 函数签名
+
+```cpp
+float GetFieldOfView() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `float` | 视场角，单位度，默认值为 60.0 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/CameraComponent.h>
+
+using namespace XCEngine::Components;
+
+void PrintFOV(CameraComponent* camera) {
+    float fov = camera->GetFieldOfView();
+    printf("Field of view: %.1f degrees\n", fov);
+}
+```
+
+## 相关文档
+
+- [CameraComponent](camera-component.md) - 摄像机组件
+- [SetFieldOfView](set-field-of-view.md) - 设置视场角

docs/api/components/camera-component/get-near-clip-plane.md

@@ -0,0 +1,39 @@
+# GetNearClipPlane
+
+**所属类**: `CameraComponent`
+
+**头文件**: `XCEngine/Components/CameraComponent.h`
+
+**描述**: 获取摄像机的近裁剪平面距离。
+
+## 函数签名
+
+```cpp
+float GetNearClipPlane() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `float` | 近裁剪平面距离，默认值为 0.1 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/CameraComponent.h>
+
+using namespace XCEngine::Components;
+
+void PrintClipPlanes(CameraComponent* camera) {
+    float near = camera->GetNearClipPlane();
+    float far = camera->GetFarClipPlane();
+    printf("Clip planes: %.2f to %.2f\n", near, far);
+}
+```
+
+## 相关文档
+
+- [CameraComponent](camera-component.md) - 摄像机组件
+- [SetNearClipPlane](set-near-clip-plane.md) - 设置近裁剪平面
+- [GetFarClipPlane](get-far-clip-plane.md) - 获取远裁剪平面

docs/api/components/camera-component/get-orthographic-size.md

@@ -0,0 +1,37 @@
+# GetOrthographicSize
+
+**所属类**: `CameraComponent`
+
+**头文件**: `XCEngine/Components/CameraComponent.h`
+
+**描述**: 获取摄像机的正交投影大小（仅在正交投影模式下有效）。
+
+## 函数签名
+
+```cpp
+float GetOrthographicSize() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `float` | 正交投影大小，默认值为 5.0 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/CameraComponent.h>
+
+using namespace XCEngine::Components;
+
+void PrintOrthoSize(CameraComponent* camera) {
+    float size = camera->GetOrthographicSize();
+    printf("Orthographic size: %.2f\n", size);
+}
+```
+
+## 相关文档
+
+- [CameraComponent](camera-component.md) - 摄像机组件
+- [SetOrthographicSize](set-orthographic-size.md) - 设置正交大小

docs/api/components/camera-component/get-projection-type.md

@@ -0,0 +1,40 @@
+# GetProjectionType
+
+**所属类**: `CameraComponent`
+
+**头文件**: `XCEngine/Components/CameraComponent.h`
+
+**描述**: 获取摄像机的投影类型。
+
+## 函数签名
+
+```cpp
+CameraProjectionType GetProjectionType() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `CameraProjectionType` | 投影类型，可能是 `Perspective`（透视）或 `Orthographic`（正交） |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/CameraComponent.h>
+
+using namespace XCEngine::Components;
+
+void CheckProjection(CameraComponent* camera) {
+    if (camera->GetProjectionType() == CameraProjectionType::Perspective) {
+        printf("Using perspective projection\n");
+    } else {
+        printf("Using orthographic projection\n");
+    }
+}
+```
+
+## 相关文档
+
+- [CameraComponent](camera-component.md) - 摄像机组件
+- [SetProjectionType](set-projection-type.md) - 设置投影类型

docs/api/components/camera-component/is-primary.md

@@ -0,0 +1,38 @@
+# IsPrimary
+
+**所属类**: `CameraComponent`
+
+**头文件**: `XCEngine/Components/CameraComponent.h`
+
+**描述**: 检查摄像机是否为主摄像机。
+
+## 函数签名
+
+```cpp
+bool IsPrimary() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `bool` | true 表示为主摄像机，false 表示非主摄像机 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/CameraComponent.h>
+
+using namespace XCEngine::Components;
+
+void CheckPrimaryCamera(CameraComponent* camera) {
+    if (camera->IsPrimary()) {
+        printf("This is the primary camera\n");
+    }
+}
+```
+
+## 相关文档
+
+- [CameraComponent](camera-component.md) - 摄像机组件
+- [SetPrimary](set-primary.md) - 设置为主摄像机

docs/api/components/camera-component/set-clear-color.md

@@ -0,0 +1,41 @@
+# SetClearColor
+
+**所属类**: `CameraComponent`
+
+**头文件**: `XCEngine/Components/CameraComponent.h`
+
+**描述**: 设置摄像机的清除颜色。
+
+## 函数签名
+
+```cpp
+void SetClearColor(const Math::Color& value);
+```
+
+## 参数
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `value` | `const Math::Color&` | 清除颜色引用 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/CameraComponent.h>
+#include <XCEngine/Core/Math/Color.h>
+
+using namespace XCEngine::Components;
+
+void SetupClearColor(CameraComponent* camera) {
+    // 设置为黑色
+    camera->SetClearColor(Math::Color::Black());
+
+    // 设置为天蓝色
+    camera->SetClearColor(Math::Color(0.5f, 0.8f, 1.0f, 1.0f));
+}
+```
+
+## 相关文档
+
+- [CameraComponent](camera-component.md) - 摄像机组件
+- [GetClearColor](get-clear-color.md) - 获取清除颜色

docs/api/components/camera-component/set-depth.md

@@ -0,0 +1,37 @@
+# SetDepth
+
+**所属类**: `CameraComponent`
+
+**头文件**: `XCEngine/Components/CameraComponent.h`
+
+**描述**: 设置摄像机的深度值，用于确定渲染顺序。
+
+## 函数签名
+
+```cpp
+void SetDepth(float value);
+```
+
+## 参数
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `value` | `float` | 深度值，值越大越晚渲染（显示在前面） |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/CameraComponent.h>
+
+using namespace XCEngine::Components;
+
+void SetupCameraOrder(CameraComponent* mainCam, CameraComponent* uiCam) {
+    mainCam->SetDepth(0.0f);   // 主摄像机先渲染
+    uiCam->SetDepth(1.0f);      // UI摄像机后渲染
+}
+```
+
+## 相关文档
+
+- [CameraComponent](camera-component.md) - 摄像机组件
+- [GetDepth](get-depth.md) - 获取深度值

docs/api/components/camera-component/set-far-clip-plane.md

@@ -0,0 +1,36 @@
+# SetFarClipPlane
+
+**所属类**: `CameraComponent`
+
+**头文件**: `XCEngine/Components/CameraComponent.h`
+
+**描述**: 设置摄像机的远裁剪平面距离。
+
+## 函数签名
+
+```cpp
+void SetFarClipPlane(float value);
+```
+
+## 参数
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `value` | `float` | 远裁剪平面距离，必须大于近裁剪平面 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/CameraComponent.h>
+
+using namespace XCEngine::Components;
+
+void SetupFarPlane(CameraComponent* camera) {
+    camera->SetFarClipPlane(5000.0f);  // 5公里
+}
+```
+
+## 相关文档
+
+- [CameraComponent](camera-component.md) - 摄像机组件
+- [GetFarClipPlane](get-far-clip-plane.md) - 获取远裁剪平面

docs/api/components/camera-component/set-field-of-view.md

@@ -0,0 +1,43 @@
+# SetFieldOfView
+
+**所属类**: `CameraComponent`
+
+**头文件**: `XCEngine/Components/CameraComponent.h`
+
+**描述**: 设置摄像机的视场角（仅在透视投影模式下有效）。
+
+## 函数签名
+
+```cpp
+void SetFieldOfView(float value);
+```
+
+## 参数
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `value` | `float` | 视场角，单位度，通常在 30.0 到 120.0 之间 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/CameraComponent.h>
+
+using namespace XCEngine::Components;
+
+void SetupCameraFOV(CameraComponent* camera) {
+    // 宽广视野（FPS游戏）
+    camera->SetFieldOfView(90.0f);
+
+    // 窄视野（狙击视角）
+    camera->SetFieldOfView(30.0f);
+
+    // 标准视野
+    camera->SetFieldOfView(60.0f);
+}
+```
+
+## 相关文档
+
+- [CameraComponent](camera-component.md) - 摄像机组件
+- [GetFieldOfView](get-field-of-view.md) - 获取视场角

docs/api/components/camera-component/set-near-clip-plane.md

@@ -0,0 +1,36 @@
+# SetNearClipPlane
+
+**所属类**: `CameraComponent`
+
+**头文件**: `XCEngine/Components/CameraComponent.h`
+
+**描述**: 设置摄像机的近裁剪平面距离。
+
+## 函数签名
+
+```cpp
+void SetNearClipPlane(float value);
+```
+
+## 参数
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `value` | `float` | 近裁剪平面距离，必须大于 0 且小于远裁剪平面 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/CameraComponent.h>
+
+using namespace XCEngine::Components;
+
+void SetupNearPlane(CameraComponent* camera) {
+    camera->SetNearClipPlane(0.5f);  // 50厘米
+}
+```
+
+## 相关文档
+
+- [CameraComponent](camera-component.md) - 摄像机组件
+- [GetNearClipPlane](get-near-clip-plane.md) - 获取近裁剪平面

docs/api/components/camera-component/set-orthographic-size.md

@@ -0,0 +1,37 @@
+# SetOrthographicSize
+
+**所属类**: `CameraComponent`
+
+**头文件**: `XCEngine/Components/CameraComponent.h`
+
+**描述**: 设置摄像机的正交投影大小（仅在正交投影模式下有效）。
+
+## 函数签名
+
+```cpp
+void SetOrthographicSize(float value);
+```
+
+## 参数
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `value` | `float` | 正交投影大小，表示视口半高度 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/CameraComponent.h>
+
+using namespace XCEngine::Components;
+
+void SetupOrthoCamera(CameraComponent* camera) {
+    camera->SetProjectionType(CameraProjectionType::Orthographic);
+    camera->SetOrthographicSize(5.0f);  // 视口高度为10个单位
+}
+```
+
+## 相关文档
+
+- [CameraComponent](camera-component.md) - 摄像机组件
+- [GetOrthographicSize](get-orthographic-size.md) - 获取正交大小

docs/api/components/camera-component/set-primary.md

@@ -0,0 +1,36 @@
+# SetPrimary
+
+**所属类**: `CameraComponent`
+
+**头文件**: `XCEngine/Components/CameraComponent.h`
+
+**描述**: 设置摄像机是否为主摄像机。
+
+## 函数签名
+
+```cpp
+void SetPrimary(bool value);
+```
+
+## 参数
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `value` | `bool` | true 设置为主摄像机，false 取消主摄像机 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/CameraComponent.h>
+
+using namespace XCEngine::Components;
+
+void SetupMainCamera(CameraComponent* camera) {
+    camera->SetPrimary(true);
+}
+```
+
+## 相关文档
+
+- [CameraComponent](camera-component.md) - 摄像机组件
+- [IsPrimary](is-primary.md) - 检查是否为主摄像机

docs/api/components/camera-component/set-projection-type.md

@@ -0,0 +1,40 @@
+# SetProjectionType
+
+**所属类**: `CameraComponent`
+
+**头文件**: `XCEngine/Components/CameraComponent.h`
+
+**描述**: 设置摄像机的投影类型。
+
+## 函数签名
+
+```cpp
+void SetProjectionType(CameraProjectionType type);
+```
+
+## 参数
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `type` | `CameraProjectionType` | 投影类型：`Perspective`（透视）或 `Orthographic`（正交） |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/CameraComponent.h>
+
+using namespace XCEngine::Components;
+
+void SetupCamera(CameraComponent* camera) {
+    // 透视投影（3D游戏）
+    camera->SetProjectionType(CameraProjectionType::Perspective);
+
+    // 正交投影（2D游戏或UI）
+    camera->SetProjectionType(CameraProjectionType::Orthographic);
+}
+```
+
+## 相关文档
+
+- [CameraComponent](camera-component.md) - 摄像机组件
+- [GetProjectionType](get-projection-type.md) - 获取投影类型