Files
XCEngine/docs/api/rhi/sampler/sampler.md
2026-03-20 02:35:45 +08:00

1.7 KiB

RHISampler

命名空间: XCEngine::RHI

类型: class (abstract)

头文件: RHISampler.h

描述: GPU 纹理采样器抽象接口,用于配置纹理过滤和寻址模式。采样器定义了如何对纹理进行采样,包括过滤模式、寻址模式和各向异性级别等参数。

概述

RHISampler 是 RHI 抽象层中的纹理采样器接口,提供跨平台的纹理采样配置能力。通过 RHIDevice::CreateSampler 创建采样器实例。

关键特性:

  • 支持点采样、线性采样和各向异性采样
  • 支持 Wrap、Mirror、Clamp、Border 等寻址模式
  • 提供原生 API 句柄访问

公共方法

方法 描述
Shutdown 关闭并释放资源
Bind 绑定采样器到纹理单元
Unbind 解绑采样器
GetNativeHandle 获取原生句柄
GetID 获取采样器 ID

使用示例

// 通过 RHIDevice 创建采样器
SamplerDesc samplerDesc;
samplerDesc.filter = static_cast<uint32_t>(FilterMode::Anisotropic);
samplerDesc.addressU = static_cast<uint32_t>(TextureAddressMode::Wrap);
samplerDesc.addressV = static_cast<uint32_t>(TextureAddressMode::Wrap);
samplerDesc.addressW = static_cast<uint32_t>(TextureAddressMode::Wrap);
samplerDesc.maxAnisotropy = 16;
samplerDesc.minLod = 0;
samplerDesc.maxLod = FLT_MAX;

RHISampler* sampler = device->CreateSampler(samplerDesc);

// 绑定到纹理单元 0
sampler->Bind(0);

// 使用完毕后关闭
sampler->Shutdown();

相关文档