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