docs: complete rendering api reorg coverage
This commit is contained in:
@@ -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)
|
||||
|
||||
Reference in New Issue
Block a user