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

创建应用窗口

创建应用窗口

本课用 GLFW 完成平台层的第一个可运行能力:初始化窗口系统,创建一个可见且可缩放的应用窗口,并在用户关闭窗口后按正确顺序释放资源。

学习目标

  • 理解窗口系统从初始化到销毁的完整生命周期
  • 使用 C++ 创建可显示、缩放和关闭的 GLFW 窗口
  • 通过构建输出与交互操作验证窗口是否正常工作

窗口生命周期

窗口不是一个普通局部变量,它依赖操作系统资源。正确顺序是先初始化 GLFW,再创建窗口并进入事件循环,退出循环后销毁窗口,最后终止 GLFW。任一步失败,都要释放此前已经成功取得的资源。

窗口创建与销毁生命周期

准备最小工程

工程只需要一个源文件和一个 CMake 配置。下面假设系统已经安装 GLFW,并且 CMake 能通过 find_package 找到它。

cmake
cmake_minimum_required(VERSION 3.20)
project(window_app LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(glfw3 3.3 REQUIRED)

add_executable(window_app main.cpp)
target_link_libraries(window_app PRIVATE glfw)

这份配置会生成名为 window_app 的可执行程序,并把 GLFW 链接到目标。配置阶段若提示找不到 glfw3Config.cmake,说明 GLFW 尚未安装,或其安装目录没有加入 CMake 搜索路径。

实现可缩放窗口

下面的程序显式启用窗口缩放,并使用无图形 API 模式。这样可以先验证平台层,不必同时引入 OpenGL、Vulkan 或其他渲染后端。

cpp
#include <GLFW/glfw3.h>

#include <cstdlib>
#include <iostream>

void onWindowSize(GLFWwindow*, int width, int height) {
    // 回调只记录窗口逻辑尺寸,渲染尺寸会在后续课程单独处理。
    std::cout << "resize: " << width << "x" << height << std::endl;
}

int main() {
    if (glfwInit() != GLFW_TRUE) {
        std::cerr << "failed to initialize GLFW" << std::endl;
        return EXIT_FAILURE;
    }

    glfwWindowHint(GLFW_CLIENT_API, GLFW_NO_API);
    glfwWindowHint(GLFW_RESIZABLE, GLFW_TRUE);

    GLFWwindow* window =
        glfwCreateWindow(960, 540, "Anystack Engine", nullptr, nullptr);

    if (window == nullptr) {
        std::cerr << "failed to create window" << std::endl;
        glfwTerminate();
        return EXIT_FAILURE;
    }

    glfwSetWindowSizeCallback(window, onWindowSize);
    std::cout << "window created: 960x540" << std::endl;

    while (glfwWindowShouldClose(window) == GLFW_FALSE) {
        // 等待事件并设置超时,避免空循环持续占用一个 CPU 核心。
        glfwWaitEventsTimeout(1.0 / 60.0);
    }

    glfwDestroyWindow(window);
    glfwTerminate();
    std::cout << "window closed" << std::endl;
    return EXIT_SUCCESS;
}

预期结果

text
程序启动后出现标题为 Anystack Engine 的 960x540 窗口。
拖动窗口边缘时终端输出 resize: <WIDTH>x<HEIGHT>。
点击系统关闭按钮后窗口退出,并输出 window closed。

其中 <WIDTH> 与 <HEIGHT> 由实际缩放结果决定。

构建并验证

在包含 CMakeLists.txt 与 main.cpp 的目录中执行:

bash
cmake -S . -B build
cmake --build build
./build/window_app

预期输出

text
[100%] Built target window_app
window created: 960x540
window closed

不同生成器的构建日志可能略有差异;Windows 多配置生成器的可执行文件通常位于 build/Debug/window_app.exe。验收重点是窗口可见、可缩放、可通过系统关闭按钮退出,且进程正常结束。

尺寸与失败边界

窗口尺寸表示界面坐标中的逻辑大小,在高 DPI 屏幕上不一定等于实际像素数量。当前示例只关心窗口是否能创建和缩放,真正创建交换链或渲染目标时,还要读取 framebuffer 尺寸。

若程序没有出现窗口,先检查 GLFW 初始化错误,再检查图形桌面环境是否可用。若程序关闭后仍驻留,通常是事件循环没有检查 glfwWindowShouldClose,或销毁顺序遗漏了 glfwDestroyWindow 与 glfwTerminate。

本课总结

  • 窗口系统必须遵循初始化、创建、循环、销毁、终止的资源顺序
  • glfwWaitEventsTimeout 能在保持响应的同时避免无意义的忙等待
  • 窗口逻辑尺寸与 framebuffer 像素尺寸是两个不同概念

下一课预告

下一课将接收并整理关闭、移动、缩放和焦点变化等系统事件,让窗口从“能够显示”升级为“能够响应操作”。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建应用窗口

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

登录哪都通