docs: complete rendering api reorg coverage

This commit is contained in:
2026-04-07 00:17:51 +08:00
parent 83f316a91f
commit 7216ad9138
107 changed files with 1701 additions and 444 deletions

View File

@@ -0,0 +1,37 @@
# SceneRenderRequestPlanner
**命名空间**: `XCEngine::Rendering`
**类型**: `class`
**头文件**: `XCEngine/Rendering/Planning/SceneRenderRequestPlanner.h`
**描述**: 从场景和可选 override camera 生成最终要提交给执行层的 `CameraRenderRequest` 数组。
## 概览
`SceneRenderRequestPlanner` 处在 request planning 主链的中心位置。
它负责:
- 收集本次要参与渲染的相机
- 复用 [SceneRenderRequestUtils](../SceneRenderRequestUtils/SceneRenderRequestUtils.md) 的规则组装 request
- 丢弃 render area 无效的 request
## 当前规划规则
- `CollectCameras(...)` 优先接受可用的 `overrideCamera`,否则收集场景相机并做稳定排序。
- `BuildRequests(...)` 逐个调用 `BuildCameraRenderRequest(...)`,并维护 base/request 计数以推导 `Auto` clear 行为。
## 当前实现边界
- 它只生成 request不执行 request。
- 它不填充 `objectId`、fullscreen 阶段或 editor 注入的 pass sequence。
## 相关文档
- [Planning](../Planning.md)
- [SceneRenderRequestUtils](../SceneRenderRequestUtils/SceneRenderRequestUtils.md)
- [CameraRenderRequest](../CameraRenderRequest/CameraRenderRequest.md)
- [SceneRenderer](../../Execution/SceneRenderer/SceneRenderer.md)