Dear ImGui 的 C++23 模块化封装 — import 即用 · 跨平台 · 特性可插拔

mcpp 构建工具 · 包索引 mcpp-index · Dear ImGui 上游 · Issues · Releases

• 纯模块导入 — import imgui.core;,消费者代码零 #include
• 三档使用体验 — imgui.app 一行出窗口(默认档)/ imgui.backend 编译期契约(自动档)/ imgui.backend.<impl> 显式选后端(专家档),换后端 = 改一行 import + alias
• 特性可插拔 — features = ["docking-full"] 解锁面板停靠 + 拖出主窗口变独立 OS 窗口;app 档 开启 imgui.app facade(它是本仓库的发明,不属于上游 Dear ImGui,所以默认不给)
• 不绑定工具链、不打包 GL 驱动 — Linux / macOS / Windows 三平台 CI;GL 运行时由 mcpp 生态自动闭合

mcpp new myapp --template imgui && cd myapp && mcpp run    # 窗口直接出现
# 模板随库分发、版本自动对齐:
#   mcpp new --list-templates imgui          # 列出库提供的模板
#   mcpp new ide --template imgui:docking    # IDE 式停靠布局(docking-full)

或在已有项目中手动接入:

[dependencies.ocornut]
imgui = { version = "1.92.8", features = ["app"] }

import imgui.core;
import imgui.app;

int main() {
    return ImGui::App::run([] {
        ImGui::Begin("hello");
        ImGui::TextUnformatted("mcpp + imgui");
        ImGui::End();
    });
}

后端实现模块不 re-export imgui.core,消费者需各自显式 import;换后端只改 import 行与一行 using Backend = ...;。

[dependencies.ocornut]
imgui = { version = "1.92.8", features = ["docking-full", "app"] }

docking/viewports 源码来自上游 docking tag(compat.imgui 1.92.8-docking,主线超集——特性关闭时行为与主线一致)。需 mcpp ≥ 0.0.47。

cd examples/docking && mcpp run

包不固定工具链(mcpp 解析环境默认,如 Linux glibc gcc);GL/GLX 运行时由生态包 compat.glx-runtime 透传闭合,不打包驱动。解析结果可用 mcpp why / mcpp self doctor 查看。

封装代码 MIT;Dear ImGui 本体 MIT(经 compat.imgui 提供)。