Align SRP boundaries and editor windowing
This commit is contained in:
@@ -34,16 +34,25 @@ SceneRenderer
|
||||
`ScriptableRenderPipelineAsset -> ScriptableRendererData -> ScriptableRenderer -> ScriptableRendererFeature/Pass`
|
||||
- builtin 和 SRP 现在都必须是显式可切换的顶层路径，而不是“SRP 隐式优先，builtin 只是兜底”。
|
||||
- `ScriptableRenderPipelineHost` 里的 native backend 是 managed SRP 的绘制后端，不是 SRP stage 录制失败时的顶层兜底。
|
||||
- managed `ScriptableRenderContext` 的公开场景接口只表达绘制能力：`DrawRenderers(...)`、`DrawSkybox()`、`DrawOpaqueRenderers()`、`DrawTransparentRenderers()`。
|
||||
- renderer-backed SRP 的 frame stage 组织权归 `ScriptableRenderer` / `ScriptableRendererFeature`，包括 shadow caster、depth only、post-process、final output 等可选 stage。
|
||||
|
||||
## 5. 当前硬边界
|
||||
- `RenderPipelineFactory` 在无显式 asset、无托管配置、创建失败回退时，都必须先回 builtin，而不是回 `ScriptableRenderPipelineHost`。
|
||||
- `MonoScriptRuntime::OnRuntimeStart()` 不得隐式写入 render pipeline 选择。
|
||||
- builtin 私有 native feature 通道只能留在 native 内部使用。
|
||||
- managed SRP runtime 或 stage recorder 存在时，stage 组织权归 managed SRP；native backend 不得在 host 层隐式接管 `RecordStageRenderGraph`、`Render(...)` 或 scene-pass standalone stage。
|
||||
- `RendererBackedRenderPipelineAsset` 进入 frame planning 时必须先清掉 native 默认请求出来的可选 stage，再由 renderer / feature 显式请求需要的 stage。
|
||||
- 下列能力不得再暴露给 managed / URP 公开层：
|
||||
`NativeSceneFeaturePassId`
|
||||
`ScriptableRenderContext.RecordNativeSceneFeaturePass(...)`
|
||||
`ScriptableRenderContext.RecordScene(...)`
|
||||
`ScriptableRenderContext.RecordScenePhase(...)`
|
||||
`ScriptableRenderContext.RecordSceneInjectionPoint(...)`
|
||||
`ScriptableRenderContext.RecordOpaque/Skybox/TransparentScenePhase(...)`
|
||||
`ScriptableRenderContext.RecordBefore/After*Injection(...)`
|
||||
依赖上述接口的 managed wrapper feature / controller
|
||||
- `CameraRenderRequestContext.hasDirectionalShadow` 和 `CameraRenderRequestContext.ClearDirectionalShadow()` 不得作为 ScriptCore public surface 暴露；core 层只能保留内部桥接，产品层策略放在 URP renderer asset / renderer data / feature。
|
||||
- URP 默认 renderer feature 工厂不得自动注入 builtin 私有 feature wrapper。
|
||||
|
||||
## 6. native / managed 分层
|
||||
@@ -57,7 +66,9 @@ SceneRenderer
|
||||
renderer 选择
|
||||
stage planning
|
||||
renderer feature / pass 组织
|
||||
renderer feature 的 frame-plan / scene-setup / shadow-execution 配置分发
|
||||
camera 级策略
|
||||
shadow caster / depth only 等可选 stage 的显式请求
|
||||
产品层行为差异
|
||||
- 判断原则：
|
||||
如果新增的是“绘制能力”或“后端 contract”，优先放 C++。
|
||||
@@ -66,9 +77,11 @@ SceneRenderer
|
||||
## 7. 禁止回退的实现方式
|
||||
- 不要再引入“项目默认 SRP asset 自动生效”的隐式逻辑。
|
||||
- 不要再把 builtin 私有 native feature 包成 public managed API 方便调用。
|
||||
- 不要让 managed `ScriptableRenderContext.RecordScene(...)` 或任何 managed pass 录制 native scene injection point。
|
||||
- 不要再让 “null 选择” 默认落到 `ScriptableRenderPipelineHost`。
|
||||
- 不要把非通用产品层策略继续直接塞回 `BuiltinForwardPipeline`。
|
||||
- 不要让 `ScriptableRenderPipelineHost` 在 managed SRP 未支持或未录制某个 stage 时自动回退到 native backend；需要绘制时应通过 managed `ScriptableRenderContext` 显式调用 native draw 能力。
|
||||
- 不要让 renderer-backed SRP 继续继承 native planner 默认请求出来的 shadow/depth stage；需要这些 stage 时必须由 managed renderer / feature 显式请求并录制。
|
||||
|
||||
## 8. 关键文件
|
||||
- `engine/src/Rendering/Internal/RenderPipelineFactory.cpp`
|
||||
@@ -89,7 +102,21 @@ SceneRenderer
|
||||
无 managed 选择时默认走 builtin。
|
||||
设置 managed descriptor 后切到 `ScriptableRenderPipelineHost`。
|
||||
清空 managed descriptor 后退回 builtin。
|
||||
- `tests/scripting/test_mono_script_runtime.cpp`
|
||||
`ScriptableRenderContextPublicApiSurfaceUsesDirectContextModel` 保证 public managed surface 不再暴露 native scene injection / phase wrapper。
|
||||
`DefaultSceneRendererUsesManagedUniversalPipelineForPlannedMainSceneAndPostProcessRender` 保证 managed URP 通过显式 renderer/pass 录制主场景和后处理。
|
||||
`ManagedRenderContextExposes*ThroughRenderingData` 保证 managed renderer 可通过 `RenderingData` 观察 camera / lighting / shadow / environment / final color / stage color 数据。
|
||||
`ManagedStageRecorderRecordsMainSceneThroughScriptableRenderContext` 保证主场景通过 `ScriptableRenderContext` 的显式 draw 能力录制。
|
||||
|
||||
## 10. 后续演进方向
|
||||
- 继续补齐 URP 上层组织能力，但不能破坏 builtin / programmable 的显式切换语义。
|
||||
- 如果未来继续向 Unity 收口，优先收口“入口语义”和“分层边界”，不要靠隐式 fallback 和私有桥接维持表面形似。
|
||||
|
||||
## 过去几刀
|
||||
|
||||
- 收回 managed native scene injection 公开面：渲染模块目标向 Unity SRP / URP 对齐，但 managed / URP 层仍公开 native builtin scene injection point 和 phase wrapper，导致产品层像是在组织 URP，实质上仍在调用 builtin 私有时序。
|
||||
- 移除 `ScriptableRenderContext.RecordSceneInjectionPoint(...)`、`RecordBefore/After*Injection(...)`、`RecordOpaque/Skybox/TransparentScenePhase(...)` 等 public managed API；移除对应 Mono internal call；`RecordScene()` / `RecordScenePhase(...)` 收回 internal。
|
||||
- 确立 managed 公开层只通过 `DrawRenderers(...)`、`DrawSkybox()`、`DrawOpaqueRenderers()`、`DrawTransparentRenderers()` 表达 native draw 能力；pass / feature / stage 的组织权归 managed SRP / URP。
|
||||
- `ScriptableRenderer` 统一驱动 renderer feature 的 frame-plan、scene-setup、directional-shadow execution 配置；`RendererBackedRenderPipelineAsset` 清掉 native 默认 optional stage 后再让 renderer / feature 显式请求。
|
||||
- `CameraRenderRequestContext.hasDirectionalShadow` 和 `ClearDirectionalShadow()` 从 ScriptCore public surface 收回 internal，避免 core public API 泄漏 native shadow 规划控制。
|
||||
- 当时验证：`xcengine_managed_assemblies`、`scripting_tests` 构建通过；聚焦 `MonoScriptRuntimeTest` 12 项 SRP / URP / API surface 测试通过。
|
||||
|
||||
Reference in New Issue
Block a user