图形渲染与 Shader / 系统课时

管理窗口尺寸变化

管理窗口尺寸变化

离屏帧缓冲的附件有固定像素尺寸。窗口被拖拽、跨 DPI 显示器或恢复最大化后,如果只更新视口而不重建颜色和深度附件,后处理结果就会被拉伸,甚至出现附件尺寸与目标区域不一致的问题。

学习目标

  • 区分窗口逻辑尺寸与 framebuffer 像素尺寸
  • 在尺寸变化后重新分配颜色纹理和深度/模板附件
  • 用完整性检查和实际拖拽验证重建逻辑

为什么只改视口不够

glViewport 只定义后续光栅化写入的矩形区域,不会改变已经创建的纹理或 Renderbuffer 存储。若离屏颜色纹理仍是旧尺寸,场景会先渲染到旧分辨率,再由后处理四边形缩放到新的默认帧缓冲,看起来就是模糊或拉伸。

在 GLFW 中应以 framebuffer 尺寸为准,而不是 glfwGetWindowSize 返回的逻辑窗口尺寸。高 DPI 环境下两者可能不同。

窗口变化触发帧缓冲附件重建的流程

把尺寸变化变成一次可控重建

更稳妥的做法是让回调只记录新尺寸,在下一帧开头统一重建 GPU 存储。这样可以把 OpenGL 状态修改集中在渲染路径中,并在窗口最小化产生 0 × 0 时直接暂停绘制。

下面是片段示例。它依赖已经创建好的 framebuffer、colorTexture、depthStencilRbo,且三个对象已按颜色附件和深度模板附件完成绑定关系;OpenGL 上下文必须有效。

cpp
#include <glad/glad.h>
#include <GLFW/glfw3.h>
#include <iostream>

struct FramebufferSizeState {
    int width = 1;
    int height = 1;
    bool dirty = true;
};

FramebufferSizeState sizeState;
GLuint framebuffer = 0;
GLuint colorTexture = 0;
GLuint depthStencilRbo = 0;

void framebufferSizeCallback(GLFWwindow*, int width, int height) {
    sizeState.width = width;
    sizeState.height = height;
    sizeState.dirty = true;
}

bool applyFramebufferResize() {
    if (!sizeState.dirty || sizeState.width <= 0 || sizeState.height <= 0) {
        return sizeState.width > 0 && sizeState.height > 0;
    }

    glBindTexture(GL_TEXTURE_2D, colorTexture);
    glTexImage2D(
        GL_TEXTURE_2D, 0, GL_RGBA8,
        sizeState.width, sizeState.height, 0,
        GL_RGBA, GL_UNSIGNED_BYTE, nullptr
    );

    glBindRenderbuffer(GL_RENDERBUFFER, depthStencilRbo);
    glRenderbufferStorage(
        GL_RENDERBUFFER, GL_DEPTH24_STENCIL8,
        sizeState.width, sizeState.height
    );

    glBindFramebuffer(GL_FRAMEBUFFER, framebuffer);
    if (glCheckFramebufferStatus(GL_FRAMEBUFFER) != GL_FRAMEBUFFER_COMPLETE) {
        std::cerr << "framebuffer incomplete after resize\n";
        return false;
    }

    glViewport(0, 0, sizeState.width, sizeState.height);
    sizeState.dirty = false;
    std::cout << "framebuffer resized: "
              << sizeState.width << "x" << sizeState.height << "\n";
    return true;
}

预期输出

text
framebuffer resized: <VALUE>x<VALUE>

<VALUE> 取决于当前 framebuffer 的实际像素宽高。glTexImage2D 和 glRenderbufferStorage 会替换原有存储,但纹理、Renderbuffer 以及它们与 FBO 的附件关系仍然保留,因此不需要每次重新 glFramebufferTexture2D。

在帧循环中应用新尺寸

注册回调后,每帧处理事件,再调用 applyFramebufferResize()。函数返回 false 时可跳过本帧绘制,避免窗口最小化期间创建零尺寸附件。

如果程序还会切换到阴影贴图等不同分辨率的 FBO,必须在每个渲染通道开始前设置与目标附件一致的 glViewport,不能假设窗口回调中的视口值一直有效。

验证重建是否正确

连续拖动窗口边缘并跨不同缩放比例的显示器,画面应保持比例正确且清晰;最小化后恢复不应报 FBO 不完整。若尺寸变化后仍然拉伸,优先核对颜色纹理、深度/模板 Renderbuffer 和最终默认 framebuffer 是否都使用了同一组像素宽高。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

管理窗口尺寸变化

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通