64 lines
3.6 KiB
Markdown
64 lines
3.6 KiB
Markdown
# Rendering 模块说明（在建）
|
||
|
||
## 1. 目的
|
||
- 本文只描述当前已落地的渲染主线和后续收口方向。
|
||
- 这里优先记录真实代码职责，不按理想状态脑补。
|
||
- 如果实现与本文冲突，以代码为准，再更新本文。
|
||
|
||
## 2. 当前主链
|
||
```text
|
||
SceneRenderer
|
||
-> SceneRenderRequestPlanner
|
||
-> RenderPipelineHost
|
||
-> CameraFramePlanBuilder
|
||
-> CameraRenderer
|
||
-> DirectionalShadowRuntime
|
||
-> RenderSceneExtractor
|
||
-> CameraFrameGraph
|
||
-> RenderGraph Record / Compile / Execute
|
||
```
|
||
|
||
## 3. 当前架构判断
|
||
- 这套系统已经不是“一个 forward pipeline 直接画完整帧”。
|
||
- 当前主模型是：`SRP host + renderer backend + per-camera plan + render graph execution`。
|
||
- `ScriptableRenderPipelineHost` 是 native 侧最重要的 SRP 接缝。
|
||
- `CameraRenderRequest` 和 `CameraFramePlan` 已经承担了每相机规划职责。
|
||
- `RenderSceneExtractor` 负责从 `Scene` 生成 `RenderSceneData`。
|
||
- `CameraFrameGraph` 和 `RenderGraph` 已经是执行内核的一部分，不是附属实验层。
|
||
|
||
## 4. 和 Unity SRP / URP 的关系
|
||
- `RenderPipelineAsset` 对应 Unity 的 `RenderPipelineAsset`。
|
||
- `ScriptableRenderPipelineHost` 接近 Unity 的 `RenderPipeline` 宿主。
|
||
- managed 侧已经有 `ScriptableRenderPipelineAsset -> ScriptableRendererData -> ScriptableRenderer -> ScriptableRendererFeature/Pass` 这条产品层骨架。
|
||
- 因此当前问题不是“SRP 没打通”，而是“URP 风格上层还没彻底收口”。
|
||
|
||
## 5. 当前未收口点
|
||
- managed runtime 目前仍复用默认 native forward backend 作为共享绘制后端。
|
||
- 这意味着 `BuiltinForwardPipeline` 还同时带着“默认产品层”和“native 执行后端”两种身份。
|
||
- 一些本该属于 URP asset / renderer / feature 的组织策略，仍可能滑回 native backend。
|
||
- 所以现在更准确的名字是“SRP 已通、URP 主产品线未收口”。
|
||
|
||
## 6. 在这个模块里应怎样继续演进
|
||
- 把 camera request policy、renderer 选择、stage planning、scene setup、shadow execution config、pass/feature 排序继续上移到 managed `URP`。
|
||
- 把 scene extraction、renderer list 绘制、native scene feature、fullscreen primitive 执行保留在 native。
|
||
- 非通用策略不要继续直接塞进 `BuiltinForwardPipeline`。
|
||
- 如果新增的是“绘制能力”或“native backend contract”，可以放 C++。
|
||
- 如果新增的是“渲染组织策略”或“URP 行为差异”，优先放 managed。
|
||
|
||
## 7. 关键文件
|
||
- `engine/src/Rendering/Execution/SceneRenderer.cpp`
|
||
- `engine/src/Rendering/Execution/RenderPipelineHost.cpp`
|
||
- `engine/src/Rendering/Execution/CameraRenderer.cpp`
|
||
- `engine/src/Rendering/Extraction/RenderSceneExtractor.cpp`
|
||
- `engine/src/Rendering/Pipelines/ScriptableRenderPipelineHost.cpp`
|
||
- `engine/src/Rendering/Pipelines/BuiltinForwardPipeline.cpp`
|
||
- `managed/XCEngine.ScriptCore/Rendering/Core/ScriptableRenderPipeline*.cs`
|
||
- `managed/XCEngine.RenderPipelines.Universal/Rendering/Universal/*.cs`
|
||
|
||
## 8. 长期目标
|
||
- 形成唯一默认主线：`UniversalRenderPipelineAsset -> UniversalRendererData -> UniversalRenderer -> ScriptableRendererFeature/Pass`。
|
||
- `ShadowCaster / DepthOnly / MainScene / PostProcess / FinalOutput` 的组织权由 managed `URP` 持有。
|
||
- `BuiltinForwardPipeline` 或其后继应退回为 native scene draw backend，而不是继续充当上层产品语义。
|
||
- native 侧最终保留“执行内核”和“通用后端 contract”，managed 侧负责“渲染策略”和“产品层组织”。
|
||
- 简单说：目标不是继续堆更多 URP 外形，而是把 URP 真正收口成唯一上层组织者。
|