docs(api): finish volume and volumetric pass coverage

This commit is contained in:
2026-04-09 23:50:33 +08:00
parent b0625a30bd
commit cb3d558aaa
13 changed files with 293 additions and 330 deletions

View File

@@ -1,28 +1,18 @@
# BuiltinVolumetricPass::Initialize
**命名空间**: `XCEngine::Rendering::Passes`
**类型**: `method`
**头文件**: `XCEngine/Rendering/Passes/BuiltinVolumetricPass.h`
## 签名
```cpp
bool Initialize(const RenderContext& context) override;
```
## 作用
预热当前 device/backend 相关资源。
预热体积 pass 依赖的基础资源。
## 当前行为
- 直接转发到内部 `EnsureInitialized(context)`
- 若 device/backend 变化,旧缓存会先被 `DestroyResources()` 清掉,再重新创建。
- 当前初始化阶段最关键的资源是 builtin cube mesh。
- 实际入口会转到内部 `EnsureInitialized(...)`
- 当前最关键的初始化工作是加载 builtin cube mesh
- `RenderContext` 无效或 cube mesh 加载失败,返回 `false`
## 相关文档
- [BuiltinVolumetricPass](BuiltinVolumetricPass.md)
- [Shutdown](Shutdown.md)
- [Execute](Execute.md)