feat: add pause control to top run toolbar

docs/plan/Unity式Tick系统与PlayMode运行时方案-阶段进展.md

@@ -31,11 +31,12 @@
 ### 阶段 D 当前收口
 
 - 已在软件顶部增加独立运行栏
-- 运行栏已接入 `Play / Stop / Step` 三个图标按钮
+- 运行栏已接入 `Play / Pause / Step / Stop` 四个图标按钮
 - 顶部按钮直接复用现有 PlayMode 请求通道，不额外分叉状态机
 - `Play` 仅在 `Edit` 且存在活动场景时可用
+- `Pause` 在 `Play / Paused` 下可用，并沿用现有 `F6`
 - `Stop` 在 `Play / Paused` 下可用
-- `Step` 仍只在 `Paused` 下可用，`Pause / Resume` 继续走 `Run` 菜单与 `F6`
+- `Step` 仍只在 `Paused` 下可用
 
 ## 本轮验证
 

editor/src/panels/MenuBar.cpp

@@ -33,10 +33,11 @@ std::string BuildRunToolbarIconPath(const char* fileName) {
 }
 
 const std::string& GetRunToolbarIconPath(size_t index) {
-    static const std::array<const char*, 3> kFileNames = {
+    static const std::array<const char*, 4> kFileNames = {
         "play_button.png",
-        "stop_button.png",
-        "step_button.png"
+        "pause_button.png",
+        "step_button.png",
+        "stop_button.png"
     };
     static std::array<std::string, kFileNames.size()> s_cachedPaths = {};
 
@@ -53,7 +54,8 @@ bool DrawRunToolbarIconButton(
     const char* id,
     const Actions::ActionBinding& action,
     const std::string& iconPath,
-    const char* fallbackGlyph) {
+    const char* fallbackGlyph,
+    const char* disabledHint = nullptr) {
     ImGui::BeginDisabled(!action.enabled);
     ImGui::PushID(id);
 
@@ -92,8 +94,8 @@ bool DrawRunToolbarIconButton(
         if (!action.shortcutLabel.empty()) {
             ImGui::Text("Shortcut: %s", action.shortcutLabel.c_str());
         }
-        if (!action.enabled && action.label == "Step") {
-            ImGui::TextUnformatted("Available while runtime is paused.");
+        if (!action.enabled && disabledHint && disabledHint[0] != '\0') {
+            ImGui::TextUnformatted(disabledHint);
         }
         UI::EndTitledTooltip();
     }
@@ -146,32 +148,62 @@ void MenuBar::RenderRunToolbar() {
     if (open) {
         const Actions::ActionBinding playAction =
             Actions::MakeStartPlayModeAction(m_context->GetRuntimeMode(), m_context->GetSceneManager().HasActiveScene());
-        const Actions::ActionBinding stopAction = Actions::MakeStopPlayModeAction(m_context->GetRuntimeMode());
+        const bool canPause =
+            m_context->GetRuntimeMode() == EditorRuntimeMode::Play ||
+            m_context->GetRuntimeMode() == EditorRuntimeMode::Paused;
+        const Actions::ActionBinding pauseAction =
+            Actions::MakeTogglePauseModeAction(m_context->GetRuntimeMode(), canPause);
         const Actions::ActionBinding stepAction =
             Actions::MakeStepPlayModeAction(m_context->GetRuntimeMode() == EditorRuntimeMode::Paused);
+        const Actions::ActionBinding stopAction = Actions::MakeStopPlayModeAction(m_context->GetRuntimeMode());
 
         const float totalWidth =
-            kRunToolbarButtonExtent * 3.0f + kRunToolbarButtonSpacing * 2.0f;
+            kRunToolbarButtonExtent * 4.0f + kRunToolbarButtonSpacing * 3.0f;
         const float startX =
             ImGui::GetCursorPosX() + (std::max)(0.0f, (ImGui::GetContentRegionAvail().x - totalWidth) * 0.5f);
         const float startY =
             (std::max)(ImGui::GetCursorPosY(), (ImGui::GetWindowHeight() - kRunToolbarButtonExtent) * 0.5f);
         ImGui::SetCursorPos(ImVec2(startX, startY));
 
-        if (DrawRunToolbarIconButton("Play", playAction, GetRunToolbarIconPath(0), "P")) {
+        if (DrawRunToolbarIconButton(
+                "Play",
+                playAction,
+                GetRunToolbarIconPath(0),
+                "P",
+                "Available in Edit mode when an active scene exists.")) {
             Actions::RequestStartPlayMode(*m_context);
         }
 
         ImGui::SameLine(0.0f, kRunToolbarButtonSpacing);
-        if (DrawRunToolbarIconButton("Stop", stopAction, GetRunToolbarIconPath(1), "S")) {
-            Actions::RequestStopPlayMode(*m_context);
+        if (DrawRunToolbarIconButton(
+                "Pause",
+                pauseAction,
+                GetRunToolbarIconPath(1),
+                "||",
+                "Available while runtime is playing or paused.")) {
+            Actions::RequestTogglePauseMode(*m_context);
         }
 
         ImGui::SameLine(0.0f, kRunToolbarButtonSpacing);
-        if (DrawRunToolbarIconButton("Step", stepAction, GetRunToolbarIconPath(2), ">")) {
+        if (DrawRunToolbarIconButton(
+                "Step",
+                stepAction,
+                GetRunToolbarIconPath(2),
+                ">",
+                "Available while runtime is paused.")) {
             Actions::RequestStepPlayMode(*m_context);
         }
 
+        ImGui::SameLine(0.0f, kRunToolbarButtonSpacing);
+        if (DrawRunToolbarIconButton(
+                "Stop",
+                stopAction,
+                GetRunToolbarIconPath(3),
+                "S",
+                "Available while runtime is active.")) {
+            Actions::RequestStopPlayMode(*m_context);
+        }
+
         UI::DrawCurrentWindowBottomBorder();
     }