Tighten final color contract

This commit is contained in:
2026-04-10 01:21:00 +08:00
parent 4111f841d4
commit 4debbbea1f
4 changed files with 19 additions and 18 deletions

View File

@@ -12,7 +12,7 @@
本轮目标有且只有四类:
1. 把 NanoVDB 体积渲染从 D3D12 单后端正式能力推进到 Vulkan / OpenGL 正式能力。
2.`FinalColor`volume/final-output 的契约收死,消除“接口已存在但运行时半接线”的状态。
2.`FinalColor` 与 final-output 的契约收死,消除“接口已存在但运行时半接线”的状态。
3.`ObjectId` 从“低 32 位截断可用方案”推进到清晰稳定的正式渲染 ID 契约。
4. 把阴影规划与前向管线剩余的硬编码策略、monolith 结构继续拆干净。
@@ -23,7 +23,7 @@
当前 Rendering 已经具备稳定运行基础,但还不能称为“完全收口”,核心原因是:
1. `volume_scene / volume_occlusion_scene / volume_transform_scene` 目前仍只在 D3D12 上做了正式实例化与 GT 验证。
2. `FinalColorSettings` 已经具备 pipeline/camera/volume 三层策略接口,但运行时只真正接入了 pipeline + camera
2. `FinalColorSettings` 当前真正落地的是 pipeline defaults + camera overrides此前残留的 volume override 分支只是头文件级 API并未进入运行时
3. `ObjectId` 仍基于 runtime object id 低 32 位编码,不是长期正式方案。
4. `SceneRenderRequestPlanner` 里仍保留方向光阴影尺寸与 focus 策略的硬编码。
5. `BuiltinForwardPipeline` 功能上可用但资源布局、PSO、descriptor、skybox、draw path 仍聚集在同一条大实现链里。
@@ -92,12 +92,10 @@
任务:
1. 审查 `FinalColorSettings`、camera overrides、volume overrides 的设计边界。
2. 二选一处理 volume override
- 真正接入运行时解析链路;
- 或明确从现阶段 API 中收掉,不再保留半接线接口。
1. 审查 `FinalColorSettings`、camera overrides、final-output 的设计边界。
2. 将未落地的 volume override 分支从现阶段 API 中正式收掉,不再保留半接线接口。
3. 补齐对应单测与场景回归测试。
4. 明确 post-process / final-output / volume 的职责关系文档。
4. 明确 post-process / final-output 的职责关系文档。
验收标准: