137 lines
3.3 KiB
Markdown
137 lines
3.3 KiB
Markdown
# D3D12SwapChain
|
||
|
||
DirectX 12 交换链的 D3D12 实现，封装了 `IDXGISwapChain3`。
|
||
|
||
## 头文件
|
||
|
||
```cpp
|
||
#include <XCEngine/RHI/D3D12/D3D12SwapChain.h>
|
||
```
|
||
|
||
## 继承关系
|
||
|
||
```
|
||
RHISwapChain (interface)
|
||
└── D3D12SwapChain (implementation)
|
||
```
|
||
|
||
## 公共成员函数
|
||
|
||
### 构造函数与析构函数
|
||
|
||
#### `D3D12SwapChain()`
|
||
默认构造函数。
|
||
|
||
#### `~D3D12SwapChain() override`
|
||
析构函数，确保调用 `Shutdown()`。
|
||
|
||
### 初始化
|
||
|
||
#### `bool Initialize(IDXGIFactory4* factory, ID3D12CommandQueue* commandQueue, HWND windowHandle, uint32_t width, uint32_t height, uint32_t bufferCount = 2)`
|
||
创建新的交换链。
|
||
- `factory`: DXGI Factory
|
||
- `commandQueue`: 命令队列
|
||
- `windowHandle`: 窗口句柄
|
||
- `width` / `height`: 交换链尺寸
|
||
- `bufferCount`: 后台缓冲区数量（默认 2）
|
||
- 返回: 初始化是否成功
|
||
|
||
#### `bool Initialize(IDXGISwapChain* swapChain, uint32_t width, uint32_t height)`
|
||
从现有 `IDXGISwapChain` 初始化。
|
||
- `swapChain`: 已存在的交换链
|
||
- `width` / `height`: 尺寸
|
||
- 返回: 初始化是否成功
|
||
|
||
#### `void Shutdown() override`
|
||
释放交换链资源。
|
||
|
||
### 交换链操作
|
||
|
||
#### `uint32_t GetCurrentBackBufferIndex() const override`
|
||
获取当前后台缓冲区索引。
|
||
|
||
#### `RHITexture* GetCurrentBackBuffer() override`
|
||
获取当前后台缓冲区纹理。
|
||
|
||
#### `D3D12Texture* GetBackBuffer(uint32_t index) const`
|
||
获取指定索引的后台缓冲区。
|
||
|
||
#### `void Present(uint32_t syncInterval = 1, uint32_t flags = 0) override`
|
||
呈现（显示）内容。
|
||
- `syncInterval`: 垂直同步间隔 (0=立即, 1-4=等待)
|
||
- `flags`: 附加标志
|
||
|
||
#### `void Resize(uint32_t width, uint32_t height) override`
|
||
调整交换链尺寸。
|
||
|
||
### 显示模式
|
||
|
||
#### `void SetFullscreen(bool fullscreen) override`
|
||
切换全屏模式。
|
||
|
||
#### `bool IsFullscreen() const override`
|
||
检查是否处于全屏模式。
|
||
|
||
### 事件处理
|
||
|
||
#### `bool ShouldClose() const override`
|
||
检查是否应该关闭（全屏时按 Alt+Enter）。
|
||
|
||
#### `void SetShouldClose(bool shouldClose)`
|
||
设置关闭标志。
|
||
|
||
#### `void PollEvents() override`
|
||
轮询窗口事件。
|
||
|
||
### 原生接口
|
||
|
||
#### `void* GetNativeHandle() override`
|
||
获取原生句柄。
|
||
|
||
#### `IDXGISwapChain3* GetSwapChain() const`
|
||
获取底层 `IDXGISwapChain3` 指针。
|
||
|
||
## 内部成员
|
||
|
||
| 成员 | 类型 | 描述 |
|
||
|------|------|------|
|
||
| `m_swapChain` | `ComPtr<IDXGISwapChain3>` | DXGI 交换链 |
|
||
| `m_commandQueue` | `ComPtr<ID3D12CommandQueue>` | 命令队列引用 |
|
||
| `m_windowHandle` | `HWND` | 窗口句柄 |
|
||
| `m_width` | `uint32_t` | 宽度 |
|
||
| `m_height` | `uint32_t` | 高度 |
|
||
| `m_bufferCount` | `uint32_t` | 缓冲区数量 |
|
||
| `m_backBuffers` | `vector<D3D12Texture>` | 后台缓冲区纹理 |
|
||
|
||
## 使用示例
|
||
|
||
```cpp
|
||
D3D12SwapChain swapChain;
|
||
swapChain.Initialize(
|
||
device->GetFactory(),
|
||
cmdQueue->GetCommandQueue(),
|
||
hwnd, 1920, 1080, 2);
|
||
|
||
// Render loop
|
||
while (!swapChain.ShouldClose()) {
|
||
swapChain.PollEvents();
|
||
|
||
auto backBuffer = swapChain.GetCurrentBackBuffer();
|
||
// Transition to render target state
|
||
// Render...
|
||
// Transition to present state
|
||
|
||
swapChain.Present(1, 0);
|
||
}
|
||
|
||
// Resize
|
||
swapChain.Resize(3840, 2160);
|
||
```
|
||
|
||
## 备注
|
||
|
||
- `syncInterval = 0`: 立即呈现，可能产生撕裂
|
||
- `syncInterval = 1`: 等待垂直同步（推荐）
|
||
- 全屏模式切换需要处理窗口消息
|
||
- 窗口尺寸改变后必须调用 `Resize`
|