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,67 @@
+//
+// Created by atdunbg on 2026/9/23.
+//
+// SceneGpu：场景级 GPU 共享装配（Shadow/Forward 及未来几何类 pass 共用）。
+//
+// 从 Renderer 拆出的装配体：set 布局 / pipeline 布局 / shader object /
+// 采样器 / per-slot 描述符集合。新增几何 pass（延迟、调试线框等）直接
+// 复用本装配，不必碰 Renderer。
+//
+
+#ifndef HELLOVULKAN_SCENEGPU_H
+#define HELLOVULKAN_SCENEGPU_H
+
+#include <Engine/Core/FrameContext.h>
+#include <Engine/RenderGraph/RenderGraph.h>
+#include <vulkan/vulkan.hpp>
+#include <vector>
+
+namespace Engine {
+
+    class Device;
+    class DescriptorManager;
+    class ShaderManager;
+    class UniformBuffer;
+
+    namespace Passes {
+
+        class SceneGpu {
+        public:
+            SceneGpu(Device& device, DescriptorManager& descriptors,
+                     ShaderManager& shaders,
+                     UniformBuffer& ubo, UniformBuffer& objectBuffer);
+            ~SceneGpu();
+
+            SceneGpu(const SceneGpu&) = delete;
+            SceneGpu& operator=(const SceneGpu&) = delete;
+
+            // ---- set 布局（shader 契约，改绑定必须同步 shaders/）----
+            vk::DescriptorSetLayout uboSetLayout;      // Set0 = {UBO, ObjectBuffer}
+            vk::DescriptorSetLayout textureSetLayout;  // Set1 = {albedo}
+            vk::DescriptorSetLayout shadowSetLayout;   // Set2 = {shadow map}
+            vk::PipelineLayout forwardLayout;          // 3 sets，无 push（GPUDriven 经 SSBO）
+            vk::PipelineLayout shadowLayout;           // Set0，push = lightVP 64B
+
+            // per-slot 描述符：Set0（UBO+实例 SSBO）与 Set2（阴影图采样）
+            std::vector<vk::DescriptorSet> uboSets;
+            std::vector<vk::DescriptorSet> shadowSets;
+
+            // 阴影采样器：clamp-to-border 白色 = 光视锥外自动无阴影
+            //（省 shader 出界分支）
+            vk::Sampler shadowSampler;
+
+            vk::ShaderEXT forwardVert{}, forwardFrag{};
+            vk::ShaderEXT shadowVert{}, shadowFrag{};
+
+            // RG 重编译后重绑阴影图（物理镜像按槽位各一份）
+            void BindShadowMap(RG::RenderGraph& rg, RG::TextureHandle shadowMap);
+
+        private:
+            Device& m_Device;
+            DescriptorManager& m_Descriptors;
+        };
+
+    } // namespace Passes
+} // namespace Engine
+
+#endif //HELLOVULKAN_SCENEGPU_H