游戏客户端架构 / 系统课时
创建应用窗口
创建应用窗口
本课用 GLFW 完成平台层的第一个可运行能力:初始化窗口系统,创建一个可见且可缩放的应用窗口,并在用户关闭窗口后按正确顺序释放资源。
学习目标
- 理解窗口系统从初始化到销毁的完整生命周期
- 使用 C++ 创建可显示、缩放和关闭的 GLFW 窗口
- 通过构建输出与交互操作验证窗口是否正常工作
窗口生命周期
窗口不是一个普通局部变量,它依赖操作系统资源。正确顺序是先初始化 GLFW,再创建窗口并进入事件循环,退出循环后销毁窗口,最后终止 GLFW。任一步失败,都要释放此前已经成功取得的资源。

准备最小工程
工程只需要一个源文件和一个 CMake 配置。下面假设系统已经安装 GLFW,并且 CMake 能通过 find_package 找到它。
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 或其他渲染后端。
#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;
}预期结果
程序启动后出现标题为 Anystack Engine 的 960x540 窗口。
拖动窗口边缘时终端输出 resize: <WIDTH>x<HEIGHT>。
点击系统关闭按钮后窗口退出,并输出 window closed。其中 <WIDTH> 与 <HEIGHT> 由实际缩放结果决定。
构建并验证
在包含 CMakeLists.txt 与 main.cpp 的目录中执行:
cmake -S . -B build
cmake --build build
./build/window_app预期输出
[100%] Built target window_app
window created: 960x540
window closed不同生成器的构建日志可能略有差异;Windows 多配置生成器的可执行文件通常位于 build/Debug/window_app.exe。验收重点是窗口可见、可缩放、可通过系统关闭按钮退出,且进程正常结束。
尺寸与失败边界
窗口尺寸表示界面坐标中的逻辑大小,在高 DPI 屏幕上不一定等于实际像素数量。当前示例只关心窗口是否能创建和缩放,真正创建交换链或渲染目标时,还要读取 framebuffer 尺寸。
若程序没有出现窗口,先检查 GLFW 初始化错误,再检查图形桌面环境是否可用。若程序关闭后仍驻留,通常是事件循环没有检查 glfwWindowShouldClose,或销毁顺序遗漏了 glfwDestroyWindow 与 glfwTerminate。
本课总结
- 窗口系统必须遵循初始化、创建、循环、销毁、终止的资源顺序
glfwWaitEventsTimeout能在保持响应的同时避免无意义的忙等待- 窗口逻辑尺寸与 framebuffer 像素尺寸是两个不同概念
下一课预告
下一课将接收并整理关闭、移动、缩放和焦点变化等系统事件,让窗口从“能够显示”升级为“能够响应操作”。