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 @@
# SceneRenderRequestUtils
**命名空间**: `XCEngine::Rendering::SceneRenderRequestUtils`
**类型**: `utility header`
**头文件**: `XCEngine/Rendering/Planning/SceneRenderRequestUtils.h`
**描述**: request planning 规则库统一相机可用性判断、稳定排序、clear flag 推导、render area 解析,以及基础 `CameraRenderRequest` 组装。
## 概览
`SceneRenderRequestUtils` 是 planning 层的规则收口点。
它当前提供的核心 helper 包括:
- `IsUsableCamera(...)`
- `SortSceneCamerasForRendering(...)`
- `SortCameraRenderRequests(...)`
- `ResolveClearFlags(...)`
- `ResolveCameraRenderArea(...)`
- `BuildCameraRenderRequest(...)`
## 当前规则重点
- 场景相机按 `stackType -> depth` 稳定排序。
- request 按 `cameraStackOrder -> cameraDepth` 稳定排序。
- `CameraClearMode::Auto` 不是固定值,而要结合 base/overlay 计数推导。
- normalized viewport 会叠加到父 `RenderSurface::renderArea` 上,而不是总以整张 surface 为基准。
## 相关文档
- [Planning](../Planning.md)
- [SceneRenderRequestPlanner](../SceneRenderRequestPlanner/SceneRenderRequestPlanner.md)
- [CameraRenderRequest](../CameraRenderRequest/CameraRenderRequest.md)
- [Camera Request Planning And Clear Rules](../../../../_guides/Rendering/Camera-Request-Planning-And-Clear-Rules.md)