Texture2D の SampleCmp::SampleCmp(S,float,float,int,float,uint) 関数
Texture2D をサンプリングします。比較値を使用してサンプルを拒否し、オプションの値を使用してサンプルの詳細レベル (LOD) 値をクランプします。 操作に関する状態を返します。
構文
DXGI_FORMAT SampleCmp(
in SamplerState S,
in float Location,
in float CompareValue,
in int Offset,
in float Clamp,
out uint Status
);
パラメーター
-
S [in]
-
種類: SamplerState
サンプラーの状態。 これは、状態の割り当てを含む効果ファイルで宣言されたオブジェクトです。
-
Location [in]
-
型: float
テクスチャ座標。 引数の型は、texture-object 型に依存します。
Texture-Objectの種類 パラメーターの型 Texture1D float Texture1DArray、Texture2D float2 Texture2DArray、Texture3D、TextureCube float3 TextureCubeArray float4 -
CompareValue [in]
-
型: float
比較値として使用する浮動小数点値。
-
Offset [in]
-
型: int
任意のテクスチャ座標オフセット。任意のテクスチャ オブジェクト型に使用できます。オフセットはサンプリング前の位置に適用されます。 整数ミップレベルでのみオフセットを使用します。そうしないと、ハードウェアにうまく変換されない結果が得られる可能性があります。 引数の型は、texture-object 型に依存します。 詳細については、「 整数オフセットの適用」を参照してください。
Texture-Objectの種類 パラメーターの型 Texture1D、Texture1DArray INT Texture2D、Texture2DArray int2 Texture3D int3 TextureCube、TextureCubeArray サポート対象外 -
クランプ [入力]
-
型: float
サンプル LOD 値をクランプする省略可能な値。 たとえば、クランプ値に 2.0f を渡した場合、個々のサンプルが 2.0f 未満のミップ レベルにアクセスしないようにします。
-
状態 [out]
-
型: uint
操作の状態。 状態に直接アクセスすることはできません。代わりに、 状態を CheckAccessFullyMapped 組み込み関数に渡します。 CheckAccessFullyMapped は、対応する Sample、Gather、または Load 操作のすべての値がタイル リソース内のマップされたタイルにアクセスした場合に TRUE を返します。 マップされていないタイルから値が取得された場合、 CheckAccessFullyMapped は FALSE を返します。
戻り値
種類: DXGI_FORMAT
テクスチャ形式。これは、DXGI_FORMATに一覧表示されている型指定された値の 1 つです。
こちらもご覧ください