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/audio-listener-component/get-doppler-level.md

@@ -33,5 +33,5 @@ void PrintDopplerLevel(AudioListenerComponent* listener) {
 
 ## 相关文档
 
-- [AudioListenerComponent](./audio-listener-component.md) - 音频监听器组件
+- [AudioListenerComponent](audio-listener-component.md) - 音频监听器组件
-- [SetDopplerLevel](./set-doppler-level.md) - 设置多普勒等级
+- [SetDopplerLevel](set-doppler-level.md) - 设置多普勒等级

docs/api/components/audio-listener-component/get-energy.md

@@ -33,5 +33,5 @@ void CheckAudioEnergy(AudioListenerComponent* listener) {
 
 ## 相关文档
 
-- [AudioListenerComponent](./audio-listener-component.md) - 音频监听器组件
+- [AudioListenerComponent](audio-listener-component.md) - 音频监听器组件
-- [GetFrequencyData](./get-frequency-data.md) - 获取频谱数据
+- [GetFrequencyData](get-frequency-data.md) - 获取频谱数据

docs/api/components/audio-listener-component/get-frequency-data-size.md

@@ -33,5 +33,5 @@ void CheckSpectrumSize(AudioListenerComponent* listener) {
 
 ## 相关文档
 
-- [AudioListenerComponent](./audio-listener-component.md) - 音频监听器组件
+- [AudioListenerComponent](audio-listener-component.md) - 音频监听器组件
-- [GetFrequencyData](./get-frequency-data.md) - 获取频谱数据
+- [GetFrequencyData](get-frequency-data.md) - 获取频谱数据

docs/api/components/audio-listener-component/get-frequency-data.md

@@ -38,6 +38,6 @@ void ProcessFrequencyData(AudioListenerComponent* listener) {
 
 ## 相关文档
 
-- [AudioListenerComponent](./audio-listener-component.md) - 音频监听器组件
+- [AudioListenerComponent](audio-listener-component.md) - 音频监听器组件
-- [GetFrequencyDataSize](./get-frequency-data-size.md) - 获取频谱数据大小
+- [GetFrequencyDataSize](get-frequency-data-size.md) - 获取频谱数据大小
-- [GetEnergy](./get-energy.md) - 获取音频能量
+- [GetEnergy](get-energy.md) - 获取音频能量

docs/api/components/audio-listener-component/get-reverb-level.md

@@ -33,5 +33,5 @@ void PrintReverbLevel(AudioListenerComponent* listener) {
 
 ## 相关文档
 
-- [AudioListenerComponent](./audio-listener-component.md) - 音频监听器组件
+- [AudioListenerComponent](audio-listener-component.md) - 音频监听器组件
-- [SetReverbLevel](./set-reverb-level.md) - 设置混响等级
+- [SetReverbLevel](set-reverb-level.md) - 设置混响等级

docs/api/components/audio-listener-component/get-reverb.md

@@ -38,5 +38,5 @@ void CheckReverb(AudioListenerComponent* listener) {
 
 ## 相关文档
 
-- [AudioListenerComponent](./audio-listener-component.md) - 音频监听器组件
+- [AudioListenerComponent](audio-listener-component.md) - 音频监听器组件
-- [SetReverb](./set-reverb.md) - 设置混响效果器
+- [SetReverb](set-reverb.md) - 设置混响效果器

docs/api/components/audio-listener-component/get-speed-of-sound.md

@@ -33,5 +33,5 @@ void PrintSpeedOfSound(AudioListenerComponent* listener) {
 
 ## 相关文档
 
-- [AudioListenerComponent](./audio-listener-component.md) - 音频监听器组件
+- [AudioListenerComponent](audio-listener-component.md) - 音频监听器组件
-- [SetSpeedOfSound](./set-speed-of-sound.md) - 设置声速
+- [SetSpeedOfSound](set-speed-of-sound.md) - 设置声速

docs/api/components/audio-listener-component/is-mute.md

@@ -36,5 +36,5 @@ void CheckMuteStatus(AudioListenerComponent* listener) {
 
 ## 相关文档
 
-- [AudioListenerComponent](./audio-listener-component.md) - 音频监听器组件
+- [AudioListenerComponent](audio-listener-component.md) - 音频监听器组件
-- [SetMute](./set-mute.md) - 设置静音状态
+- [SetMute](set-mute.md) - 设置静音状态

docs/api/components/audio-listener-component/set-doppler-level.md

@@ -39,6 +39,6 @@ void SetupDoppler(AudioListenerComponent* listener) {
 
 ## 相关文档
 
-- [AudioListenerComponent](./audio-listener-component.md) - 音频监听器组件
+- [AudioListenerComponent](audio-listener-component.md) - 音频监听器组件
-- [GetDopplerLevel](./get-doppler-level.md) - 获取多普勒等级
+- [GetDopplerLevel](get-doppler-level.md) - 获取多普勒等级
-- [SetSpeedOfSound](./set-speed-of-sound.md) - 设置声速
+- [SetSpeedOfSound](set-speed-of-sound.md) - 设置声速

docs/api/components/audio-listener-component/set-mute.md

@@ -33,5 +33,5 @@ void ToggleMute(AudioListenerComponent* listener) {
 
 ## 相关文档
 
-- [AudioListenerComponent](./audio-listener-component.md) - 音频监听器组件
+- [AudioListenerComponent](audio-listener-component.md) - 音频监听器组件
-- [IsMute](./is-mute.md) - 检查静音状态
+- [IsMute](is-mute.md) - 检查静音状态

docs/api/components/audio-listener-component/set-reverb-level.md

@@ -39,6 +39,6 @@ void SetupReverb(AudioListenerComponent* listener) {
 
 ## 相关文档
 
-- [AudioListenerComponent](./audio-listener-component.md) - 音频监听器组件
+- [AudioListenerComponent](audio-listener-component.md) - 音频监听器组件
-- [GetReverbLevel](./get-reverb-level.md) - 获取混响等级
+- [GetReverbLevel](get-reverb-level.md) - 获取混响等级
-- [SetReverb](./set-reverb.md) - 设置混响效果器
+- [SetReverb](set-reverb.md) - 设置混响效果器

docs/api/components/audio-listener-component/set-reverb.md

@@ -35,6 +35,6 @@ void SetupReverbEffect(AudioListenerComponent* listener, AudioMixer* reverbMixer
 
 ## 相关文档
 
-- [AudioListenerComponent](./audio-listener-component.md) - 音频监听器组件
+- [AudioListenerComponent](audio-listener-component.md) - 音频监听器组件
-- [GetReverb](./get-reverb.md) - 获取混响效果器
+- [GetReverb](get-reverb.md) - 获取混响效果器
-- [SetReverbLevel](./set-reverb-level.md) - 设置混响等级
+- [SetReverbLevel](set-reverb-level.md) - 设置混响等级

docs/api/components/audio-listener-component/set-speed-of-sound.md

@@ -36,6 +36,6 @@ void SetupSpeedOfSound(AudioListenerComponent* listener) {
 
 ## 相关文档
 
-- [AudioListenerComponent](./audio-listener-component.md) - 音频监听器组件
+- [AudioListenerComponent](audio-listener-component.md) - 音频监听器组件
-- [GetSpeedOfSound](./get-speed-of-sound.md) - 获取声速
+- [GetSpeedOfSound](get-speed-of-sound.md) - 获取声速
-- [SetDopplerLevel](./set-doppler-level.md) - 设置多普勒等级
+- [SetDopplerLevel](set-doppler-level.md) - 设置多普勒等级

docs/api/components/audio-source-component/audio-source-component.md

@@ -78,7 +78,7 @@ AudioSourceComponent 是 XCEngine ECS 系统中的音频源组件，用于在场
 
 | 方法 | 描述 |
 |------|------|
-| [`GetEnergy`](get-energy.md) | 获取当前能量值 |
+| [`GetEnergy`](../audio-listener-component/get-energy.md) | 获取当前能量值 |
 | [`StartEnergyDetect`](start-energy-detect.md) | 开始能量检测 |
 | [`StopEnergyDetect`](stop-energy-detect.md) | 停止能量检测 |
 | [`IsEnergyDetecting`](is-energy-detecting.md) | 检查是否正在能量检测 |

docs/api/components/audio-source-component/get-3d-params.md

@@ -34,5 +34,5 @@ void Print3DParams(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [Set3DParams](./set-3d-params.md) - 设置3D参数
+- [Set3DParams](../../audio/audio-mixer/set-3d-params.md) - 设置3D参数

docs/api/components/audio-source-component/get-clip.md

@@ -37,5 +37,5 @@ void CheckCurrentClip(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [SetClip](./set-clip.md) - 设置音频片段
+- [SetClip](set-clip.md) - 设置音频片段

docs/api/components/audio-source-component/get-doppler-level.md

@@ -33,5 +33,5 @@ void PrintDopplerLevel(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [SetDopplerLevel](./set-doppler-level.md) - 设置多普勒等级
+- [SetDopplerLevel](set-doppler-level.md) - 设置多普勒等级

docs/api/components/audio-source-component/get-duration.md

@@ -33,6 +33,6 @@ void PrintDuration(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [GetTime](./get-time.md) - 获取当前播放位置
+- [GetTime](get-time.md) - 获取当前播放位置
-- [SetClip](./set-clip.md) - 设置音频片段
+- [SetClip](set-clip.md) - 设置音频片段

docs/api/components/audio-source-component/get-output-mixer.md

@@ -37,5 +37,5 @@ void CheckOutputMixer(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [SetOutputMixer](./set-output-mixer.md) - 设置输出混音器
+- [SetOutputMixer](../../audio/audio-mixer/set-output-mixer.md) - 设置输出混音器

docs/api/components/audio-source-component/get-pan.md

@@ -33,5 +33,5 @@ void PrintPan(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [SetPan](./set-pan.md) - 设置平移值
+- [SetPan](set-pan.md) - 设置平移值

docs/api/components/audio-source-component/get-pitch.md

@@ -33,5 +33,5 @@ void PrintPitch(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [SetPitch](./set-pitch.md) - 设置音高
+- [SetPitch](set-pitch.md) - 设置音高

docs/api/components/audio-source-component/get-reverb-zone-mix.md

@@ -33,5 +33,5 @@ void PrintReverbZoneMix(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [SetReverbZoneMix](./set-reverb-zone-mix.md) - 设置混响混合比例
+- [SetReverbZoneMix](set-reverb-zone-mix.md) - 设置混响混合比例

docs/api/components/audio-source-component/get-spread.md

@@ -33,5 +33,5 @@ void PrintSpread(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [SetSpread](./set-spread.md) - 设置扩散角度
+- [SetSpread](set-spread.md) - 设置扩散角度

docs/api/components/audio-source-component/get-time.md

@@ -34,6 +34,6 @@ void PrintCurrentTime(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [SetTime](./set-time.md) - 设置播放位置
+- [SetTime](set-time.md) - 设置播放位置
-- [GetDuration](./get-duration.md) - 获取总时长
+- [GetDuration](get-duration.md) - 获取总时长

docs/api/components/audio-source-component/get-volume.md

@@ -33,5 +33,5 @@ void PrintVolume(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [SetVolume](./set-volume.md) - 设置音量
+- [SetVolume](../../audio/audio-mixer/set-volume.md) - 设置音量

docs/api/components/audio-source-component/is-energy-detecting.md

@@ -35,7 +35,7 @@ void CheckEnergyDetection(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [StartEnergyDetect](./start-energy-detect.md) - 开始能量检测
+- [StartEnergyDetect](start-energy-detect.md) - 开始能量检测
-- [StopEnergyDetect](./stop-energy-detect.md) - 停止能量检测
+- [StopEnergyDetect](stop-energy-detect.md) - 停止能量检测
-- [GetEnergy](./get-energy.md) - 获取当前能量值
+- [GetEnergy](../audio-listener-component/get-energy.md) - 获取当前能量值

docs/api/components/audio-source-component/is-looping.md

@@ -34,5 +34,5 @@ void CheckLoopingStatus(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [SetLooping](./set-looping.md) - 设置循环播放
+- [SetLooping](set-looping.md) - 设置循环播放

docs/api/components/audio-source-component/is-paused.md

@@ -34,5 +34,5 @@ void CheckPausedStatus(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [IsPlaying](./is-playing.md) - 检查是否正在播放
+- [IsPlaying](is-playing.md) - 检查是否正在播放

docs/api/components/audio-source-component/is-playing.md

@@ -36,5 +36,5 @@ void CheckPlayingStatus(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [IsPaused](./is-paused.md) - 检查是否暂停
+- [IsPaused](is-paused.md) - 检查是否暂停

docs/api/components/audio-source-component/is-spatialize.md

@@ -34,5 +34,5 @@ void CheckSpatializeStatus(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [SetSpatialize](./set-spatialize.md) - 设置空间化
+- [SetSpatialize](set-spatialize.md) - 设置空间化

docs/api/components/audio-source-component/pause.md

@@ -26,6 +26,6 @@ void PauseAudio(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [Play](./play.md) - 开始播放
+- [Play](play.md) - 开始播放
-- [Stop](./stop.md) - 停止播放
+- [Stop](stop.md) - 停止播放

docs/api/components/audio-source-component/play.md

@@ -26,6 +26,6 @@ void StartPlayback(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [Pause](./pause.md) - 暂停播放
+- [Pause](pause.md) - 暂停播放
-- [Stop](./stop.md) - 停止播放
+- [Stop](stop.md) - 停止播放

docs/api/components/audio-source-component/set-clip.md

@@ -35,5 +35,5 @@ void LoadAndPlaySound(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [GetClip](./get-clip.md) - 获取当前音频片段
+- [GetClip](get-clip.md) - 获取当前音频片段

docs/api/components/audio-source-component/set-doppler-level.md

@@ -32,5 +32,5 @@ void SetupDoppler(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [GetDopplerLevel](./get-doppler-level.md) - 获取多普勒等级
+- [GetDopplerLevel](get-doppler-level.md) - 获取多普勒等级

docs/api/components/audio-source-component/set-looping.md

@@ -32,5 +32,5 @@ void SetupLooping(AudioSourceComponent* source, bool shouldLoop) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [IsLooping](./is-looping.md) - 检查是否循环播放
+- [IsLooping](is-looping.md) - 检查是否循环播放

docs/api/components/audio-source-component/set-pan.md

@@ -39,5 +39,5 @@ void SetupPan(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [GetPan](./get-pan.md) - 获取平移值
+- [GetPan](get-pan.md) - 获取平移值

docs/api/components/audio-source-component/set-pitch.md

@@ -39,5 +39,5 @@ void SetupPitch(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [GetPitch](./get-pitch.md) - 获取音高
+- [GetPitch](get-pitch.md) - 获取音高

docs/api/components/audio-source-component/set-reverb-zone-mix.md

@@ -39,5 +39,5 @@ void SetupReverbZoneMix(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [GetReverbZoneMix](./get-reverb-zone-mix.md) - 获取混响混合比例
+- [GetReverbZoneMix](get-reverb-zone-mix.md) - 获取混响混合比例

docs/api/components/audio-source-component/set-spatialize.md

@@ -36,5 +36,5 @@ void SetupSpatialize(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [IsSpatialize](./is-spatialize.md) - 检查是否启用空间化
+- [IsSpatialize](is-spatialize.md) - 检查是否启用空间化

docs/api/components/audio-source-component/set-spread.md

@@ -39,5 +39,5 @@ void SetupSpread(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [GetSpread](./get-spread.md) - 获取扩散角度
+- [GetSpread](get-spread.md) - 获取扩散角度

docs/api/components/audio-source-component/set-time.md

@@ -36,6 +36,6 @@ void RewindToStart(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [GetTime](./get-time.md) - 获取当前播放位置
+- [GetTime](get-time.md) - 获取当前播放位置
-- [GetDuration](./get-duration.md) - 获取总时长
+- [GetDuration](get-duration.md) - 获取总时长

docs/api/components/audio-source-component/start-energy-detect.md

@@ -26,7 +26,7 @@ void BeginEnergyDetection(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [StopEnergyDetect](./stop-energy-detect.md) - 停止能量检测
+- [StopEnergyDetect](stop-energy-detect.md) - 停止能量检测
-- [IsEnergyDetecting](./is-energy-detecting.md) - 检查是否正在检测
+- [IsEnergyDetecting](is-energy-detecting.md) - 检查是否正在检测
-- [GetEnergy](./get-energy.md) - 获取当前能量值
+- [GetEnergy](../audio-listener-component/get-energy.md) - 获取当前能量值

docs/api/components/audio-source-component/stop-energy-detect.md

@@ -26,6 +26,6 @@ void EndEnergyDetection(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [StartEnergyDetect](./start-energy-detect.md) - 开始能量检测
+- [StartEnergyDetect](start-energy-detect.md) - 开始能量检测
-- [IsEnergyDetecting](./is-energy-detecting.md) - 检查是否正在检测
+- [IsEnergyDetecting](is-energy-detecting.md) - 检查是否正在检测

docs/api/components/audio-source-component/stop.md

@@ -37,6 +37,6 @@ void FadeOutAndStop(AudioSourceComponent* source) {
 
 ## 相关文档
 
-- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [AudioSourceComponent](audio-source-component.md) - 音频源组件
-- [Play](./play.md) - 开始播放
+- [Play](play.md) - 开始播放
-- [Pause](./pause.md) - 暂停播放
+- [Pause](pause.md) - 暂停播放

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) - 获取投影类型

docs/api/math/aabb/aabb.md

@@ -56,7 +56,7 @@ Vector3 max = obb.GetMax();
 
 ## 相关文档
 
-- [Bounds](bounds/bounds.md) - 轴对齐包围盒
+- [Bounds](../bounds/bounds.md) - 轴对齐包围盒
-- [Vector3](vector3/vector3.md) - 三维向量
+- [Vector3](../vector3/vector3.md) - 三维向量
-- [Matrix4](matrix4/matrix4.md) - 4x4 变换矩阵
+- [Matrix4](../matrix4/matrix4.md) - 4x4 变换矩阵
-- [Sphere](sphere/sphere.md) - 球体
+- [Sphere](../sphere/sphere.md) - 球体

docs/api/resources/asyncloader/asyncloader.md

@@ -4,7 +4,7 @@
 
 **类型**: `class` (singleton)
 
-**头文件**: `XCEngine/Resources/AsyncLoader.h`
+**头文件**: `XCEngine/Core/Asset/AsyncLoader.h`
 
 **描述**: 异步资源加载器单例，负责多线程后台资源加载和完成回调调度。
 

docs/api/resources/audioclip/audioclip.md

@@ -4,7 +4,7 @@
 
 **类型**: `class`
 
-**头文件**: `XCEngine/Resources/AudioClip.h`
+**头文件**: `XCEngine/Resources/AudioClip/AudioClip.h`
 
 **描述**: 音频片段资源类，管理音频样本数据、格式信息和播放参数。
 
@@ -15,7 +15,7 @@
 ## 头文件
 
 ```cpp
-#include <XCEngine/Resources/AudioClip.h>
+#include <XCEngine/Resources/AudioClip/AudioClip.h>
 ```
 
 ## 枚举类型
@@ -119,7 +119,7 @@
 ## 使用示例
 
 ```cpp
-#include <XCEngine/Resources/AudioClip.h>
+#include <XCEngine/Resources/AudioClip/AudioClip.h>
 #include <XCEngine/Resources/ResourceManager.h>
 
 using namespace XCEngine::Resources;
@@ -149,5 +149,5 @@ bool loop = sfx->IsLoop();
 ## 相关文档
 
 - [IResource](../iresource/iresource.md) - 资源基类
-- [ResourceManager](../resourcemanager/resourcemanager.md) - 资源管理器
+- [ResourceManager](../resource-manager/resource-manager.md) - 资源管理器
 - [Resources 总览](../resources.md) - 返回模块总览

docs/api/resources/filearchive/filearchive.md

@@ -4,7 +4,7 @@
 
 **类型**: `class`
 
-**头文件**: `XCEngine/Resources/FileArchive.h`
+**头文件**: `XCEngine/Core/IO/FileArchive.h`
 
 **继承自**: `IArchive`
 
@@ -39,7 +39,7 @@ IArchive
 ## 使用示例
 
 ```cpp
-#include <XCEngine/Resources/FileArchive.h>
+#include <XCEngine/Core/IO/FileArchive.h>
 
 // 创建并打开归档
 FileArchive archive;
@@ -71,5 +71,5 @@ if (archive.Open("resources/textures/")) {
 ## 相关文档
 
 - [Resources 模块总览](../resources.md) - 返回模块总览
-- [IArchive](../resourcefilesystem/resourcefilesystem.md) - 归档接口定义
+- [IArchive](../resource-file-system/iarchive.md) - 归档接口定义
-- [ResourceFileSystem](../resourcefilesystem/resourcefilesystem.md) - 资源文件系统
+- [ResourceFileSystem](../resource-file-system/index.md) - 资源文件系统

docs/api/resources/material/material.md

@@ -160,5 +160,5 @@ mat->Release();
 - [IResource](../iresource/iresource.md) - 资源基类接口
 - [Shader](../shader/shader.md) - 着色器资源
 - [Texture](../texture/texture.md) - 纹理资源
-- [ResourceHandle](../resourcehandle/resourcehandle.md) - 资源句柄
+- [ResourceHandle](../resourcehandle.md) - 资源句柄
 - [Resources 模块总览](../resources.md) - 返回模块总览

docs/api/resources/mesh-import-settings/mesh-import-settings.md

@@ -97,5 +97,5 @@ ResourceHandle<Mesh> mesh = ResourceManager::Get().Load<Mesh>("models/player.fbx
 
 - [ImportSettings](../importsettings/importsettings.md) - 导入设置基类
 - [IResourceLoader](../iloader/iloader.md) - 资源加载器接口
-- [ResourceManager](../resourcemanager/resourcemanager.md) - 资源管理器
+- [ResourceManager](../resource-manager/resource-manager.md) - 资源管理器
 - [Resources 总览](../resources.md) - 资源模块总览

docs/api/resources/resource-dependency-graph/index.md

@@ -48,7 +48,7 @@
 ## 使用示例
 
 ```cpp
-#include "Resources/ResourceDependencyGraph.h"
+#include <XCEngine/Core/Asset/ResourceDependencyGraph.h>
 
 using namespace XCEngine;
 using namespace Resources;

docs/api/resources/resource-manager/resource-manager.md

@@ -159,8 +159,8 @@ resMgr.Shutdown();
 
 ## 相关文档
 
-- [IResourceLoader](iloader/iloader.md) - 资源加载器接口
+- [IResourceLoader](../iloader/iloader.md) - 资源加载器接口
-- [AsyncLoader](asyncloader/asyncloader.md) - 异步加载器
+- [AsyncLoader](../asyncloader/asyncloader.md) - 异步加载器
-- [ResourceCache](resourcecache.md) - 资源缓存
+- [ResourceCache](../resourcecache.md) - 资源缓存
-- [ResourceHandle](resourcehandle.md) - 资源句柄
+- [ResourceHandle](../resourcehandle.md) - 资源句柄
-- [Resources 总览](resources.md) - 返回模块总览
+- [Resources 总览](../resources.md) - 返回模块总览

docs/api/resources/resource-package/index.md

@@ -50,7 +50,7 @@ ResourcePackage 提供了一套完整的资源包读取接口，包括打开/关
 ## 使用示例
 
 ```cpp
-#include "Resources/ResourcePackage.h"
+#include <XCEngine/Core/IO/ResourcePackage.h>
 
 using namespace XCEngine;
 using namespace XCEngine::Containers;

docs/api/resources/texture-loader/index.md

@@ -15,7 +15,7 @@
 ## 头文件
 
 ```cpp
-#include <XCEngine/Resources/TextureLoader.h>
+#include <XCEngine/Resources/Texture/TextureLoader.h>
 ```
 
 ## 支持的格式
@@ -114,8 +114,8 @@ ImportSettings* GetDefaultSettings() const override
 ## 使用示例
 
 ```cpp
-#include <XCEngine/Resources/TextureLoader.h>
+#include <XCEngine/Resources/Texture/TextureLoader.h>
-#include <XCEngine/Resources/ResourceManager.h>
+#include <XCEngine/Core/Asset/ResourceManager.h>
 
 using namespace XCEngine::Resources;
 

docs/api/rhi/opengl/render-target-view/render-target-view.md

@@ -44,8 +44,6 @@ struct OpenGLRenderTargetViewDesc {
 | [`GetFramebuffer`](get-framebuffer.md) | 获取帧缓冲 |
 | [`GetTexture`](get-texture.md) | 获取纹理 |
 | [`GetMipLevel`](get-mip-level.md) | 获取 Mip 级别 |
-| [`GetWidth`](get-size.md) | 获取宽度 |
-| [`GetHeight`](get-height.md) | 获取高度 |
 | [`BindFramebuffer`](bind-framebuffer.md) | 绑定帧缓冲 |
 | [`UnbindFramebuffer`](unbind-framebuffer.md) | 解绑帧缓冲 |
 

docs/api/scene/scene/scene.md

@@ -45,7 +45,7 @@ Scene 是 XCEngine 中的场景类，代表一个独立的游戏空间（如主
 | [`FindByID`](find-by-id.md) | 按 ID 查找 GameObject |
 | [`FindGameObjectWithTag`](find-game-object-with-tag.md) | 按标签查找 GameObject |
 | [`FindObjectOfType`](find-object-of-type.md) | 查找指定类型的组件 |
-| [`FindObjectsOfType`](find-objects-of-type.md) | 查找所有指定类型的组件 |
+| [`FindObjectsOfType`](../../components/game-object/find-objects-of-type.md) | 查找所有指定类型的组件 |
 | [`GetRootGameObjects`](get-root-game-objects.md) | 获取所有根对象 |
 
 ### 生命周期