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,220 @@
+//
+// InspectorPanel.cpp：组件编辑实现。
+//
+// Transform 编辑必须走 Set* 入口（标脏 → 帧循环统一 Compose 重算
+// world），直接改私有成员是编译错误——面板天然遵守引擎约束。
+//
+
+#include "InspectorPanel.h"
+#include "Engine/ECS/Components.h"
+#include "Engine/Renderer/Model.h"
+
+#include <imgui.h>
+
+#include <cstdio>
+#include <vector>
+
+namespace
+{
+    // InputText 需要 char 缓冲；提交时写回 std::string
+    bool InputTextString(const char* label, std::string& str)
+    {
+        char buf[256];
+        std::snprintf(buf, sizeof(buf), "%s", str.c_str());
+        if (ImGui::InputText(label, buf, sizeof(buf)))
+        {
+            str = buf;
+            return true;
+        }
+        return false;
+    }
+}
+
+void InspectorPanel::Draw(const EditorContext& ctx, entt::entity selected)
+{
+    ImGui::Begin("Inspector");
+
+    auto& reg = ctx.scene->GetRegistry();
+    if (selected == entt::null || !reg.valid(selected))
+    {
+        ImGui::TextDisabled("(no entity selected)");
+        ImGui::End();
+        return;
+    }
+
+    // ---- Name ----
+    if (auto* name = reg.try_get<Engine::ECS::NameComponent>(selected))
+    {
+        InputTextString("Name", name->name);
+    }
+    ImGui::Separator();
+
+    // ---- Add Component ----
+    if (ImGui::Button("Add Component"))
+    {
+        ImGui::OpenPopup("add_component");
+    }
+    if (ImGui::BeginPopup("add_component"))
+    {
+        if (!reg.all_of<Engine::ECS::LightComponent>(selected) &&
+            ImGui::MenuItem("Light"))
+        {
+            reg.emplace<Engine::ECS::LightComponent>(selected);
+        }
+        if (!reg.all_of<Engine::ECS::CameraComponent>(selected) &&
+            ImGui::MenuItem("Camera"))
+        {
+            reg.emplace<Engine::ECS::CameraComponent>(selected);
+        }
+        if (!reg.all_of<Engine::ECS::AnimationComponent>(selected) &&
+            ImGui::MenuItem("Animation"))
+        {
+            reg.emplace<Engine::ECS::AnimationComponent>(selected);
+        }
+        if (!reg.all_of<Engine::ECS::NameComponent>(selected) &&
+            ImGui::MenuItem("Name"))
+        {
+            reg.emplace<Engine::ECS::NameComponent>(selected);
+        }
+        ImGui::EndPopup();
+    }
+    ImGui::Separator();
+
+    // ---- Transform ----
+    if (auto* t = reg.try_get<Engine::ECS::TransformComponent>(selected))
+    {
+        if (ImGui::CollapsingHeader("Transform", ImGuiTreeNodeFlags_DefaultOpen))
+        {
+            glm::vec3 pos = t->GetPosition();
+            if (ImGui::DragFloat3("position", &pos.x, 0.05f))
+            {
+                t->SetPosition(pos);
+            }
+            glm::vec3 rot = t->GetRotation();   // 欧拉角（度）
+            if (ImGui::DragFloat3("rotation", &rot.x, 0.5f))
+            {
+                t->SetRotation(rot);
+            }
+            glm::vec3 scl = t->GetScale();
+            if (ImGui::DragFloat3("scale", &scl.x, 0.02f, 0.001f, 100.0f))
+            {
+                t->SetScale(scl);
+            }
+        }
+    }
+
+    // ---- MeshRenderer ----
+    if (auto* mr = reg.try_get<Engine::ECS::MeshRendererComponent>(selected))
+    {
+        if (ImGui::CollapsingHeader("MeshRenderer",
+                                    ImGuiTreeNodeFlags_DefaultOpen))
+        {
+            if (const Engine::Model* model = ctx.assets->GetModel(mr->model);
+                model != nullptr)
+            {
+                const auto& clips = model->GetClips();
+                ImGui::Text("model: valid (%u clips, %u bones)",
+                            static_cast<unsigned>(clips.size()),
+                            static_cast<unsigned>(model->GetBoneCount()));
+                ImGui::TextDisabled("(mesh asset is read-only here)");
+            }
+            else
+            {
+                ImGui::TextColored(ImVec4(1.0f, 0.3f, 0.3f, 1.0f),
+                                   "model: INVALID (dangling ref)");
+            }
+        }
+    }
+
+    // ---- Light ----
+    if (auto* light = reg.try_get<Engine::ECS::LightComponent>(selected))
+    {
+        if (ImGui::CollapsingHeader("Light", ImGuiTreeNodeFlags_DefaultOpen))
+        {
+            int type = static_cast<int>(light->type);
+            if (ImGui::Combo("type", &type, "Directional\0Point\0"))
+            {
+                light->type = static_cast<Engine::ECS::LightComponent::Type>(type);
+            }
+            ImGui::ColorEdit3("color", &light->color.x);
+            ImGui::DragFloat("intensity", &light->color.a, 0.05f, 0.0f, 100.0f);
+            if (light->type == Engine::ECS::LightComponent::Type::Directional)
+            {
+                ImGui::SliderFloat3("direction", &light->direction.x, -1.0f, 1.0f);
+                ImGui::Checkbox("castShadow", &light->castShadow);
+            }
+            else
+            {
+                ImGui::DragFloat("radius", &light->radius, 0.1f, 0.0f, 100.0f);
+                ImGui::TextDisabled("(position = entity Transform)");
+            }
+        }
+    }
+
+    // ---- Camera ----
+    if (auto* cam = reg.try_get<Engine::ECS::CameraComponent>(selected))
+    {
+        if (ImGui::CollapsingHeader("Camera", ImGuiTreeNodeFlags_DefaultOpen))
+        {
+            if (ImGui::Checkbox("primary", &cam->primary) && cam->primary)
+            {
+                // primary 互斥：启用本相机时清掉其余实体的 primary
+                //（引擎取第一个 primary 作为渲染视角）
+                reg.view<Engine::ECS::CameraComponent>().each(
+                    [&](entt::entity e, Engine::ECS::CameraComponent& c)
+                    {
+                        if (e != selected)
+                        {
+                            c.primary = false;
+                        }
+                    });
+            }
+        }
+    }
+
+    // ---- Animation ----
+    if (auto* anim = reg.try_get<Engine::ECS::AnimationComponent>(selected))
+    {
+        if (ImGui::CollapsingHeader("Animation",
+                                    ImGuiTreeNodeFlags_DefaultOpen))
+        {
+            const auto* mr = reg.try_get<Engine::ECS::MeshRendererComponent>(selected);
+            const Engine::Model* model =
+                mr ? ctx.assets->GetModel(mr->model) : nullptr;
+
+            if (model != nullptr && model->HasAnimations())
+            {
+                const auto& clips = model->GetClips();
+                std::vector<const char*> clipNames;
+                clipNames.reserve(clips.size());
+                for (const auto& c : clips)
+                {
+                    clipNames.push_back(c.name.c_str());
+                }
+                int cur = anim->clipIndex;
+                if (ImGui::Combo("clip", &cur, clipNames.data(),
+                                 static_cast<int>(clipNames.size())))
+                {
+                    anim->Play(cur);   // 触发 crossfade（fade 秒）
+                }
+                ImGui::Checkbox("playing", &anim->playing);
+                ImGui::SameLine();
+                ImGui::Checkbox("loop", &anim->loop);
+                ImGui::SliderFloat("speed", &anim->speed, -2.0f, 2.0f);
+                ImGui::SliderFloat("fade", &anim->fadeDuration, 0.0f, 1.0f);
+                if (anim->clipIndex >= 0 &&
+                    anim->clipIndex < static_cast<int>(clips.size()))
+                {
+                    ImGui::Text("t: %.2f / %.2f s", anim->time,
+                                clips[anim->clipIndex].duration);
+                }
+            }
+            else
+            {
+                ImGui::TextDisabled("(no animation clips on model)");
+            }
+        }
+    }
+
+    ImGui::End();
+}