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

[アーティクル]
08/23/2023

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

構文

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 は使用できません。