游戏客户端架构 / 系统课时

处理窗口尺寸变化

处理窗口尺寸变化

窗口被拖拽、最大化或切换到高 DPI 屏幕时,窗口逻辑尺寸与实际帧缓冲尺寸可能不同。本课将捕获帧缓冲变化,在主循环中重建离屏渲染目标并同步 OpenGL 视口,避免画面拉伸、裁剪和零尺寸资源错误。

学习目标

  • 区分窗口逻辑尺寸与帧缓冲像素尺寸
  • 在缩放事件后同步更新视口和离屏渲染目标
  • 正确处理最小化产生的零宽度、零高度状态

正确认识两种窗口尺寸

窗口尺寸通常使用屏幕坐标表示,而帧缓冲尺寸表示真正可渲染的像素数量。在普通缩放比例下,两者可能相等;在 Retina 或高 DPI 屏幕上,一个窗口坐标可能对应多个物理像素。

OpenGL 的 glViewport、颜色纹理和深度缓冲都应采用帧缓冲尺寸。因此,GLFW 程序应监听 glfwSetFramebufferSizeCallback,而不是只依据普通窗口尺寸回调更新渲染资源。

窗口缩放处理链路

实现统一的缩放处理

下面的完整示例使用 GLFW 和 OpenGL 创建一个离屏颜色纹理。尺寸回调只保存新尺寸,真正的纹理重建在主循环中执行,从而避免在平台回调期间进行复杂资源操作。

cpp
#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;
}

预期输出

text
Framebuffer: 960x540
Framebuffer: <WIDTH>x<HEIGHT>

拖动窗口边缘时,控制台会输出新的帧缓冲尺寸,蓝色画面始终覆盖整个可渲染区域。<WIDTH> 和 <HEIGHT> 取决于窗口大小与系统缩放比例,实际值可能不同。

验证结果与处理边界

先连续拖动窗口四条边,确认画面没有只占据左下角,也没有保留旧尺寸的未刷新区域。随后最大化窗口,并在条件允许时将窗口移动到缩放比例不同的显示器,检查控制台中的像素尺寸是否随之变化。

最小化窗口时,部分平台会报告 0x0。此时应暂停渲染和资源重建,等待新的非零尺寸事件。不要强行把零尺寸改成 1x1 后继续高频渲染,否则程序虽然不崩溃,却会在不可见状态下持续占用 CPU 和 GPU。

如果引擎包含颜色纹理、深度纹理、多重采样缓冲或后处理目标,它们必须在同一次尺寸提交中统一重建。只调用 glViewport 而不调整这些资源,会造成采样比例错误、边缘裁剪或帧缓冲不完整。

本课总结

  • 渲染视口和渲染目标应使用帧缓冲像素尺寸,而不是窗口逻辑尺寸
  • 缩放回调适合记录状态,资源销毁与重建应集中到主循环执行
  • 最小化产生的零尺寸必须暂停处理,恢复后再重建渲染资源

下一课预告

下一课将把事件处理、时间计算、逻辑更新和画面渲染组织成稳定的游戏主循环,让窗口系统真正驱动持续运行的引擎程序。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理窗口尺寸变化

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

登录哪都通