Texture2D の SampleGrad::SampleGrad(S,float,float,float,int,float) 関数

Texture2D をサンプリングし、グラデーションを使用してサンプルの場所の計算方法に影響を与え、オプションの値を使用してサンプルの詳細レベル (LOD) 値をクランプします。

構文

DXGI_FORMAT SampleGrad(
  in SamplerState S,
  in float        Location,
  in float        DDX,
  in float        DDY,
  in int          Offset,
  in float        Clamp
);

パラメーター

S [入力]

型: SamplerState

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

場所 [入力]

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

型: float

y 方向のサーフェス ジオメトリの変化率。 引数の型は、テクスチャ オブジェクト型に依存します。

Texture-Objectの種類	パラメーターの型
Texture1D、Texture1DArray	float
Texture2D、Texture2DArray	float2
Texture3D、TextureCube、TextureCubeArray	float3
Texture2DMS、Texture2DMSArray	サポート対象外

 

Offset [in]

型: int

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

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

 

クランプ [入力]

型: float

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

戻り値

種類: DXGI_FORMAT

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

関連項目

SampleGrad メソッド