2.5 KiB
2.5 KiB
D3D12Sampler 类
命名空间
XCEngine::RHI
类型
类 (Class)，继承自 RHISampler
描述
D3D12 采样器实现类，用于配置纹理采样状态。封装 D3D12 采样器描述符，支持过滤模式、寻址模式等采样参数配置。
概述
D3D12Sampler 是 RHI 抽象层在 DirectX 12 后端的采样器实现。该类管理 D3D12 采样器状态，与 RHISampler 基类配合提供跨平台统一的采样器接口。
当前实现状态: 本类为存根实现，Initialize() 仅存储描述符，未创建实际 D3D12 采样器对象。
公共方法表格
| 方法 | 签名 | 描述 |
|---|---|---|
D3D12Sampler |
D3D12Sampler() |
构造函数，初始化描述符为零 |
~D3D12Sampler |
~D3D12Sampler() |
析构函数，调用 Shutdown() |
Initialize |
bool Initialize(ID3D12Device* device, const D3D12_SAMPLER_DESC& desc) |
初始化采样器 |
Shutdown |
void Shutdown() |
关闭采样器，重置描述符 |
GetDesc |
D3D12_SAMPLER_DESC GetDesc() const |
获取采样器描述符副本 |
GetNativeHandle |
void* GetNativeHandle() |
获取原生句柄（暂未实现） |
GetID |
unsigned int GetID() |
获取采样器 ID（暂未实现） |
Bind |
void Bind(unsigned int unit) |
绑定到纹理单元（暂未实现） |
Unbind |
void Unbind(unsigned int unit) |
从纹理单元解绑（暂未实现） |
头文件
#include "XCEngine/RHI/D3D12/D3D12Sampler.h"
使用示例
#include "XCEngine/RHI/D3D12/D3D12Sampler.h"
using namespace XCEngine::RHI;
// 创建设备指针 (假设已创建)
ID3D12Device* device = ...;
// 配置采样器描述符
D3D12_SAMPLER_DESC samplerDesc = {};
samplerDesc.Filter = D3D12_FILTER_MIN_MAG_MIP_LINEAR;
samplerDesc.AddressU = D3D12_TEXTURE_ADDRESS_MODE_WRAP;
samplerDesc.AddressV = D3D12_TEXTURE_ADDRESS_MODE_WRAP;
samplerDesc.AddressW = D3D12_TEXTURE_ADDRESS_MODE_WRAP;
samplerDesc.MaxAnisotropy = 16;
samplerDesc.ComparisonFunc = D3D12_COMPARISON_FUNC_LESS;
samplerDesc.BorderColor[0] = 0.0f;
samplerDesc.BorderColor[1] = 0.0f;
samplerDesc.BorderColor[2] = 0.0f;
samplerDesc.BorderColor[3] = 1.0f;
// 创建并初始化采样器
D3D12Sampler* sampler = new D3D12Sampler();
if (sampler->Initialize(device, samplerDesc)) {
D3D12_SAMPLER_DESC desc = sampler->GetDesc();
// 使用采样器...
sampler->Shutdown();
}
delete sampler;