XCEngine/docs/api/XCEngine/Editor/UI/ImGuiSession/ImGuiSession.md

ImGuiSession

命名空间: XCEngine::Editor::UI

类型: class

源文件: editor/src/UI/ImGuiSession.h

描述: 管理编辑器的 ImGui 上下文、布局 ini 文件位置、基础字体配置和默认主题应用。

概述

ImGuiSession 负责的是 ImGui 自身的生命周期和持久化布局配置。

它当前主要做三件事：

• 创建/销毁 ImGui context
• 把布局 ini 文件放到 <project>/.xceditor/imgui_layout.ini
• 配置默认字体并应用基础主题

当前实现说明

• Initialize(projectPath) 会开启 ImGuiConfigFlags_DockingEnable。
• 字体优先尝试加载 C:/Windows/Fonts/msyh.ttc，失败时回退到 ImGui 默认字体。
• Shutdown() 会先保存设置，再销毁当前 context。
• SaveSettings() 只在 context 存在且 ini 路径非空时生效。

当前实现边界

• 当前字体路径写死为 Windows 字体目录。
• 当前 ini 文件位置策略是项目局部目录，而不是全局用户目录。
• 当前主要负责会话和基础样式，不处理平台/渲染后端桥接。

相关文档

• UI
• Application
• Win32EditorHost