69 lines
1.8 KiB
Markdown
69 lines
1.8 KiB
Markdown
|
# D3D12RenderTargetView
|
|||
|
|
|
|||
|
|
DirectX 12 渲染目标视图的 D3D12 实现。
|
|||
|
|
|
|||
|
|
## 头文件
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
#include <XCEngine/RHI/D3D12/D3D12RenderTargetView.h>
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 公共成员函数
|
|||
|
|
|
|||
|
|
### 构造函数与析构函数
|
|||
|
|
|
|||
|
|
#### `D3D12RenderTargetView()`
|
|||
|
|
默认构造函数。
|
|||
|
|
|
|||
|
|
#### `~D3D12RenderTargetView()`
|
|||
|
|
析构函数，确保调用 `Shutdown()`。
|
|||
|
|
|
|||
|
|
### 初始化
|
|||
|
|
|
|||
|
|
#### `void Initialize(ID3D12Device* device, ID3D12Resource* resource, const D3D12_RENDER_TARGET_VIEW_DESC* desc = nullptr)`
|
|||
|
|
在描述符堆中分配描述符并创建 RTV。
|
|||
|
|
- `device`: D3D12 设备
|
|||
|
|
- `resource`: 资源对象
|
|||
|
|
- `desc`: RTV 描述（可选，自动推断）
|
|||
|
|
|
|||
|
|
#### `void InitializeAt(ID3D12Device* device, ID3D12Resource* resource, D3D12_CPU_DESCRIPTOR_HANDLE handle, const D3D12_RENDER_TARGET_VIEW_DESC* desc = nullptr)`
|
|||
|
|
在指定描述符句柄位置创建 RTV。
|
|||
|
|
- `handle`: 预分配的描述符句柄
|
|||
|
|
|
|||
|
|
#### `void Shutdown()`
|
|||
|
|
释放 RTV（不释放资源）。
|
|||
|
|
|
|||
|
|
### 属性
|
|||
|
|
|
|||
|
|
#### `D3D12_CPU_DESCRIPTOR_HANDLE GetCPUDescriptorHandle() const`
|
|||
|
|
获取 CPU 描述符句柄。
|
|||
|
|
|
|||
|
|
### 静态辅助函数
|
|||
|
|
|
|||
|
|
#### `static D3D12_RENDER_TARGET_VIEW_DESC CreateDesc(Format format, D3D12_RTV_DIMENSION dimension = D3D12_RTV_DIMENSION_TEXTURE2D)`
|
|||
|
|
创建 RTV 描述。
|
|||
|
|
|
|||
|
|
## 内部成员
|
|||
|
|
|
|||
|
|
| 成员 | 类型 | 描述 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| `m_handle` | `D3D12_CPU_DESCRIPTOR_HANDLE` | CPU 描述符句柄 |
|
|||
|
|
| `m_resource` | `ID3D12Resource*` | 关联的资源 |
|
|||
|
|
|
|||
|
|
## 使用示例
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
D3D12RenderTargetView rtv;
|
|||
|
|
rtv.Initialize(device->GetDevice(), texture->GetResource());
|
|||
|
|
|
|||
|
|
// Or at specific handle
|
|||
|
|
D3D12_CPU_DESCRIPTOR_HANDLE handle = rtvHeap.GetCPUDescriptorHandle(0);
|
|||
|
|
D3D12RenderTargetView rtv2;
|
|||
|
|
rtv2.InitializeAt(device->GetDevice(), texture2->GetResource(), handle);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 备注
|
|||
|
|
|
|||
|
|
- RTV 不拥有底层资源，Shutdown 不会释放资源
|
|||
|
|
- RTV 必须在 RTV 类型描述符堆中分配
|