Dear ImGui多窗口环境下字体加载问题的分析与解决

2025-05-01 04:16:13作者：乔或婵

在使用Dear ImGui进行多窗口开发时，开发者可能会遇到一个常见问题：当创建多个窗口并为每个窗口设置不同的字体时，发现只有第一个窗口的字体设置生效，后续窗口仍然使用默认字体。本文将深入分析这一问题的原因，并提供完整的解决方案。

问题现象

在Dear ImGui项目中，当开发者尝试为多个窗口分别设置不同的字体时，经常会出现以下情况：

第一个窗口的字体加载和显示完全正常
后续窗口的字体设置似乎被忽略，仍然显示默认字体
检查代码逻辑看似正确，但实际效果不符合预期

根本原因分析

经过深入分析，发现问题主要出在上下文(Context)的管理上。Dear ImGui使用上下文来隔离不同窗口的状态，包括字体设置。具体原因如下：

上下文切换时机不当：CreateContext()函数仅在首次调用时会自动设置新上下文为当前上下文，后续调用不会自动切换。
IO对象获取错误：在创建第二个及后续上下文后，如果没有立即切换上下文，获取的IO对象仍然是前一个上下文的，导致字体设置错误地应用到前一个上下文。
资源管理混乱：多个上下文共享某些资源(如字体图集)时，如果没有正确管理，会导致资源冲突或重复加载。

解决方案

正确的上下文管理方法

以下是修正后的关键代码片段，展示了如何正确管理多窗口环境下的上下文和字体设置：

bool InitForm(bool mes) {
    windows_ = glfwCreateWindow(width_, height_, windows_name_.c_str(), NULL, NULL);
    if (!windows_) {
        printf("Failed to create GLFW window 1\n");
        return false;
    }
    
    // 创建新上下文
    context_ = ImGui::CreateContext();
    
    // 立即切换到新上下文
    ImGui::SetCurrentContext(context_);
    
    // 现在获取的IO对象是正确的
    io_ = &ImGui::GetIO();
    (void)io_;
    io_->ConfigFlags |= ImGuiConfigFlags_NavEnableKeyboard;
    io_->ConfigFlags |= ImGuiConfigFlags_NavEnableGamepad;
    
    glfwMakeContextCurrent(windows_);
    ImGui_ImplGlfw_InitForOpenGL(windows_, mes);
    ImGui_ImplOpenGL3_Init();
    glfwSwapInterval(0);

    io_->IniFilename = nullptr;
    ImFontConfig Font_cfg;
    Font_cfg.FontDataOwnedByAtlas = false;
    float fontSize = 18.0f;
    font_ = io_->Fonts->AddFontFromFileTTF(font_path_.c_str(), fontSize, &Font_cfg, 
           io_->Fonts->GetGlyphRangesChineseFull());
    
    if (font_ == NULL) {
        printf("Failed to load font from file: %s\n", font_path_.c_str());
        font_ = io_->Fonts->AddFontDefault();
    }
    return true;
}