docs: fix README.md project structure to match actual codebase

Engine modules:
- Audio: remove AudioSource/Listener components (they belong in Components/), add IAudioEffect.h
- Components: add AudioSourceComponent.h and AudioListenerComponent.h
- Math: remove non-existent OBB.h
- Resources: fix DependencyGraph.h -> ResourceDependencyGraph.h
- Threading: add TaskSystemConfig.h
- RHI: remove incorrect RHIDescriptor.h (already covered by RHIDescriptorPool.h)

Backend fixes:
- OpenGL: add OpenGLScreenshot.h
- D3D12: fix file order (D3D12Enum.h before D3D12Types.h)

docs/api/resources/texture-import-settings/clone.md

@@ -0,0 +1,25 @@
+# TextureImportSettings::Clone
+
+```cpp
+Core::UniqueRef<ImportSettings> Clone() const override;
+```
+
+创建并返回一份当前设置的深拷贝。
+
+**返回：** `Core::UniqueRef<ImportSettings>` - 新的 `TextureImportSettings` 克隆
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+settings.SetTextureType(TextureType::Texture2D);
+
+auto cloned = settings.Clone();
+// cloned 是独立的副本，修改不影响原对象
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览

docs/api/resources/texture-import-settings/getbordercolor.md

@@ -0,0 +1,3 @@
+# TextureImportSettings::GetBorderColor
+
+参见 [`SetBorderColor`](setbordercolor.md)

docs/api/resources/texture-import-settings/getcompressionquality.md

@@ -0,0 +1,3 @@
+# TextureImportSettings::GetCompressionQuality
+
+参见 [`SetCompressionQuality`](setcompressionquality.md)

docs/api/resources/texture-import-settings/getfliphhorizontal.md

@@ -0,0 +1,3 @@
+# TextureImportSettings::GetFlipHorizontal
+
+参见 [`SetFlipHorizontal`](setfliphhorizontal.md)

docs/api/resources/texture-import-settings/getflipvertical.md

@@ -0,0 +1,3 @@
+# TextureImportSettings::GetFlipVertical
+
+参见 [`SetFlipVertical`](setflipvertical.md)

docs/api/resources/texture-import-settings/getgeneratemipmaps.md

@@ -0,0 +1,3 @@
+# TextureImportSettings::GetGenerateMipmaps
+
+参见 [`SetGenerateMipmaps`](setgeneratemipmaps.md)

docs/api/resources/texture-import-settings/getgeneratenormalmap.md

@@ -0,0 +1,3 @@
+# TextureImportSettings::GetGenerateNormalMap
+
+参见 [`SetGenerateNormalMap`](setgeneratenormalmap.md)

docs/api/resources/texture-import-settings/getmaxanisotropy.md

@@ -0,0 +1,3 @@
+# TextureImportSettings::GetMaxAnisotropy
+
+参见 [`SetMaxAnisotropy`](setmaxanisotropy.md)

docs/api/resources/texture-import-settings/getmaxsize.md

@@ -0,0 +1,3 @@
+# TextureImportSettings::GetMaxSize
+
+参见 [`SetMaxSize`](setmaxsize.md)

docs/api/resources/texture-import-settings/getmipmapfilter.md

@@ -0,0 +1,3 @@
+# TextureImportSettings::GetMipmapFilter
+
+参见 [`SetMipmapFilter`](setmipmapfilter.md)

docs/api/resources/texture-import-settings/getnormalmapstrength.md

@@ -0,0 +1,3 @@
+# TextureImportSettings::GetNormalMapStrength
+
+参见 [`SetNormalMapStrength`](setnormalmapstrength.md)

docs/api/resources/texture-import-settings/getsrgb.md

@@ -0,0 +1,3 @@
+# TextureImportSettings::GetSRGB
+
+参见 [`SetSRGB`](setsrgb.md)

docs/api/resources/texture-import-settings/gettargetformat.md

@@ -0,0 +1,3 @@
+# TextureImportSettings::GetTargetFormat
+
+参见 [`SetTargetFormat`](settargetformat.md)

docs/api/resources/texture-import-settings/gettexturetype.md

@@ -0,0 +1,3 @@
+# TextureImportSettings::GetTextureType
+
+参见 [`SetTextureType`](settexturetype.md)

docs/api/resources/texture-import-settings/getusehardwarecompression.md

@@ -0,0 +1,3 @@
+# TextureImportSettings::GetUseHardwareCompression
+
+参见 [`SetUseHardwareCompression`](setusehardwarecompression.md)

docs/api/resources/texture-import-settings/loadfromjson.md

@@ -0,0 +1,28 @@
+# TextureImportSettings::LoadFromJSON
+
+```cpp
+bool LoadFromJSON(const Containers::String& json) override;
+```
+
+从 JSON 字符串加载导入设置。
+
+**参数：**
+- `json` - JSON 格式的设置字符串
+
+**返回：** `bool` - 加载是否成功
+
+**注意：** 当前为 stub 实现，始终返回 `false`。
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+bool success = settings.LoadFromJSON(R"({"textureType":1,"sRGB":true})");
+// 当前实现返回 false
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览

docs/api/resources/texture-import-settings/savetojson.md

@@ -0,0 +1,26 @@
+# TextureImportSettings::SaveToJSON
+
+```cpp
+Containers::String SaveToJSON() const override;
+```
+
+将当前设置序列化为 JSON 字符串。
+
+**返回：** `Containers::String` - JSON 格式的设置字符串
+
+**注意：** 当前为 stub 实现，始终返回空字符串。
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+settings.SetSRGB(true);
+Containers::String json = settings.SaveToJSON();
+// 当前实现返回空字符串
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览

docs/api/resources/texture-import-settings/setbordercolor.md

@@ -0,0 +1,27 @@
+# TextureImportSettings::SetBorderColor / GetBorderColor
+
+```cpp
+void SetBorderColor(const Math::Vector3& color);
+const Math::Vector3& GetBorderColor() const;
+```
+
+设置或获取纹理边框颜色。
+
+**参数：**
+- `color` - 边框颜色（RGB）
+
+**返回：** `const Math::Vector3&` / `void`
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+settings.SetBorderColor(Math::Vector3(1.0f, 0.0f, 0.0f)); // 红色边框
+const Math::Vector3& color = settings.GetBorderColor();
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览

docs/api/resources/texture-import-settings/setcompressionquality.md

@@ -0,0 +1,27 @@
+# TextureImportSettings::SetCompressionQuality / GetCompressionQuality
+
+```cpp
+void SetCompressionQuality(CompressionQuality quality);
+CompressionQuality GetCompressionQuality() const;
+```
+
+设置或获取纹理压缩质量级别。
+
+**参数：**
+- `quality` - 压缩质量（`Low`、`Medium`、`High`、`Ultra`）
+
+**返回：** `CompressionQuality` / `void`
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+settings.SetCompressionQuality(CompressionQuality::High);
+CompressionQuality quality = settings.GetCompressionQuality(); // CompressionQuality::High
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览

docs/api/resources/texture-import-settings/setfliphhorizontal.md

@@ -0,0 +1,27 @@
+# TextureImportSettings::SetFlipHorizontal / GetFlipHorizontal
+
+```cpp
+void SetFlipHorizontal(bool flip);
+bool GetFlipHorizontal() const;
+```
+
+设置或获取是否在导入时水平翻转纹理。
+
+**参数：**
+- `flip` - 是否水平翻转
+
+**返回：** `bool` / `void`
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+settings.SetFlipHorizontal(true);
+bool flip = settings.GetFlipHorizontal(); // true
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览

docs/api/resources/texture-import-settings/setflipvertical.md

@@ -0,0 +1,27 @@
+# TextureImportSettings::SetFlipVertical / GetFlipVertical
+
+```cpp
+void SetFlipVertical(bool flip);
+bool GetFlipVertical() const;
+```
+
+设置或获取是否在导入时垂直翻转纹理。
+
+**参数：**
+- `flip` - 是否垂直翻转
+
+**返回：** `bool` / `void`
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+settings.SetFlipVertical(true);
+bool flip = settings.GetFlipVertical(); // true
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览

docs/api/resources/texture-import-settings/setgeneratemipmaps.md

@@ -0,0 +1,27 @@
+# TextureImportSettings::SetGenerateMipmaps / GetGenerateMipmaps
+
+```cpp
+void SetGenerateMipmaps(bool generate);
+bool GetGenerateMipmaps() const;
+```
+
+设置或获取是否生成 Mipmap。
+
+**参数：**
+- `generate` - 是否生成 Mipmap
+
+**返回：** `bool` / `void`
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+settings.SetGenerateMipmaps(true);
+bool generate = settings.GetGenerateMipmaps(); // true
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览

docs/api/resources/texture-import-settings/setgeneratenormalmap.md

@@ -0,0 +1,27 @@
+# TextureImportSettings::SetGenerateNormalMap / GetGenerateNormalMap
+
+```cpp
+void SetGenerateNormalMap(bool generate);
+bool GetGenerateNormalMap() const;
+```
+
+设置或获取是否在导入时生成法线贴图。
+
+**参数：**
+- `generate` - 是否生成法线贴图
+
+**返回：** `bool` / `void`
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+settings.SetGenerateNormalMap(true);
+bool generate = settings.GetGenerateNormalMap(); // true
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览

docs/api/resources/texture-import-settings/setmaxanisotropy.md

@@ -0,0 +1,27 @@
+# TextureImportSettings::SetMaxAnisotropy / GetMaxAnisotropy
+
+```cpp
+void SetMaxAnisotropy(Core::uint32 anisotropy);
+Core::uint32 GetMaxAnisotropy() const;
+```
+
+设置或获取最大各向异性过滤级别。
+
+**参数：**
+- `anisotropy` - 各向异性级别（通常为 1, 2, 4, 8, 16）
+
+**返回：** `Core::uint32` / `void`
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+settings.SetMaxAnisotropy(16);
+Core::uint32 anisotropy = settings.GetMaxAnisotropy(); // 16
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览

docs/api/resources/texture-import-settings/setmaxsize.md

@@ -0,0 +1,27 @@
+# TextureImportSettings::SetMaxSize / GetMaxSize
+
+```cpp
+void SetMaxSize(Core::uint32 size);
+Core::uint32 GetMaxSize() const;
+```
+
+设置或获取最大纹理尺寸。纹理将被缩放以适应此尺寸。
+
+**参数：**
+- `size` - 最大边长（像素）
+
+**返回：** `Core::uint32` / `void`
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+settings.SetMaxSize(2048);
+Core::uint32 size = settings.GetMaxSize(); // 2048
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览

docs/api/resources/texture-import-settings/setmipmapfilter.md

@@ -0,0 +1,27 @@
+# TextureImportSettings::SetMipmapFilter / GetMipmapFilter
+
+```cpp
+void SetMipmapFilter(MipmapFilter filter);
+MipmapFilter GetMipmapFilter() const;
+```
+
+设置或获取 Mipmap 滤波算法。
+
+**参数：**
+- `filter` - Mipmap 滤波器类型（`MipmapFilter::Box` 或 `MipmapFilter::Kaiser`）
+
+**返回：** `MipmapFilter` / `void`
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+settings.SetMipmapFilter(MipmapFilter::Kaiser);
+MipmapFilter filter = settings.GetMipmapFilter(); // MipmapFilter::Kaiser
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览

docs/api/resources/texture-import-settings/setnormalmapstrength.md

@@ -0,0 +1,27 @@
+# TextureImportSettings::SetNormalMapStrength / GetNormalMapStrength
+
+```cpp
+void SetNormalMapStrength(float strength);
+float GetNormalMapStrength() const;
+```
+
+设置或获取法线贴图强度。
+
+**参数：**
+- `strength` - 法线贴图强度系数
+
+**返回：** `float` / `void`
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+settings.SetNormalMapStrength(2.0f);
+float strength = settings.GetNormalMapStrength(); // 2.0f
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览

docs/api/resources/texture-import-settings/setsrgb.md

@@ -0,0 +1,27 @@
+# TextureImportSettings::SetSRGB / GetSRGB
+
+```cpp
+void SetSRGB(bool srgb);
+bool GetSRGB() const;
+```
+
+设置或获取 sRGB 颜色空间标记。
+
+**参数：**
+- `srgb` - 是否使用 sRGB 颜色空间
+
+**返回：** `bool` / `void`
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+settings.SetSRGB(true);
+bool srgb = settings.GetSRGB(); // true
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览

docs/api/resources/texture-import-settings/settargetformat.md

@@ -0,0 +1,28 @@
+# TextureImportSettings::SetTargetFormat / GetTargetFormat
+
+```cpp
+void SetTargetFormat(TextureFormat format);
+TextureFormat GetTargetFormat() const;
+```
+
+设置或获取目标纹理格式。
+
+**参数：**
+- `format` - 目标格式（参见 `TextureFormat` 枚举）
+
+**返回：** `TextureFormat` / `void`
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+settings.SetTargetFormat(TextureFormat::RGBA8);
+TextureFormat format = settings.GetTargetFormat(); // TextureFormat::RGBA8
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览
+- [Texture](../texture/texture.md) - 纹理格式定义

docs/api/resources/texture-import-settings/settexturetype.md

@@ -0,0 +1,28 @@
+# TextureImportSettings::SetTextureType / GetTextureType
+
+```cpp
+void SetTextureType(TextureType type);
+TextureType GetTextureType() const;
+```
+
+设置或获取纹理类型。
+
+**参数：**
+- `type` - 纹理类型（参见 `TextureType` 枚举）
+
+**返回：** `TextureType` / `void`
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+settings.SetTextureType(TextureType::Texture2D);
+TextureType type = settings.GetTextureType(); // TextureType::Texture2D
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览
+- [Texture](../texture/texture.md) - 纹理类型定义

docs/api/resources/texture-import-settings/setusehardwarecompression.md

@@ -0,0 +1,27 @@
+# TextureImportSettings::SetUseHardwareCompression / GetUseHardwareCompression
+
+```cpp
+void SetUseHardwareCompression(bool use);
+bool GetUseHardwareCompression() const;
+```
+
+设置或获取是否使用硬件压缩（GPU 压缩格式）。
+
+**参数：**
+- `use` - 是否使用硬件压缩
+
+**返回：** `bool` / `void`
+
+**线程安全：** ✅
+
+**示例：**
+
+```cpp
+TextureImportSettings settings;
+settings.SetUseHardwareCompression(true);
+bool use = settings.GetUseHardwareCompression(); // true
+```
+
+## 相关文档
+
+- [TextureImportSettings 总览](textureimportsettings.md) - 返回类总览