SampleGrad::SampleGrad (S,float,float,float,int,float) Texture1DArray 函数

使用渐变对纹理进行采样,以影响样本位置的计算方式,并包含可选值,用于将样本详细级别 (LOD) 固定到。

语法

DXGI_FORMAT SampleGrad(
  in SamplerState S,
  in float        Location,
  in float        DDX,
  in float        DDY,
  in int          Offset,
  in float        Clamp
);

parameters

S [ in]

类型 :SamplerState

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

位置 []

类型 :float

纹理坐标。 参数类型取决于纹理对象类型。

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

中的 DDX []

类型 :float

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

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

DDY []

类型 :float

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

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

偏移量 []

类型 :int

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

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

锁紧 []

类型 :float

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

返回值

类型 :DXGI _ FORMAT

纹理格式,它是 DXGI _ FORMAT中列出的类型值之一。

另请参阅

SampleGrad 方法