游戏客户端架构 / 系统课时
处理窗口尺寸变化
处理窗口尺寸变化
窗口被拖拽、最大化或切换到高 DPI 屏幕时,窗口逻辑尺寸与实际帧缓冲尺寸可能不同。本课将捕获帧缓冲变化,在主循环中重建离屏渲染目标并同步 OpenGL 视口,避免画面拉伸、裁剪和零尺寸资源错误。
学习目标
- 区分窗口逻辑尺寸与帧缓冲像素尺寸
- 在缩放事件后同步更新视口和离屏渲染目标
- 正确处理最小化产生的零宽度、零高度状态
正确认识两种窗口尺寸
窗口尺寸通常使用屏幕坐标表示,而帧缓冲尺寸表示真正可渲染的像素数量。在普通缩放比例下,两者可能相等;在 Retina 或高 DPI 屏幕上,一个窗口坐标可能对应多个物理像素。
OpenGL 的 glViewport、颜色纹理和深度缓冲都应采用帧缓冲尺寸。因此,GLFW 程序应监听 glfwSetFramebufferSizeCallback,而不是只依据普通窗口尺寸回调更新渲染资源。

实现统一的缩放处理
下面的完整示例使用 GLFW 和 OpenGL 创建一个离屏颜色纹理。尺寸回调只保存新尺寸,真正的纹理重建在主循环中执行,从而避免在平台回调期间进行复杂资源操作。
#include <glad/glad.h>
#include <GLFW/glfw3.h>
#include <iostream>
struct ResizeState {
int width = 0;
int height = 0;
bool pending = false;
};
struct RenderTarget {
GLuint framebuffer = 0;
GLuint colorTexture = 0;
int width = 0;
int height = 0;
void destroy() {
if (colorTexture != 0) {
glDeleteTextures(1, &colorTexture);
colorTexture = 0;
}
if (framebuffer != 0) {
glDeleteFramebuffers(1, &framebuffer);
framebuffer = 0;
}
}
bool resize(int newWidth, int newHeight) {
destroy();
width = newWidth;
height = newHeight;
glGenFramebuffers(1, &framebuffer);
glBindFramebuffer(GL_FRAMEBUFFER, framebuffer);
glGenTextures(1, &colorTexture);
glBindTexture(GL_TEXTURE_2D, colorTexture);
glTexImage2D(
GL_TEXTURE_2D,
0,
GL_RGBA8,
width,
height,
0,
GL_RGBA,
GL_UNSIGNED_BYTE,
nullptr
);
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
glFramebufferTexture2D(
GL_FRAMEBUFFER,
GL_COLOR_ATTACHMENT0,
GL_TEXTURE_2D,
colorTexture,
0
);
const bool complete =
glCheckFramebufferStatus(GL_FRAMEBUFFER) == GL_FRAMEBUFFER_COMPLETE;
glBindFramebuffer(GL_FRAMEBUFFER, 0);
return complete;
}
};
static void framebufferSizeCallback(GLFWwindow* window, int width, int height) {
auto* state = static_cast<ResizeState*>(glfwGetWindowUserPointer(window));
state->width = width;
state->height = height;
state->pending = true;
}
int main() {
if (glfwInit() == GLFW_FALSE) {
std::cerr << "GLFW initialization failed" << std::endl;
return 1;
}
glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3);
glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 3);
glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE);
GLFWwindow* window = glfwCreateWindow(960, 540, "Resize Demo", nullptr, nullptr);
if (window == nullptr) {
glfwTerminate();
return 1;
}
glfwMakeContextCurrent(window);
if (!gladLoadGLLoader(reinterpret_cast<GLADloadproc>(glfwGetProcAddress))) {
glfwDestroyWindow(window);
glfwTerminate();
return 1;
}
ResizeState resizeState;
glfwGetFramebufferSize(window, &resizeState.width, &resizeState.height);
resizeState.pending = true;
glfwSetWindowUserPointer(window, &resizeState);
glfwSetFramebufferSizeCallback(window, framebufferSizeCallback);
RenderTarget renderTarget;
while (!glfwWindowShouldClose(window)) {
glfwPollEvents();
if (resizeState.pending) {
resizeState.pending = false;
// 最小化时尺寸可能为零,不能创建零尺寸纹理。
if (resizeState.width > 0 && resizeState.height > 0) {
if (!renderTarget.resize(resizeState.width, resizeState.height)) {
std::cerr << "Framebuffer is incomplete" << std::endl;
break;
}
glViewport(0, 0, resizeState.width, resizeState.height);
std::cout << "Framebuffer: "
<< resizeState.width << "x" << resizeState.height
<< std::endl;
}
}
if (resizeState.width == 0 || resizeState.height == 0) {
glfwWaitEventsTimeout(0.05);
continue;
}
// 先把画面绘制到与窗口同步缩放的离屏目标。
glBindFramebuffer(GL_FRAMEBUFFER, renderTarget.framebuffer);
glViewport(0, 0, renderTarget.width, renderTarget.height);
glClearColor(0.08F, 0.35F, 0.62F, 1.0F);
glClear(GL_COLOR_BUFFER_BIT);
// 将离屏结果复制到默认帧缓冲并显示。
glBindFramebuffer(GL_READ_FRAMEBUFFER, renderTarget.framebuffer);
glBindFramebuffer(GL_DRAW_FRAMEBUFFER, 0);
glBlitFramebuffer(
0, 0, renderTarget.width, renderTarget.height,
0, 0, resizeState.width, resizeState.height,
GL_COLOR_BUFFER_BIT,
GL_NEAREST
);
glfwSwapBuffers(window);
}
renderTarget.destroy();
glfwDestroyWindow(window);
glfwTerminate();
return 0;
}预期输出
Framebuffer: 960x540
Framebuffer: <WIDTH>x<HEIGHT>拖动窗口边缘时,控制台会输出新的帧缓冲尺寸,蓝色画面始终覆盖整个可渲染区域。<WIDTH> 和 <HEIGHT> 取决于窗口大小与系统缩放比例,实际值可能不同。
验证结果与处理边界
先连续拖动窗口四条边,确认画面没有只占据左下角,也没有保留旧尺寸的未刷新区域。随后最大化窗口,并在条件允许时将窗口移动到缩放比例不同的显示器,检查控制台中的像素尺寸是否随之变化。
最小化窗口时,部分平台会报告 0x0。此时应暂停渲染和资源重建,等待新的非零尺寸事件。不要强行把零尺寸改成 1x1 后继续高频渲染,否则程序虽然不崩溃,却会在不可见状态下持续占用 CPU 和 GPU。
如果引擎包含颜色纹理、深度纹理、多重采样缓冲或后处理目标,它们必须在同一次尺寸提交中统一重建。只调用 glViewport 而不调整这些资源,会造成采样比例错误、边缘裁剪或帧缓冲不完整。
本课总结
- 渲染视口和渲染目标应使用帧缓冲像素尺寸,而不是窗口逻辑尺寸
- 缩放回调适合记录状态,资源销毁与重建应集中到主循环执行
- 最小化产生的零尺寸必须暂停处理,恢复后再重建渲染资源
下一课预告
下一课将把事件处理、时间计算、逻辑更新和画面渲染组织成稳定的游戏主循环,让窗口系统真正驱动持续运行的引擎程序。