IDirect3DDevice9::SetTexture メソッド (d3d9.h)

[アーティクル]
02/26/2024

デバイスのステージにテクスチャを割り当てます。

構文

HRESULT SetTexture(
  [in] DWORD                 Stage,
  [in] IDirect3DBaseTexture9 *pTexture
);

パラメーター

[in] Stage

種類: DWORD

0 から始まるサンプラー番号。テクスチャはサンプラーにバインドされます。サンプラーは、フィルタリングモードやアドレスラッピングモードなどのサンプリング状態を定義します。テクスチャは、プログラミング可能な関数パイプラインと固定関数パイプラインによって異なる方法で参照されます。

プログラミング可能なシェーダーは、サンプラー番号を使用してテクスチャを参照します。プログラム可能なシェーダーで使用できるサンプラーの数は、シェーダーのバージョンによって異なります。頂点シェーダーについては、「サンプラー (Direct3D 9 asm-vs)」を参照してください。ピクセルシェーダーについては、「サンプラー (Direct3D 9 asm-ps)」を参照してください。
一方、固定関数パイプラインでは、テクスチャステージ番号によってテクスチャが参照されます。サンプラーの最大数は、D3DCAPS9構造体の MaxSimultaneousTextures と MaxTextureBlendStages の 2 つのキャップから決定されます。

ステージ/サンプラー番号には、他に 2 つの特別なケースがあります。

ディスプレイスメントマッピング (Direct3D 9) には、D3DDMAPSAMPLER と呼ばれる特殊な番号が使用されます。
プログラム可能な頂点シェーダーは、 vs_3_0 (DirectX HLSL) の頂点テクスチャにアクセスするときに、D3DVERTEXTEXTURESAMPLERによって定義された特殊な数値を使用します。

[in] pTexture

種類: IDirect3DBaseTexture9*

設定されているテクスチャを表す IDirect3DBaseTexture9 インターフェイスへのポインター。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。メソッドが失敗した場合は、戻り値をD3DERR_INVALIDCALLできます。

注釈

D3DPOOL_SCRATCHのプールの種類でテクスチャを作成する場合、SetTexture は許可されません。 DevCaps が D3DDEVCAPS_TEXTURESYSTEMMEMORY で設定されていない限り、D3DPOOL_SYSTEMMEM テクスチャのプールの種類では SetTexture を使用できません。