SampleGrad：：SampleGrad (S，float，float，float，float，float，int，float，uint) function for Texture2D
使用渐变对 Texture2D 采样，以影响样本位置的计算方式，使用可选值来固定样本详细级别 (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
);
参数
-
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 不支持 -
Clamp [in]
-
类型： float
用于将示例 LOD 值固定到的可选值。 例如，如果为固定值传递 2.0f，请确保没有单个样本访问小于 2.0f 的 mip 级别。
-
状态 [out]
-
类型： uint
操作的状态。 无法直接访问状态;而是将状态传递给 CheckAccessFullyMapped 内部函数。 如果相应的“采样”、“收集”或“加载”操作中的所有值都访问了平铺资源中的映射磁贴，CheckAccessFullyMapped 将返回 TRUE。 如果从未映射的磁贴中获取任何值， CheckAccessFullyMapped 将返回 FALSE。
返回值
类型： DXGI_FORMAT
纹理格式，它是 DXGI_FORMAT中列出的类型化值之一。
另请参阅