游戏客户端架构 / 系统课时
处理系统事件
处理系统事件
本课把操作系统产生的窗口消息转换为引擎可处理的事件队列,统一接收关闭、移动、缩放、 framebuffer 尺寸变化和焦点变化,并在主循环中顺序分发。
学习目标
- 区分系统回调、事件队列与主循环分发的职责
- 捕获常用窗口事件并转换为统一数据结构
- 验证事件顺序、动态参数和关闭请求是否被正确处理
事件处理链路
操作系统先把消息交给 GLFW,GLFW 再调用已注册的回调。平台层不应在回调中执行复杂业务,而应快速把事件写入队列,随后由主循环统一处理。这样可以避免系统回调直接修改多个引擎模块。

定义统一事件模型
一个最小事件只需要类型和两个整数参数。移动与缩放使用两个坐标值,焦点事件只使用第一个参数,关闭事件不需要额外数据。项目仍使用 GLFW 3.3 及 C++17。
cmake_minimum_required(VERSION 3.20)
project(window_events LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
find_package(glfw3 3.3 REQUIRED)
add_executable(window_events main.cpp)
target_link_libraries(window_events PRIVATE glfw)配置生效后,CMake 会创建 window_events 目标,并为下面的完整程序链接 GLFW。
注册回调并写入队列
回调通过 glfwGetWindowUserPointer 取得当前窗口对应的事件队列。关闭回调先取消 GLFW 默认关闭标记,再把关闭请求交给主循环决定,避免系统回调直接终止程序。
#include <GLFW/glfw3.h>
#include <cstdlib>
#include <deque>
#include <iostream>
enum class EventType {
Close,
Moved,
Resized,
FramebufferResized,
FocusChanged
};
struct Event {
EventType type;
int first;
int second;
};
using EventQueue = std::deque<Event>;
EventQueue& queueOf(GLFWwindow* window) {
return *static_cast<EventQueue*>(glfwGetWindowUserPointer(window));
}
void onClose(GLFWwindow* window) {
// 把关闭动作延迟到主循环,平台回调只负责采集事件。
glfwSetWindowShouldClose(window, GLFW_FALSE);
queueOf(window).push_back({EventType::Close, 0, 0});
}
void onMove(GLFWwindow* window, int x, int y) {
queueOf(window).push_back({EventType::Moved, x, y});
}
void onResize(GLFWwindow* window, int width, int height) {
queueOf(window).push_back({EventType::Resized, width, height});
}
void onFramebufferResize(GLFWwindow* window, int width, int height) {
queueOf(window).push_back(
{EventType::FramebufferResized, width, height});
}
void onFocus(GLFWwindow* window, int focused) {
queueOf(window).push_back({EventType::FocusChanged, focused, 0});
}
void dispatchEvents(GLFWwindow* window, EventQueue& events) {
while (!events.empty()) {
const Event event = events.front();
events.pop_front();
switch (event.type) {
case EventType::Close:
std::cout << "close requested" << std::endl;
glfwSetWindowShouldClose(window, GLFW_TRUE);
break;
case EventType::Moved:
std::cout << "moved: " << event.first
<< "," << event.second << std::endl;
break;
case EventType::Resized:
std::cout << "window resized: " << event.first
<< "x" << event.second << std::endl;
break;
case EventType::FramebufferResized:
std::cout << "framebuffer resized: " << event.first
<< "x" << event.second << std::endl;
break;
case EventType::FocusChanged:
std::cout << "focus: "
<< (event.first == GLFW_TRUE ? "gained" : "lost")
<< std::endl;
break;
}
}
}
int main() {
if (glfwInit() != GLFW_TRUE) {
std::cerr << "failed to initialize GLFW" << std::endl;
return EXIT_FAILURE;
}
glfwWindowHint(GLFW_CLIENT_API, GLFW_NO_API);
GLFWwindow* window =
glfwCreateWindow(960, 540, "Window Events", nullptr, nullptr);
if (window == nullptr) {
glfwTerminate();
return EXIT_FAILURE;
}
EventQueue events;
glfwSetWindowUserPointer(window, &events);
glfwSetWindowCloseCallback(window, onClose);
glfwSetWindowPosCallback(window, onMove);
glfwSetWindowSizeCallback(window, onResize);
glfwSetFramebufferSizeCallback(window, onFramebufferResize);
glfwSetWindowFocusCallback(window, onFocus);
while (glfwWindowShouldClose(window) == GLFW_FALSE) {
glfwWaitEventsTimeout(1.0 / 60.0);
dispatchEvents(window, events);
}
glfwDestroyWindow(window);
glfwTerminate();
return EXIT_SUCCESS;
}预期结果
移动窗口时输出 moved: <X>,<Y>。
缩放窗口时输出 window resized: <WIDTH>x<HEIGHT>。
高 DPI 环境还可能输出 framebuffer resized: <PIXEL_WIDTH>x<PIXEL_HEIGHT>。
切换到其他应用再返回时输出 focus: lost 与 focus: gained。
点击关闭按钮后输出 close requested,随后程序退出。这些值和事件出现顺序由窗口管理器决定,因此不能把固定坐标或固定顺序写入业务判断。
构建与交互验证
完成两个文件后执行:
cmake -S . -B build
cmake --build build
./build/window_events预期输出
[100%] Built target window_events
moved: <X>,<Y>
window resized: <WIDTH>x<HEIGHT>
framebuffer resized: <PIXEL_WIDTH>x<PIXEL_HEIGHT>
focus: lost
focus: gained
close requested实际输出可能只包含其中一部分,且顺序会随用户操作变化。只要每种操作能产生对应事件,并且关闭请求最终让主循环退出,就说明事件链路工作正常。
关键边界与常见错误
窗口尺寸和 framebuffer 尺寸必须分别处理。前者适合界面布局与鼠标坐标,后者决定渲染目标的像素大小;在高 DPI 屏幕上,两组数值可能不同。
不要在回调中加载资源、保存文件或调用耗时网络请求。回调执行过久会阻塞系统消息处理,使窗口表现为卡顿或“未响应”。事件队列也不应保存指向临时参数的裸指针,应复制当前事件所需的数据。
关闭事件可能与焦点丢失、移动或缩放事件连续到达。引擎应按队列顺序消费,但不要假设某一平台一定先发送哪一种事件。
本课总结
- GLFW 回调负责采集系统消息,主循环负责统一消费与改变引擎状态
- 统一事件队列可以隔离平台 API,并为后续输入系统和模块广播提供稳定边界
- 窗口逻辑尺寸、framebuffer 像素尺寸和事件顺序都需要按动态值处理
下一课预告
下一课将把窗口句柄、事件注册和生命周期管理封装成平台层接口,减少业务代码对 GLFW 的直接依赖。