Passes

命名空间: XCEngine::Rendering::Passes

类型: submodule

描述: 承载 builtin object-id、selection outline、infinite grid、fullscreen post-process / final-color，以及 depth-only / shadow-caster 一类可复用渲染 pass 与配套参数类型。

概览

Rendering::Passes 不是用来替代 RenderPipeline 的第二套主渲染框架，而是承载几类被 CameraRenderer、editor 视口流程和 builtin pipeline 复用的 builtin pass：

BuiltinObjectIdPass 把可见物体编码成 object-id 颜色，写到辅助渲染目标。
BuiltinObjectIdOutlinePass 读取 object-id 纹理和选中对象列表，把轮廓或调试 mask 叠加回场景颜色。
BuiltinInfiniteGridPass 给 Scene View 一类编辑器视口叠加无限网格。
BuiltinColorScalePostProcessPass 执行基于 sourceColorView 的全屏颜色缩放后处理。
BuiltinFinalColorPass 执行 exposure、tone mapping、output transfer 和 final color scale 的最终输出阶段。
BuiltinDepthStylePassBase 为深度风格场景重绘 pass 提供共享执行骨架。
BuiltinDepthOnlyPass 是 CameraRenderer 默认 depthOnly request 的 builtin 实现。
BuiltinShadowCasterPass 是 CameraRenderer 默认 shadowCaster request 的 builtin 实现。

当前 Scene View 相关链路大致是：

CameraRenderer 先执行主 RenderPipeline。
如果 CameraRenderRequest 里请求了 objectId.surface，则额外执行 BuiltinObjectIdPass。
editor 侧的 SceneViewportRenderPlan 再构建 postScenePasses 和 overlayPasses。
其中 SceneViewportGridPass / SceneViewportSelectionOutlinePass 最终分别调用 BuiltinInfiniteGridPass 和 BuiltinObjectIdOutlinePass。

SceneRenderer 当前会先在 planning 阶段把：

解析成 CameraRenderRequest::postProcess 与 CameraRenderRequest::finalOutput。

随后 CameraRenderer 在主场景之后依次执行：

类型 / 页面	角色
BuiltinObjectIdPass	生成 object-id 颜色缓冲。
BuiltinObjectIdOutlinePass	在主颜色目标上合成选中轮廓。
BuiltinInfiniteGridPass	Scene View 网格覆盖层的底层执行 pass。
BuiltinColorScalePostProcessPass	相机 post-process 栈当前的颜色缩放全屏 pass。
BuiltinFinalColorPass	final-color 阶段的最终合成 / 输出变换 pass。
BuiltinDepthStylePassBase	depth-only / shadow-caster 场景重绘共享的执行骨架。
BuiltinDepthOnlyPass	`CameraRenderer` 默认的 depth-only scene pass。
BuiltinShadowCasterPass	`CameraRenderer` 默认的 shadow-caster scene pass。

tests/Rendering/unit/test_camera_scene_renderer.cpp 验证了 CameraRenderer 里 object-id、post-process、final-output 与可选 pass sequence 的接入时机。
engine/src/Rendering/Execution/CameraRenderer.cpp 当前把 BuiltinShadowCasterPass 与 BuiltinDepthOnlyPass 作为默认 scene pass 挂进 shadowCaster / depthOnly request。
engine/src/Rendering/Execution/SceneRenderer.cpp 当前负责把 fullscreen 阶段写进 CameraRenderRequest。
tests/Editor/test_viewport_render_flow_utils.cpp 验证了 Scene View render plan 如何组装 grid / selection outline / overlay pass。