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) | 初始化交换链 |
| [`Shutdown`](shutdown.md) | 关闭交换链 |
| [`Present`](present.md) | 呈现画面 |
| [`SwapBuffers`](swap-buffers.md) | 交换缓冲 |
| [`Resize`](resize.md) | 调整交换链大小 |
| [`GetCurrentBackBufferIndex`](get-current-back-buffer-index.md) | 获取当前后台缓冲区索引 |
| [`GetCurrentBackBuffer`](get-current-back-buffer.md) | 获取当前后台缓冲区 |
| [`GetWidth`](get-width.md) | 获取宽度 |
| [`GetHeight`](get-height.md) | 获取高度 |
| [`GetNativeHandle`](get-native-handle.md) | 获取原生句柄 |

## 使用示例

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

// 创建并初始化
XCEngine::RHI::OpenGLSwapChain swapChain;
OpenGLDevice* device = /* 获取 OpenGLDevice */;
HWND window = /* 获取窗口句柄 */;
swapChain.Initialize(device, window, 1280, 720);

// 游戏循环
while (true) {
    // 渲染逻辑
    Render();

    swapChain.Present(1, 0);
}

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

## 相关文档

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