refactor: 解耦重构——还清四处架构债（对齐 UE/Unity 分层）

- SceneRenderer：场景→渲染数据翻译层（UE FSceneRenderer / Unity CullingResults 模式），收口相机/灯光/光空间矩阵/双视图剔除，Renderer 只编排 - pass 对象化（Unity ScriptableRenderPass 模式）：8 个 pass lambda 拆为 Passes::{Shadow,Forward,Bloom,Tonemap,ImGui,Present}，BuildGraph 超级函数消失； SceneGpu/FullscreenGpu 承接共享装配 - 中性 AssetRef（Core 层）：ECS 组件不再依赖 Assets 模块（Unity InstanceID 思路） - IAssetUploader 接口：AssetManager 不感知 Vulkan 具体类，上传服务由渲染层 VulkanAssetUploader 提供 - Renderer 公共 API 不变（App 层零改动），编译零错误 validation 零警告
2026-09-23 12:02:49 +08:00
parent 91880d88fe
commit 718a658f5d
30 changed files with 1777 additions and 1054 deletions
@@ -0,0 +1,104 @@
+//
+// Created by atdunbg on 2026/9/23.
+//
+
+#include <Engine/Renderer/Passes/ShadowPass.h>
+#include <Engine/Renderer/Vertex.h>
+#include <Engine/Renderer/Mesh.h>
+
+#include <array>
+
+namespace Engine::Passes
+{
+    void ShadowPass::Register(RG::RenderGraph& rg)
+    {
+        // 所有渲染体都写入，不做实体级开关——castShadow 应由材质/实体
+        // 数据驱动剔除，而非 pass 逻辑特判
+        rg.AddPass("Shadow", [this](RG::RenderGraphContext& ctx) {
+            const vk::CommandBuffer cmd = ctx.cmd;
+
+            vk::RenderingAttachmentInfo depthAttachment;
+            depthAttachment.setImageView(ctx.View(m_ShadowMap))
+                           .setImageLayout(vk::ImageLayout::eDepthAttachmentOptimal)
+                           .setLoadOp(vk::AttachmentLoadOp::eClear)
+                           .setStoreOp(vk::AttachmentStoreOp::eStore)
+                           .setClearValue(vk::ClearValue(
+                               vk::ClearDepthStencilValue(1.0f, 0)));
+
+            vk::RenderingInfo renderingInfo;
+            renderingInfo.setRenderArea({{0, 0}, {kShadowMapSize, kShadowMapSize}})
+                         .setLayerCount(1)
+                         .setPDepthAttachment(&depthAttachment);
+
+            cmd.beginRendering(renderingInfo);
+
+            std::array<vk::ShaderStageFlagBits, 2> stages = {
+                vk::ShaderStageFlagBits::eVertex,
+                vk::ShaderStageFlagBits::eFragment
+            };
+            std::array<vk::ShaderEXT, 2> shaders = {m_Gpu.shadowVert, m_Gpu.shadowFrag};
+            cmd.bindShadersEXT(stages, shaders);
+
+            // ---- 动态状态（depth-only）----
+            cmd.setRasterizerDiscardEnable(VK_FALSE);
+
+            cmd.setDepthTestEnable(VK_TRUE);
+            cmd.setDepthWriteEnable(VK_TRUE);
+            cmd.setDepthCompareOp(vk::CompareOp::eLess);
+            cmd.setDepthBoundsTestEnable(VK_FALSE);
+
+            cmd.setStencilTestEnable(VK_FALSE);
+            // 深度 bias 压平 shadow acne（NDC 量级）
+            cmd.setDepthBiasEnable(VK_TRUE);
+            cmd.setDepthBias(0.0025f, 0.0f, 0.003f);
+            cmd.setPolygonModeEXT(vk::PolygonMode::eFill);
+            cmd.setCullMode(vk::CullModeFlagBits::eNone);
+            cmd.setFrontFace(vk::FrontFace::eCounterClockwise);
+            cmd.setPrimitiveTopology(vk::PrimitiveTopology::eTriangleList);
+            cmd.setPrimitiveRestartEnable(VK_FALSE);
+
+            auto binding = Vertex::GetBindingDescription();
+            auto attributes = Vertex::GetAttributeDescriptions();
+            cmd.setVertexInputEXT(binding, attributes);
+
+            cmd.setRasterizationSamplesEXT(vk::SampleCountFlagBits::e1);
+            vk::SampleMask sampleMask = 0xFFFFFFFF;
+            cmd.setSampleMaskEXT(vk::SampleCountFlagBits::e1, sampleMask);
+            cmd.setAlphaToCoverageEnableEXT(VK_FALSE);
+            cmd.setAlphaToOneEnableEXT(VK_FALSE);
+
+            vk::Viewport viewport(0.0f, 0.0f,
+                                  static_cast<float>(kShadowMapSize),
+                                  static_cast<float>(kShadowMapSize),
+                                  0.0f, 1.0f);
+            cmd.setViewportWithCount(viewport);
+
+            vk::Rect2D scissor({0, 0}, {kShadowMapSize, kShadowMapSize});
+            cmd.setScissorWithCount(scissor);
+
+            // ---- 绘制：GPUDriven——与 Forward 共用实例数据，但用
+            //      光源视锥剔除后的 batch（相机外实体仍投影子）----
+            cmd.bindDescriptorSets(vk::PipelineBindPoint::eGraphics,
+                                   m_Gpu.shadowLayout, 0,
+                                   m_Gpu.uboSets[ctx.frame.frameSlot], {});
+
+            // stage 必须覆盖 layout range 声明的全部 stage（VUID-01796）
+            cmd.pushConstants(m_Gpu.shadowLayout,
+                              vk::ShaderStageFlagBits::eVertex |
+                              vk::ShaderStageFlagBits::eFragment,
+                              0, sizeof(glm::mat4), &m_Frame.ubo.lightSpace);
+
+            for (const auto& batch : m_Frame.shadowView.batches) {
+                batch.mesh->Draw(cmd, batch.count, batch.first);
+            }
+
+            cmd.endRendering();
+        }).Write(m_ShadowMap, RG::ResourceUse::DepthAttachment);
+    }
+
+    void ShadowPass::OnTargetsRebuilt(RG::RenderGraph& rg)
+    {
+        m_Gpu.BindShadowMap(rg, m_ShadowMap);
+    }
+
+} // namespace Engine::Passes