Texture2DArray::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 [入力]

サンプラーの状態。 これは、状態の割り当てを含む効果ファイルで宣言されたオブジェクトです。

場所 [入力]

テクスチャ座標。 引数の型は、テクスチャ オブジェクト型に依存します。

Texture-Objectの種類 パラメーターの型
Texture1D float
Texture1DArray、Texture2D float2
Texture2DArray、Texture3D、TextureCube float3
TextureCubeArray float4

 

Offset [in]

任意のテクスチャ座標オフセット。任意のテクスチャ オブジェクト型に使用できます。オフセットはサンプリング前の場所に適用されます。 整数 miplevel でのみオフセットを使用します。そうしないと、ハードウェアにうまく変換されない結果が得られる可能性があります。 引数の型は、テクスチャ オブジェクト型に依存します。 詳細については、「 整数オフセットの適用」を参照してください。

Texture-Objectの種類 パラメーターの型
Texture1D、Texture1DArray INT
Texture2D、Texture2DArray int2
Texture3D int3
TextureCube、TextureCubeArray サポート対象外

 

クランプ [入力]

サンプル LOD 値をクランプする省略可能な値。 たとえば、クランプ値に 2.0f を渡した場合、個々のサンプルが 2.0f 未満の mip レベルにアクセスしないようにします。

状態 [out]

操作の状態。 状態に直接アクセスすることはできません。代わりに、 状態を CheckAccessFullyMapped 組み込み関数に渡します。 対応する SampleGather、または Load 操作のすべての値がタイル リソース内のマップされたタイルにアクセスした場合、CheckAccessFullyMappedTRUE を返します。 マップされていないタイルから値が取得された場合、 CheckAccessFullyMappedFALSE を返します

戻り値

テクスチャ形式。これは、DXGI_FORMATに記載されている型指定された値の 1 つです。

こちらもご覧ください

サンプル メソッド