Files
XCEngine/docs/api/rhi/sampler/sampler.md
ssdfasd d83ed56177 fix(rhi): Fix RHI abstraction layer API docs per api-skill.md template
- Rename texture/dtor.md to destructor.md per template spec
- Remove duplicate non-hyphenated fence docs (getnativehandle.md, issignaled.md, getcompletedvalue.md)
- Fix template field issues:
  - swap-chain, command-queue: 类型 now uses 'class (abstract)'
  - sampler: 头文件 now uses full path 'XCEngine/RHI/RHISampler.h'
  - types: 类型 fixed from 'structs' to 'struct'
  - enums: 类型 fixed from 'enums' to 'enum class'
- Fix include paths in command-queue and pipeline-layout code examples
- Create missing constructor/destructor docs for 11 classes:
  buffer, texture, shader, device, command-list, command-queue,
  fence, sampler, swap-chain, pipeline-state, pipeline-layout
- Update class overview pages to include constructor/destructor entries
2026-03-22 03:07:41 +08:00

1.9 KiB

RHISampler

命名空间: XCEngine::RHI

类型: class (abstract)

头文件: XCEngine/RHI/RHISampler.h

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

概述

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

关键特性:

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

公共方法

方法 描述
RHISampler 默认构造函数
~RHISampler 虚析构函数
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();

相关文档