SampleCmp::SampleCmp (S,float,float,int,float) function for Texture1D

对纹理采样,使用比较值拒绝样本,使用可选值将样本详细级别固定 (LOD) 值。

语法

DXGI_FORMAT SampleCmp(
  in SamplerState S,
  in float        Location,
  in float        CompareValue,
  in int          Offset,
  in float        Clamp
);

参数

S [in]

类型: SamplerState

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

位置 [in]

类型: float

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

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

 

CompareValue [in]

类型: float

要用作比较值的浮点值。

Offset [in]

类型: int

可选的纹理坐标偏移量,可用于任何纹理对象类型;在采样之前,偏移量应用于位置。 仅在整数偏移量处使用偏移量;否则,可能会得到无法很好地转换为硬件的结果。 参数类型依赖于纹理对象类型。 有关详细信息,请参阅 应用整数偏移量

Texture-Object类型 参数类型
Texture1D、Texture1DArray int
Texture2D、Texture2DArray int2
Texture3D int3
TextureCube、TextureCubeArray 不支持

 

Clamp [in]

类型: float

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

返回值

类型: DXGI_FORMAT

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

另请参阅

SampleCmp 方法