使用ImGui时如何正确处理窗口缩放问题？

核心问题根源 #

窗口缩放时，OpenGL帧缓冲区尺寸、视口设置、ImGui内部渲染尺寸三者必须同步更新，任何一环脱节都会导致黑块（缓冲区不匹配）或控件截断（ImGui用旧尺寸渲染）。以下是具体解决步骤：

1. 修正帧缓冲区回调，同步所有尺寸参数 #

在framebuffer_size_callback中，除了更新你的自定义OpenGL缓冲区，必须同步设置OpenGL视口并通知ImGui尺寸变化：

void framebuffer_size_callback(GLFWwindow* window, int width, int height) {
    // 更新你的自定义缓冲区（纹理、FBO等）
    updateBuffers(width, height);
    // 同步OpenGL视口到新尺寸
    glViewport(0, 0, width, height);
    // 通知ImGui窗口显示尺寸变化
    ImGuiIO& io = ImGui::GetIO();
    io.DisplaySize = ImVec2((float)width, (float)height);
    // 处理高DPI：同步帧缓冲区缩放比例
    float scale_x, scale_y;
    glfwGetWindowContentScale(window, &scale_x, &scale_y);
    io.DisplayFramebufferScale = ImVec2(scale_x, scale_y);
}

关键：不能只更新自己的缓冲区，必须让ImGui感知到窗口尺寸和高DPI缩放的变化，否则它会用旧尺寸渲染导致控件截断。

2. 确保updateBuffers逻辑完全适配新尺寸 #

检查你的updateBuffers函数，确保它用新的宽高完全重建OpenGL资源，而不是仅做部分修改：

void updateBuffers(int width, int height) {
    // 销毁旧纹理
    glDeleteTextures(1, &myTexture);
    // 创建匹配新尺寸的纹理
    glGenTextures(1, &myTexture);
    glBindTexture(GL_TEXTURE_2D, myTexture);
    glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, width, height, 0, GL_RGBA, GL_UNSIGNED_BYTE, nullptr);
    // 同理更新FBO、渲染缓冲区等其他资源
}

如果缓冲区尺寸和窗口帧缓冲区尺寸不匹配，必然出现黑块或拉伸变形。

3. 严格遵循渲染流程顺序 #

渲染循环必须按以下顺序执行，避免ImGui被覆盖或视口冲突：

1. 清空颜色/深度缓冲区（glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT)）
2. 绘制你的OpenGL内容（使用更新后的缓冲区）
3. 启动ImGui帧（ImGui::NewFrame()）
4. 绘制ImGui控件
5. 渲染ImGui（ImGui::Render() + ImGui_ImplOpenGL3_RenderDrawData(ImGui::GetDrawData())）
6. 交换缓冲区（glfwSwapBuffers(window)）

4. 高DPI适配（可选但重要） #

如果需要支持高分辨率显示器，创建GLFW窗口时启用自动缩放：

glfwWindowHint(GLFW_SCALE_TO_MONITOR, GLFW_TRUE);

这会让窗口帧缓冲区像素尺寸与逻辑尺寸正确对应，避免ImGui控件模糊或截断。

5. 排查常见错误点 #

• 确认updateBuffers中没有遗漏重新绑定FBO/纹理，导致后续绘制使用旧资源
• 检查glViewport参数是窗口实际帧缓冲区尺寸，而非逻辑尺寸（高DPI下两者不同）
• 不要在渲染循环外手动修改ImGuiIO的DisplaySize，仅在帧缓冲区回调中更新

内容的提问来源于stack exchange，提问作者Craig