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

处理系统事件

处理系统事件

本课把操作系统产生的窗口消息转换为引擎可处理的事件队列,统一接收关闭、移动、缩放、 framebuffer 尺寸变化和焦点变化,并在主循环中顺序分发。

学习目标

  • 区分系统回调、事件队列与主循环分发的职责
  • 捕获常用窗口事件并转换为统一数据结构
  • 验证事件顺序、动态参数和关闭请求是否被正确处理

事件处理链路

操作系统先把消息交给 GLFW,GLFW 再调用已注册的回调。平台层不应在回调中执行复杂业务,而应快速把事件写入队列,随后由主循环统一处理。这样可以避免系统回调直接修改多个引擎模块。

窗口系统事件分发流程

定义统一事件模型

一个最小事件只需要类型和两个整数参数。移动与缩放使用两个坐标值,焦点事件只使用第一个参数,关闭事件不需要额外数据。项目仍使用 GLFW 3.3 及 C++17。

cmake
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 默认关闭标记,再把关闭请求交给主循环决定,避免系统回调直接终止程序。

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

预期结果

text
移动窗口时输出 moved: <X>,<Y>。
缩放窗口时输出 window resized: <WIDTH>x<HEIGHT>。
高 DPI 环境还可能输出 framebuffer resized: <PIXEL_WIDTH>x<PIXEL_HEIGHT>。
切换到其他应用再返回时输出 focus: lost 与 focus: gained。
点击关闭按钮后输出 close requested,随后程序退出。

这些值和事件出现顺序由窗口管理器决定,因此不能把固定坐标或固定顺序写入业务判断。

构建与交互验证

完成两个文件后执行:

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

预期输出

text
[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 的直接依赖。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理系统事件

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

登录哪都通