GLFW（图形库框架）

GLFW 是一个轻量级的 C 语言库，是一个平台无关的窗口工具包，专门用于窗口创建、OpenGL / Vulkan 上下文管理以及原始输入处理（键盘、鼠标、游戏手柄）这些操作需要编写大量繁琐的样板代码，而 GLFW 将这些代码封装成一个简洁、干净、小巧的 API，并且通常情况下，它能够独立于操作系统底层窗口 API 的细节而正常工作。。它不处理图形渲染本身（那是 OpenGL 或 Vulkan 的工作），而是为这些图形 API 提供一个跨平台的“运行平台”——即窗口和用户交互。

一、为什么需要 GLFW？

OpenGL 规范本身不包含窗口创建或输入处理，这些是操作系统相关的事务（Windows 上要用 Win32 API 创建窗口并设置 OpenGL 上下文，Linux 上可能需要 X11 或 Wayland，macOS 则用 Cocoa）。直接使用原生 API 编写可移植程序极其繁琐，且容易出错。GLFW 将这些底层细节封装成一套简洁、统一的 API，开发者只需关心窗口的宽高、标题、是否需要全屏等高级概念，GLFW 在背后自动适配当前操作系统。

二、GLFW 的核心功能

1. 窗口管理

   • 创建和销毁窗口（支持普通窗口、全屏窗口、无边框窗口）。

   • 设置窗口标题、大小、位置、大小限制、透明度、图标等。

   • 支持多显示器环境，可查询显示器信息、视频模式，并在不同显示器间移动窗口。

2. 上下文管理

   • 为窗口创建 OpenGL（或 OpenGL ES、Vulkan）上下文。

   • 支持上下文共享（多个窗口共享纹理、VBO 等资源）。

   • 可指定 OpenGL 版本、核心/兼容模式、调试上下文、交换间隔（垂直同步）等。

3. 输入处理

   • 键盘：查询按键状态、处理字符输入（支持 Unicode）。

   • 鼠标：光标位置、光标模式（隐藏、锁定、相对模式）、滚轮、鼠标按钮。

   • 游戏手柄：支持标准 Xbox/PlayStation 手柄映射，提供轴、按钮状态查询。

   • 支持原始鼠标移动（适用于第一人称相机，避免系统加速度）。

4. 时间与事件循环

   • 高精度计时器（glfwGetTime，秒级精度）。

   • 事件轮询（glfwPollEvents）或等待事件（glfwWaitEvents）。

   • 支持用户自定义回调（窗口关闭、大小改变、帧缓冲大小改变、错误回调等）。

三、GLFW 的设计哲学

• 轻量级：只做三件事——窗口、上下文、输入。不涉及图像加载、字体渲染、音视频播放、网络、线程等。开发者可以自由组合其他库（如 stb_image 加载纹理，FreeType 渲染文字，OpenAL 播放声音）。

• 跨平台：官方支持 Windows、macOS、Linux（X11 与 Wayland），以及实验性的 FreeBSD、OpenBSD、NetBSD、Haiku 等。同一份代码几乎无需修改即可在不同平台编译运行。

• 现代化：相比老旧的 GLUT 或 FreeGLUT，GLFW 提供了更合理的 API（例如使用回调代替全局函数指针，支持现代 OpenGL 版本选择），并且持续更新以适配新系统特性（如 High-DPI 支持、Vulkan 集成）。

• 简单易用：API 函数数量少（核心约 50 个），命名直观，文档清晰。新手可以在几十行代码内创建一个 OpenGL 窗口并开始绘制。

四、GLFW 的历史与版本

• 诞生：GLFW 最初由 Camilla Löwy（又名“elmindreda”）于 2002 年开发，作为对其硕士项目窗口管理代码的重构。早期版本主要服务于个人需求，后来逐步完善并开源。

• 2.x 系列：早期版本采用 C 语言编写，API 相对简单但功能有限（例如不支持多显示器，OpenGL 版本控制较弱）。2.7.x 是 2.x 系列的最终稳定版，仍有部分老项目使用。

• 3.x 系列：2012 年发布的 GLFW 3.0 是一次重大重写，引入了更清晰的 API（如 glfwInit / glfwTerminate 配对，错误回调机制），支持 OpenGL 3.x+ 核心模式、多显示器、游戏手柄等。目前最新稳定版是 GLFW 3.4（2024 年 2 月），修复了许多 bug，并改进了 Wayland 和 macOS 支持。

• 未来方向：GLFW 3.x 仍在维护，但不会引入颠覆性变化。作者曾讨论过 GLFW 4 的可能性（例如完全移除对 GLUT 兼容层的依赖，采用更现代的 C 语言特性），但尚无明确时间表。

五、与其他窗口/输入库的对比

总结：如果只需要一个干净的 OpenGL 窗口和输入，GLFW 是最佳选择；如果需要 2D 渲染、音频等附加功能，SDL 或 SFML 更合适；如果需要制作复杂的 GUI 界面，考虑 Qt 或 imgui+GLFW 组合。

六、基本使用示例（C++ 风格）

#include <GLFW/glfw3.h>

int main() {
    // 初始化 GLFW
    if (!glfwInit()) return -1;

    // 配置 OpenGL 版本（例如 3.3 核心模式）
    glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3);
    glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 3);
    glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE);

    // 创建窗口
    GLFWwindow* window = glfwCreateWindow(800, 600, "Hello GLFW", nullptr, nullptr);
    if (!window) {
        glfwTerminate();
        return -1;
    }
    glfwMakeContextCurrent(window);

    // 加载 OpenGL 函数指针（需要 GLAD 或 GLEW）
    // if (!gladLoadGLLoader((GLADloadproc)glfwGetProcAddress)) return -1;

    // 主循环
    while (!glfwWindowShouldClose(window)) {
        glClear(GL_COLOR_BUFFER_BIT);
        glfwSwapBuffers(window);
        glfwPollEvents();
    }

    glfwDestroyWindow(window);
    glfwTerminate();
    return 0;
}

七、语言绑定

GLFW 虽然用 C 编写，但提供了多种语言的绑定，使得非 C/C++ 开发者也能使用。官方仓库维护了部分语言的绑定列表，社区也为许多其他语言提供了封装。常见的有：

• Python：glfw 包（通过 pip install glfw）

• Rust：glfw-rs 或 glfw-sys

• C#：GLFW.Net、Silk.NET、OpenTK（后两者集成了 OpenGL 绑定）

• Java：LWJGL（包含 GLFW 绑定）、JGLFW

• Go：go-gl/glfw

• Julia：GLFW.jl

这些绑定通常直接映射 C API，或稍作调整以适应目标语言的惯用法（例如使用事件流代替回调）。