Files
XCEngine/docs/api/rhi/opengl/swap-chain/swap-chain.md
ssdfasd 8df04c120f docs: 更新 API 文档 - 多模块修复和完善
- audio: 更新 audio-system 方法文档
- components: 新增 audio-listener/audio-source 组件方法文档,新增 remove-component 方法
- core: 更新 filewriter, types 文档
- math: 更新 box 方法文档
- memory: 更新 proxy-allocator 文档
- resources: 更新 loader 和 texture 文档
- rhi: 更新 opengl 设备、shader、swap-chain 文档
- threading: 更新 mutex 和 task-system 文档
2026-03-26 01:58:45 +08:00

64 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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) - 抽象交换链接口