Emscripten-glfw 项目使用教程

1. 项目目录结构及介绍

Emscripten-glfw 项目是一个将 GLFW 库移植到 Web 平台的 C++ 项目。以下是项目的目录结构及各部分功能的简要介绍：

emscripten-glfw/
├── .github/               # GitHub 工作流程和文档
├── docs/                  # 项目文档
├── examples/              # 示例代码
│   ├── example_asyncify/
│   ├── example_hi_dpi/
│   ├── example_minimal/
│   ├── example_resizable_container/
│   ├── example_resizable_container_with_handle/
│   ├── example_resizable_full_window/
│   ├── example_pthread/
│   └── example_offscreen_canvas/
├── external/              # 外部库，如 GLFW
├── include/               # 头文件目录
│   └── GLFW/
├── port/                  # GLFW 的 Emscripten 移植代码
├── src/                   # 源代码目录
├── test/                  # 测试代码
│   └── demo/
├── tools/                 # 工具脚本
├── .gitignore             # Git 忽略文件列表
├── CMakeLists.txt         # CMake 配置文件
├── LICENSE.txt            # 项目许可证
└── README.md              # 项目自述文件

2. 项目的启动文件介绍

项目的启动文件通常是 main.cpp 文件，它位于项目根目录或示例代码目录中。以下是启动文件的基本结构：

#include <emscripten/emscripten.h>
#include <GLFW/glfw3.h>

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

    // 创建窗口
    GLFWwindow* window = glfwCreateWindow(640, 480, "Emscripten GLFW", NULL, NULL);
    if (!window) {
        glfwTerminate();
        return -1;
    }

    // 主循环
    while (!glfwWindowShouldClose(window)) {
        // 渲染逻辑
        glClear(GL_COLOR_BUFFER_BIT);

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

        // 处理事件
        glfwPollEvents();
    }

    // 关闭窗口并终止 GLFW
    glfwDestroyWindow(window);
    glfwTerminate();
    return 0;
}

在这个文件中，我们初始化 GLFW，创建一个窗口，然后进入一个循环，直到窗口关闭。在循环中，我们清除屏幕，交换颜色缓冲区，并处理事件。

3. 项目的配置文件介绍

项目的配置文件主要是 CMakeLists.txt，它用于配置 CMake 构建系统。以下是配置文件的基本内容：

cmake_minimum_required(VERSION 3.13)
project(EmscriptenGLFW)

set(CMAKE_CXX_STANDARD 11)

# 添加 Emscripten 的编译选项
set(EMSCRIPTEN_FLAGS "-s USE_GLFW=3")

# 添加源文件
add_executable(my_project src/main.cpp)

# 链接 Emscripten-glfw 库
target_link_options(my_project PRIVATE ${EMSCRIPTEN_FLAGS})

在这个文件中，我们设置了 CMake 的最小版本要求，定义了项目名称，指定了 C++ 标准，并添加了 Emscripten 的编译选项。我们还指定了项目的主源文件，并设置了链接选项。

这些是 Emscripten-glfw 项目的基本组成部分，您可以根据自己的需求对它们进行修改和扩展。