SampleGrad::SampleGrad(S,float,float,float,int,float,uint) 関数 (Texture2DArray 用)
テクスチャをサンプリングします。グラデーションを使用してサンプルの位置の計算方法に影響を与え、オプションの値を使用してサンプルの詳細レベル (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
サンプラーの状態。 これは、状態の割り当てを含む効果ファイルで宣言されたオブジェクトです。
-
Location [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 サポート対象外 -
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 つです。
こちらもご覧ください