SampleGrad：：Texture1D 的 SampleGrad (S、float、float、float、int、float、uint) 函数

使用渐变对纹理进行采样，以影响计算样本位置的方式，可选值用于固定样本详细级别 (LOD) 值。 返回有关操作的状态。

语法

DXGI_FORMAT SampleGrad(
  in  SamplerState S,
  in  float        Location,
  in  float        DDX,
  in  float        DDY,
  in  int          Offset,
  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

 

DDX [in]

类型： float

x 方向表面几何图形的变化速率。 参数类型依赖于纹理对象类型。

Texture-Object类型	参数类型
Texture1D、Texture1DArray	FLOAT
Texture2D、Texture2DArray	float2
Texture3D、TextureCube、TextureCubeArray	float3
Texture2DMS、Texture2DMSArray	不支持

 

DDY [in]

类型： float

y 方向表面几何图形的变化速率。 参数类型依赖于纹理对象类型。

Texture-Object类型	参数类型
Texture1D、Texture1DArray	FLOAT
Texture2D、Texture2DArray	float2
Texture3D、TextureCube、TextureCubeArray	float3
Texture2DMS、Texture2DMSArray	不支持

 

偏移量 [in]

类型： int

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

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

 

固定 [in]

类型： float

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

状态 [out]

类型： uint

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

返回值

类型： DXGI_FORMAT

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

另请参阅

SampleGrad 方法