GLFW（Graphics Library Framework）

GLFW 官网
GLFW 的官方网站是 https://www.glfw.org/。官网提供了详细的文档、下载链接、教程和 API 参考，是学习和使用 GLFW 的最佳起点。

GLFW 基本用法
GLFW 是一个轻量级的库，专注于窗口管理、OpenGL 上下文创建和输入处理。以下是其基本用法：

1. 初始化 GLFW
在使用 GLFW 之前，必须先初始化库：

if (!glfwInit()) {
    // 初始化失败
    return -1;
}

2. 创建窗口和 OpenGL 上下文
创建一个窗口并绑定 OpenGL 上下文：

GLFWwindow* window = glfwCreateWindow(800, 600, "GLFW Example", NULL, NULL);
if (!window) {
    glfwTerminate(); // 如果窗口创建失败，终止 GLFW
    return -1;
}
glfwMakeContextCurrent(window); // 绑定上下文

3. 初始化 GLEW（可选）
如果需要使用现代 OpenGL 功能，可以初始化 GLEW：

glewExperimental = GL_TRUE; // 确保 GLEW 支持现代 OpenGL
if (glewInit() != GLEW_OK) {
    // GLEW 初始化失败
    return -1;
}

4. 主循环
在主循环中处理输入、渲染和交换缓冲区：

while (!glfwWindowShouldClose(window)) {
    // 处理输入
    glfwPollEvents();

    // 渲染代码
    glClear(GL_COLOR_BUFFER_BIT);

    // 交换缓冲区
    glfwSwapBuffers(window);
}

5. 清理资源
退出时销毁窗口并终止 GLFW：

glfwDestroyWindow(window);
glfwTerminate();

GLFW 架构
GLFW 的架构设计简单而高效，主要包括以下模块：

窗口管理：

创建和管理窗口。

处理窗口事件（如大小调整、关闭）。

上下文管理：

创建和管理 OpenGL 上下文。

支持多窗口和多上下文。

输入处理：

处理键盘、鼠标和游戏手柄输入。

提供输入回调机制。

监视器管理：

获取监视器信息（如分辨率、刷新率）。

支持全屏模式。

GLFW 源码结构
GLFW 的源码结构清晰，主要文件如下：

include/GLFW/：

包含所有头文件，如 glfw3.h。

src/：

包含所有平台相关的实现代码。

主要文件：

init.c：初始化逻辑。

window.c：窗口管理。

context.c：上下文管理。

input.c：输入处理。

monitor.c：监视器管理。

deps/：

包含依赖的外部库（如 GLAD、getopt）。

GLFW 编译过程
GLFW 支持多种平台（Windows、macOS、Linux），以下是编译 GLFW 的基本步骤：

1. 下载源码
从 GLFW 官网 下载源码。

2. 安装依赖
Windows：需要安装 CMake 和 Visual Studio。

macOS：需要安装 Xcode 和 CMake。

Linux：需要安装 GCC、CMake 和开发库（如 libx11-dev）。

3. 使用 CMake 生成构建系统
在源码目录下运行以下命令：

mkdir build
cd build
cmake ..

4. 编译
Windows：

打开生成的 Visual Studio 解决方案文件（.sln），然后编译。

macOS/Linux：

运行 make 命令：

make

5. 安装（可选）
将编译后的库和头文件安装到系统目录：

sudo make install

GLFW 示例项目
以下是一个完整的 GLFW 示例项目，展示如何创建一个窗口并渲染一个三角形：

CMakeLists.txt

cmake_minimum_required(VERSION 3.10)
project(GLFWExample)

set(CMAKE_CXX_STANDARD 11)

# 查找 GLFW
find_package(glfw3 REQUIRED)

# 添加可执行文件
add_executable(GLFWExample main.cpp)

# 链接 GLFW
target_link_libraries(GLFWExample glfw)

main.cpp

#include <GLFW/glfw3.h>
#include <GL/glew.h>
#include <iostream>

int main() {
    // 初始化 GLFW
    if (!glfwInit()) {
        std::cerr << "Failed to initialize GLFW" << std::endl;
        return -1;
    }

    // 创建窗口
    GLFWwindow* window = glfwCreateWindow(800, 600, "GLFW Example", NULL, NULL);
    if (!window) {
        std::cerr << "Failed to create GLFW window" << std::endl;
        glfwTerminate();
        return -1;
    }
    glfwMakeContextCurrent(window);

    // 初始化 GLEW
    if (glewInit() != GLEW_OK) {
        std::cerr << "Failed to initialize GLEW" << std::endl;
        return -1;
    }

    // 主循环
    while (!glfwWindowShouldClose(window)) {
        // 处理输入
        glfwPollEvents();

        // 渲染代码
        glClear(GL_COLOR_BUFFER_BIT);

        // 绘制三角形
        glBegin(GL_TRIANGLES);
            glVertex2f(-0.5f, -0.5f);
            glVertex2f(0.5f, -0.5f);
            glVertex2f(0.0f, 0.5f);
        glEnd();

        // 交换缓冲区
        glfwSwapBuffers(window);
    }

    // 清理资源
    glfwDestroyWindow(window);
    glfwTerminate();
    return 0;
}

总结

• GLFW 是一个轻量级、跨平台的库，专注于窗口管理和 OpenGL 上下文创建。

• 它的源码结构清晰，易于编译和集成到项目中。

• 通过 CMake 可以轻松编译 GLFW，并与其他库（如 GLEW）结合使用。

• 适用于现代 OpenGL 开发、图形引擎和高性能渲染应用。