feat: ImGui docking Editor + 显示链/帧同步/输入语义重构

- App/editor: Hierarchy/Inspector/Viewport/Stats 四面板 + DockBuilder 默认布局，main.cpp 瘦身为场景搭建与生命周期 - 显示链: Tonemap→PresentTarget 经 ImGui::Image 呈现（零色偏），backbuffer 仅承载 ImGui；Direct/Viewport 双显示模式 + 面板分辨率上报 - 帧首同步 BeginFrameSync: resize/vsync/尺寸/模式意图统一帧首落定（修描述符悬垂）；修复 vsync 意图未落 swapchain 导致的每帧重建交换链 - 输入: Editor 每帧判定键盘/鼠标归属（打字让位、Viewport hover/focus 放行、Fullscreen 全放行） - 材质: roughness 独立槽位 + 非 glTF 金属/粗糙贴图映射；透明队列 depthWrite=FALSE + translucent 独立 shader + scratch 清帧 - FBX: 非蒙皮网格烘焙节点链全局变换（Z-up 旋转/单位换算落顶点） - Hierarchy 行 ImGui ID 以 UUID 作用域（重名不冲突、改名不丢选中）
2026-09-30 00:24:53 +08:00
parent b25fa29fe5
commit 20f0035baa
57 changed files with 3067 additions and 622 deletions
@@ -0,0 +1,89 @@
+//
+// Editor：docking 编辑器骨架。
+//
+// 职责：
+//   - 顶栏菜单（File/View）+ 全屏 DockSpace + 首帧默认布局（DockBuilder）
+//   - 实体选中状态（entt::entity，Hierarchy 写 / Inspector 读）
+//   - 退出确认模态框（窗口关闭 → RequestQuit → Yes 时 Close）
+//
+// 面板窗口名（Hierarchy/Inspector/Viewport/Stats）即 docking 身份，
+// imgui.ini 持久化布局；默认布局只在 dock node 为空时构建一次。
+//
+
+#ifndef HELLOVULKAN_EDITOR_H
+#define HELLOVULKAN_EDITOR_H
+
+#include "EditorContext.h"
+#include "ViewportPanel.h"   // ViewportInputState（成员按值持有）
+
+#include <entt/entt.hpp>
+
+#include <memory>
+
+class HierarchyPanel;
+class InspectorPanel;
+class ViewportPanel;
+class StatsPanel;
+
+class Editor {
+public:
+    Editor();
+    ~Editor();
+
+    Editor(const Editor&) = delete;
+    Editor& operator=(const Editor&) = delete;
+
+    // 注入上下文（OnInit 阶段，指针必须全部有效）
+    void Init(const EditorContext& ctx);
+
+    // 每帧 UI 构建（OnImGuiRender 唯一入口）
+    void Draw();
+
+    // ---- 输入归属判定（Window 层输入捕获谓词；UE/Unity 的
+    //      "viewport 持焦才拥有输入" 语义，ImGui 侧经自身后端
+    //      链式回调永远正常收输入）----
+    // 键盘：编辑器形态 = Viewport 持焦且不在文本输入中；游戏形态
+    //       （Fullscreen）只在文本输入中让位（打字不触发快捷键）
+    bool BlockingKeyboard() const;
+    // 鼠标：编辑器形态 = 悬停 Viewport 才放行；游戏形态沿用
+    //       WantCaptureMouse（UI 隐藏时自动放行）
+    bool BlockingMouse() const;
+
+    // 请求退出（弹确认框；窗口关闭事件走这里）
+    void RequestQuit() { m_ShowQuitConfirm = true; }
+
+    // ---- 选中状态 ----
+    void SelectEntity(entt::entity e) { m_Selected = e; }
+    entt::entity GetSelected() const { return m_Selected; }
+
+private:
+    void DrawMenuBar();       // host 窗口内顶栏
+    void DrawDockSpace();     // 全屏 host + dockspace + 默认布局
+    void DrawQuitModal();     // 退出确认模态框
+
+    EditorContext m_Ctx{};
+
+    ViewportInputState m_VpInput{};   // Viewport 面板 hover/focus（每帧刷新）
+
+    std::unique_ptr<HierarchyPanel> m_Hierarchy;
+    std::unique_ptr<InspectorPanel> m_Inspector;
+    std::unique_ptr<ViewportPanel> m_Viewport;
+    std::unique_ptr<StatsPanel> m_Stats;
+
+    entt::entity m_Selected{entt::null};
+
+    // 面板显隐（View 菜单）
+    bool m_ShowHierarchy = true;
+    bool m_ShowInspector = true;
+    bool m_ShowViewport = true;
+    bool m_ShowStats = true;
+
+    // 默认布局只建一次（imgui.ini 已有布局则跳过）
+    bool m_LayoutBuilt = false;
+
+    // 退出确认链
+    bool m_ShowQuitConfirm = false;
+    bool m_QuitConfirmed = false;
+};
+
+#endif //HELLOVULKAN_EDITOR_H