docs: sync api and planning docs

This commit is contained in:
2026-04-08 16:07:03 +08:00
parent 08c3278e10
commit 31756847ab
1826 changed files with 44502 additions and 29645 deletions

View File

@@ -6,20 +6,27 @@
**头文件**: `XCEngine/Rendering/Execution/SceneRenderer.h`
**描述**: 场景级渲染编排入口,负责构建和排序 `CameraRenderRequest`,再把每个请求转交给 [CameraRenderer](../CameraRenderer/CameraRenderer.md) 执行。
**描述**: 场景级渲染编排入口,负责构建并补全 `CameraRenderRequest`包括 final-color policy、fullscreen post-process/final-output 子请求,再把请求转交给 [CameraRenderer](../CameraRenderer/CameraRenderer.md) 执行。
## 概览
`SceneRenderer` 当前是执行层的外层编排器。
它维护两块核心运行时对象:
它维护两块公开可见的核心运行时对象:
- `m_requestPlanner`
- `m_cameraRenderer`
除此之外,它还维护每帧按 request 数量扩展的 owned fullscreen-stage 状态:
- `m_ownedPostProcessSequences`
- `m_ownedFinalOutputSequences`
- `m_ownedFullscreenStageSurfaces`
这条拆分让 Rendering 主链明确分成两层:
- `SceneRenderer` 负责“这次要渲染哪些 request、按什么顺序”
- `SceneRenderer` 还负责把每个 request 进一步补成“主场景颜色 -> post-process -> final-output”的完整链
- `CameraRenderer` 负责“单个 request 怎样被真正执行”
## 当前公开能力
@@ -28,11 +35,15 @@
- 执行单个 request
- 执行 request 数组
- 直接从 `Scene + overrideCamera + surface` 生成 request 并执行
- 为每个 request 解析 final-color policy
- 按相机 post-process / final-color 需求挂接 fullscreen-stage 子请求
## 当前实现边界
- 它不直接做 scene extraction。
- 它不直接操作主管线内部细节。
- `BuildRenderRequests(...)` 当前会先让 `SceneRenderRequestPlanner` 生成基础 request再调用 `ResolveCameraFinalColorPolicies(...)``AttachFullscreenStageRequests(...)` 做后处理补全。
- fullscreen-stage 只会在 request 同时具备 `camera`、有效 `device` 和有效颜色目标时挂接。
- 对手工提交的 request 数组,当前仍会再次按 stack / depth 做稳定排序。
## 相关文档
@@ -42,4 +53,3 @@
- [SceneRenderRequestPlanner](../../Planning/SceneRenderRequestPlanner/SceneRenderRequestPlanner.md)
- [SceneRenderRequestUtils](../../Planning/SceneRenderRequestUtils/SceneRenderRequestUtils.md)
- [Camera Request Planning And Clear Rules](../../../../_guides/Rendering/Camera-Request-Planning-And-Clear-Rules.md)