图形渲染与 Shader / 系统课时
管理窗口尺寸变化
管理窗口尺寸变化
离屏帧缓冲的附件有固定像素尺寸。窗口被拖拽、跨 DPI 显示器或恢复最大化后,如果只更新视口而不重建颜色和深度附件,后处理结果就会被拉伸,甚至出现附件尺寸与目标区域不一致的问题。
学习目标
- 区分窗口逻辑尺寸与 framebuffer 像素尺寸
- 在尺寸变化后重新分配颜色纹理和深度/模板附件
- 用完整性检查和实际拖拽验证重建逻辑
为什么只改视口不够
glViewport 只定义后续光栅化写入的矩形区域,不会改变已经创建的纹理或 Renderbuffer 存储。若离屏颜色纹理仍是旧尺寸,场景会先渲染到旧分辨率,再由后处理四边形缩放到新的默认帧缓冲,看起来就是模糊或拉伸。
在 GLFW 中应以 framebuffer 尺寸为准,而不是 glfwGetWindowSize 返回的逻辑窗口尺寸。高 DPI 环境下两者可能不同。

把尺寸变化变成一次可控重建
更稳妥的做法是让回调只记录新尺寸,在下一帧开头统一重建 GPU 存储。这样可以把 OpenGL 状态修改集中在渲染路径中,并在窗口最小化产生 0 × 0 时直接暂停绘制。
下面是片段示例。它依赖已经创建好的 framebuffer、colorTexture、depthStencilRbo,且三个对象已按颜色附件和深度模板附件完成绑定关系;OpenGL 上下文必须有效。
#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;
}预期输出
framebuffer resized: <VALUE>x<VALUE><VALUE> 取决于当前 framebuffer 的实际像素宽高。glTexImage2D 和 glRenderbufferStorage 会替换原有存储,但纹理、Renderbuffer 以及它们与 FBO 的附件关系仍然保留,因此不需要每次重新 glFramebufferTexture2D。
在帧循环中应用新尺寸
注册回调后,每帧处理事件,再调用 applyFramebufferResize()。函数返回 false 时可跳过本帧绘制,避免窗口最小化期间创建零尺寸附件。
如果程序还会切换到阴影贴图等不同分辨率的 FBO,必须在每个渲染通道开始前设置与目标附件一致的 glViewport,不能假设窗口回调中的视口值一直有效。
验证重建是否正确
连续拖动窗口边缘并跨不同缩放比例的显示器,画面应保持比例正确且清晰;最小化后恢复不应报 FBO 不完整。若尺寸变化后仍然拉伸,优先核对颜色纹理、深度/模板 Renderbuffer 和最终默认 framebuffer 是否都使用了同一组像素宽高。