第19章 OpenGL/Vulkan封装

课程目录第19章 OpenGL/Vulkan封装

第19章：OpenGL/Vulkan封装：跨平台图形上下文创建、窗口系统集成（GLFW、SDL）

图形编程，说白了就是跟硬件打交道。而跨平台图形编程，就是跟不同操作系统上的不同硬件打交道。我做了这么多年跨平台开发，最深的体会就是：图形上下文创建和窗口系统集成，是绕不过去的两道坎。

你想想看，Windows上有WGL，Linux上有GLX，macOS上有CGL。每个平台都有自己的窗口系统和图形上下文创建方式。如果每个平台都写一套代码，那维护成本就太高了。所以我们需要一个统一的封装层。

19.1 为什么需要GLFW和SDL？

我个人习惯用GLFW或SDL来做窗口管理和上下文创建。它们帮我们做了三件核心的事：

窗口创建：跨平台创建原生窗口
上下文管理：创建并绑定OpenGL/Vulkan上下文
事件处理：键盘、鼠标、窗口事件统一回调

我在项目中遇到过这样一个场景：一个客户需要在Windows、macOS和Linux上运行同一个3D可视化工具。如果直接用原生API，光窗口创建就要写三套代码。用GLFW后，一套代码搞定。

核心原则：不要直接调用平台API创建窗口和上下文。用GLFW或SDL做中间层，你的代码就能一次编写，到处编译。

19.2 OpenGL上下文封装

我们先看OpenGL。GLFW创建OpenGL上下文的流程，其实很直接：

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

// 设置OpenGL版本和配置
glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 4);
glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 6);
glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE);

// 创建窗口
GLFWwindow* window = glfwCreateWindow(1280, 720, "My App", nullptr, nullptr);
if (!window) {
    glfwTerminate();
    return -1;
}

// 绑定上下文
glfwMakeContextCurrent(window);

// 加载OpenGL函数指针（用glad或glew）
if (!gladLoadGLLoader((GLADloadproc)glfwGetProcAddress)) {
    // 处理失败
    return -1;
}

嗯，这里要注意：OpenGL的函数指针加载必须在上下文创建之后。我刚开始做的时候，顺序搞反了，结果glad加载了一堆空指针，程序直接崩溃。排查了半天才发现是顺序问题。

小技巧：在macOS上，记得加上 glfwWindowHint(GLFW_OPENGL_FORWARD_COMPAT, GL_TRUE);，否则OpenGL 3.2以上版本可能无法正常工作。

19.3 Vulkan上下文封装

Vulkan的上下文创建比OpenGL复杂得多。它需要显式管理实例、物理设备、逻辑设备、队列等。GLFW对Vulkan的支持，主要体现在窗口表面（Surface）的创建上。

我曾经在Vulkan的初始化上踩过坑。Vulkan不像OpenGL那样有全局状态，所有东西都要自己创建和管理。来看一个典型的流程：

// 1. 创建Vulkan实例
VkInstance instance;
VkInstanceCreateInfo instanceInfo = {};
// ... 填充实例信息
vkCreateInstance(&instanceInfo, nullptr, &instance);

// 2. 创建窗口表面（GLFW帮我们做）
VkSurfaceKHR surface;
glfwCreateWindowSurface(instance, window, nullptr, &surface);

// 3. 选择物理设备
uint32_t deviceCount = 0;
vkEnumeratePhysicalDevices(instance, &deviceCount, nullptr);
// ... 选择支持图形和表面的设备

// 4. 创建逻辑设备
VkDevice device;
VkDeviceCreateInfo deviceInfo = {};
// ... 填充设备信息
vkCreateDevice(physicalDevice, &deviceInfo, nullptr, &device);

你看，Vulkan的每一步都需要显式调用。GLFW在这里只帮我们做了glfwCreateWindowSurface这一步。但这一步很关键——它屏蔽了不同平台创建窗口表面的差异。

避坑指南：我曾经在Windows上忘记启用VK_KHR_win32_surface扩展，结果表面创建失败。GLFW虽然帮我们创建了表面，但Vulkan实例必须启用对应的平台扩展。记得在创建实例时，用glfwGetRequiredInstanceExtensions获取需要的扩展列表。

19.4 封装设计：抽象图形上下文

在实际项目中，我通常会设计一个抽象层，把OpenGL和Vulkan统一起来。这样上层代码不需要关心底层用的是哪个图形API。

来看一个简单的封装设计：

class GraphicsContext {
public:
    virtual ~GraphicsContext() = default;
    virtual bool init(int width, int height, const char* title) = 0;
    virtual void swapBuffers() = 0;
    virtual void pollEvents() = 0;
    virtual bool shouldClose() = 0;
};

class GLContext : public GraphicsContext {
private:
    GLFWwindow* window;
public:
    bool init(int width, int height, const char* title) override {
        // 初始化GLFW，创建OpenGL上下文
        // ...
        return true;
    }
    void swapBuffers() override {
        glfwSwapBuffers(window);
    }
    void pollEvents() override {
        glfwPollEvents();
    }
    bool shouldClose() override {
        return glfwWindowShouldClose(window);
    }
};

class VulkanContext : public GraphicsContext {
private:
    GLFWwindow* window;
    VkInstance instance;
    VkDevice device;
    VkSurfaceKHR surface;
public:
    bool init(int width, int height, const char* title) override {
        // 初始化GLFW，创建Vulkan实例和设备
        // ...
        return true;
    }
    void swapBuffers() override {
        // Vulkan的交换链呈现
        // ...
    }
    void pollEvents() override {
        glfwPollEvents();
    }
    bool shouldClose() override {
        return glfwWindowShouldClose(window);
    }
};

这样设计的好处是：上层代码只需要操作GraphicsContext接口，切换图形API时只需要改一行代码。

19.5 SDL的集成方式

SDL和GLFW类似，但SDL提供了更多的功能：音频、输入、游戏手柄等。如果你需要这些功能，SDL是更好的选择。

SDL创建OpenGL上下文的代码也很简洁：

SDL_Window* window = SDL_CreateWindow("My App",
    SDL_WINDOWPOS_CENTERED, SDL_WINDOWPOS_CENTERED,
    1280, 720,
    SDL_WINDOW_OPENGL | SDL_WINDOW_SHOWN);

SDL_GLContext glContext = SDL_GL_CreateContext(window);
SDL_GL_MakeCurrent(window, glContext);

SDL对Vulkan的支持也类似：

SDL_Window* window = SDL_CreateWindow("Vulkan App",
    SDL_WINDOWPOS_CENTERED, SDL_WINDOWPOS_CENTERED,
    1280, 720,
    SDL_WINDOW_VULKAN | SDL_WINDOW_SHOWN);

VkSurfaceKHR surface;
SDL_Vulkan_CreateSurface(window, instance, &surface);

我的建议：如果你只需要窗口和图形上下文，GLFW更轻量。如果你还需要音频、游戏手柄等，SDL更合适。我在做游戏引擎时用SDL，做工具软件时用GLFW。

19.6 核心知识体系

下面这张图总结了本章的核心内容：

19.7 实际项目中的经验总结

最后，分享几个我在实际项目中的经验：

延迟初始化：不要在主线程创建上下文。我习惯在初始化阶段创建窗口，但延迟创建图形上下文，直到真正需要渲染时才创建。
多窗口支持：GLFW支持多窗口，但每个窗口需要独立的上下文。Vulkan的多窗口更复杂，需要为每个窗口创建独立的表面和交换链。
错误处理：图形API的错误往往很难排查。我建议在封装层加入详细的日志和断言，方便定位问题。
资源管理：OpenGL和Vulkan的资源（纹理、缓冲区、着色器）都需要显式释放。用RAII封装这些资源，避免内存泄漏。

重要提醒：不要在窗口销毁后还尝试访问图形上下文。我曾经在析构函数中顺序搞反了，先销毁了窗口，然后才释放Vulkan资源，结果程序崩溃。正确的顺序是：先释放所有图形资源，再销毁上下文，最后销毁窗口。

好了，关于OpenGL/Vulkan的跨平台封装，就讲到这里。记住一句话：用GLFW或SDL做窗口和上下文管理，用抽象接口隔离图形API，你的代码就能真正跨平台。

📚 课程目录