Texture1DArray::Sample (S,float,int,float,uint) 函式

使用選擇性值來取樣紋理,以將取樣詳細層級 (LOD) 值,並傳回作業的狀態。

語法

DXGI_FORMAT Sample(
  in  SamplerState S,
  in  float        Location,
  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

 

位移 [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中列出的其中一個具型別值。

另請參閱

範例方法