SampleCmp：：SampleCmp (S，float，float，float，float，uint) function for TextureCubeArray

  • 项目

对纹理进行采样，使用比较值拒绝样本，使用可选值将样本详细级别 (LOD) 值固定到。 返回有关操作的状态。

语法

DXGI_FORMAT SampleCmp(
  in  SamplerState S,
  in  float        Location,
  in  float        CompareValue,
  in  float        Clamp,
  out uint         Status
);

parameters

S [in]

类型： SamplerState

采样器状态。 这是在包含状态分配的效果文件中声明的对象。

位置 [in]

类型： float

纹理坐标。 参数类型依赖于纹理对象类型。

Texture-Object类型 参数类型
Texture1D FLOAT
Texture1DArray、Texture2D float2
Texture2DArray、Texture3D、TextureCube float3
TextureCubeArray float4

 

CompareValue [in]

类型： float

用作比较值的浮点值。

Clamp [in]

类型： float

用于将示例 LOD 值固定到的可选值。 例如，如果为固定值传递 2.0f，请确保没有单个样本访问小于 2.0f 的 mip 级别。

状态 [out]

类型： uint

操作的状态。 无法直接访问状态;而是将状态传递给 CheckAccessFullyMapped 内部函数。 如果相应的“采样”、“收集”或“加载”操作中的所有值都访问了平铺资源中的映射磁贴，CheckAccessFullyMapped 将返回 TRUE。 如果从未映射的磁贴中获取任何值， CheckAccessFullyMapped 将返回 FALSE。

返回值

类型： DXGI_FORMAT

纹理格式，它是 DXGI_FORMAT中列出的类型化值之一。

请参阅

SampleCmp 方法

TextureCubeArray