SampleGrad：：SampleGrad (S，float，float，float，int，float) function for Texture1DArray

使用漸層來取樣紋理，以影響取樣位置的計算方式，選擇性值可限制詳細資料的取樣層級， (LOD) 值。

語法

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

參數

S [in]

類型： SamplerState

取樣器狀態。 這是在包含狀態指派之效果檔案中宣告的物件。

位置 [in]

類型： float

材質座標。 引數類型相依于 texture-object 類型。

Texture-Object類型	參數類型
Texture1D	FLOAT
Texture1DArray、 Texture2D	float2
Texture2DArray、Texture3D、TextureCube	float3
TextureCubeArray	float4

 

DDX [in]

類型： float

以 x 方向變更表面幾何的速率。 引數類型相依于 texture-object 類型。

Texture-Object類型	參數類型
Texture1D、Texture1DArray	FLOAT
Texture2D、Texture2DArray	float2
Texture3D、TextureCube、TextureCubeArray	float3
Texture2DMS、Texture2DMSArray	不支援

 

DDY [in]

類型： float

以 Y 方向變更表面幾何的速率。 引數類型相依于 texture-object 類型。

Texture-Object類型	參數類型
Texture1D、Texture1DArray	FLOAT
Texture2D、Texture2DArray	float2
Texture3D、TextureCube、TextureCubeArray	float3
Texture2DMS、Texture2DMSArray	不支援

 

位移 [in]

類型： int

選擇性紋理座標位移，可用於任何紋理物件類型;位移會套用至取樣之前的位置。 只在整數位移處使用位移;否則，您可能會得到無法正確轉譯為硬體的結果。 引數類型相依于 texture-object 類型。 如需詳細資訊，請參閱 套用整數位移。

Texture-Object類型	參數類型
Texture1D、Texture1DArray	int
Texture2D、Texture2DArray	int2
Texture3D	int3
TextureCube、TextureCubeArray	不支援

 

限制 [in]

類型： float

要限制範例 LOD 值的選擇性值。 例如，如果您傳遞 2.0f 作為限制值，則確定沒有任何個別樣本存取小於 2.0f 的 mip 層級。

傳回值

類型： DXGI_FORMAT

紋理格式，這是 DXGI_FORMAT中列出的其中一個具型別值。

另請參閱

SampleGrad 方法