XCEngine/docs/api/rhi/opengl/swap-chain/swap-chain.md

# OpenGLSwapChain

**命名空间**: `XCEngine::RHI`

**类型**: `class`

**描述**: OpenGL 交换链实现，继承自 `RHISwapChain`。基于 GLFW 窗口管理，用于 OpenGL 渲染的帧缓冲交换。

## 概述

`OpenGLSwapChain` 是 OpenGL 后端的交换链实现，负责管理渲染目标帧缓冲的呈现。它继承自 `RHISwapChain` 抽象接口，通过 GLFW 窗口系统进行帧缓冲交换。

### 枚举类型

| 枚举 | 描述 |
|------|------|
| [`PresentMode`](present-mode.md) | 呈现模式（Immediate/VSync/Mailbox/Fifo） |
| [`SurfaceFormat`](surface-format.md) | 表面格式（RGBA8/RGBA16F/RGBA32F/BGRA8） |

## 公共方法

| 方法 | 描述 |
|------|------|
| [`OpenGLSwapChain`](constructor.md) | 构造函数 |
| [`~OpenGLSwapChain`](destructor.md) | 析构函数 |
| [`Initialize`](initialize.md) | 初始化交换链 |
| [`Initialize(mode)`](initialize-mode.md) | 使用模式初始化 |
| [`Shutdown`](shutdown.md) | 关闭交换链 |
| [`Present`](present.md) | 呈现画面 |
| [`SwapBuffers`](swap-buffers.md) | 交换缓冲 |
| [`Resize`](resize.md) | 调整交换链大小 |
| [`SetVSync`](set-vsync.md) | 设置垂直同步 |
| [`IsVSync`](is-vsync.md) | 检查是否垂直同步 |
| [`SetFullscreen`](set-fullscreen.md) | 设置全屏模式 |
| [`IsFullscreen`](is-fullscreen.md) | 检查是否全屏 |
| [`ShouldClose`](should-close.md) | 检查是否应关闭 |
| [`SetShouldClose`](set-should-close.md) | 设置关闭标志 |
| [`PollEvents`](poll-events.md) | 处理窗口事件 |
| [`GetCurrentBackBufferIndex`](get-current-back-buffer-index.md) | 获取当前后台缓冲区索引 |
| [`GetCurrentBackBuffer`](get-current-back-buffer.md) | 获取当前后台缓冲区 |
| [`GetWidth`](get-width.md) | 获取宽度 |
| [`GetHeight`](get-height.md) | 获取高度 |
| [`GetFramebufferWidth`](get-framebuffer-width.md) | 获取帧缓冲宽度 |
| [`GetFramebufferHeight`](get-framebuffer-height.md) | 获取帧缓冲高度 |
| [`SetFramebufferSize`](set-framebuffer-size.md) | 设置帧缓冲大小 |
| [`GetWindow`](get-window.md) | 获取窗口 |
| [`GetNativeHandle`](get-native-handle.md) | 获取原生句柄 |

## 使用示例

```cpp
#include <XCEngine/RHI/OpenGL/OpenGLSwapChain.h>

// 创建并初始化
XCEngine::RHI::OpenGLSwapChain swapChain;
GLFWwindow* window = /* 获取 GLFW 窗口 */;
swapChain.Initialize(window, true);

// 游戏循环
while (!swapChain.ShouldClose()) {
    swapChain.PollEvents();
    
    // 渲染逻辑
    Render();
    
    swapChain.Present(1, 0);
}

// 关闭
swapChain.Shutdown();
```

## 相关文档

- [OpenGL 后端总览](../opengl.md)
- [RHISwapChain](../../swap-chain/swap-chain.md) - 抽象交换链接口