SampleGrad::SampleGrad (S,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 不支援 -
固定 [in]
-
類型: float
選擇性值,用來將範例 LOD 值限制為 。 例如,如果您傳遞 2.0f 作為限制值,則可確保沒有個別樣本存取小於 2.0f 的 mip 層級。
-
狀態 [out]
-
類型: uint
作業的狀態。 您無法直接存取狀態;而是將狀態傳遞至 CheckAccessFullyMapped 內建函式。 CheckAccessFullyMapped 如果對應範例、收集或載入作業中的所有值都存取了圖格資源中的對應磚,則 CheckAccessFullyMapped會傳回TRUE。 如果從未對應的磚取得任何值, CheckAccessFullyMapped 會傳回 FALSE。
傳回值
類型: DXGI_FORMAT
紋理格式,這是 DXGI_FORMAT中列出的其中一個具型別值。
另請參閱