Metodo IDirect3DDevice9::SetTexture (d3d9helper.h)

Articolo
02/28/2024

Assegna una trama a una fase per un dispositivo.

Sintassi

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

Parametri

[in] Stage

Tipo: DWORD

Numero di sampler in base zero. Le trame sono associate ai campioni; gli esempi definiscono lo stato di campionamento, ad esempio la modalità di filtro e la modalità di wrapping degli indirizzi. Le trame vengono a cui si fa riferimento in modo diverso dalla pipeline programmabile e dalla pipeline di funzioni fisse:

Trame di riferimento di shader programmabili usando il numero di sampler. Il numero di sampler disponibili per uno shader programmabile dipende dalla versione dello shader. Per i vertex shader, vedere Sampler (Direct3D 9 asm-vs). Per pixel shader, vedere Sampler (Direct3D 9 asm-ps).
La pipeline della funzione fissa, invece, fa riferimento alle trame in base al numero di fase della trama. Il numero massimo di sampler viene determinato da due maiuscole: MaxSimultaneousTextures e MaxTextureBlendStages della struttura D3DCAPS9 .

Esistono due altri casi speciali per i numeri stage/sampler.

Viene usato un numero speciale denominato D3DDMAPSAMPLER per mapping di spostamento (Direct3D 9).
Un vertex shader programmabile usa un numero speciale definito da un D3DVERTEXTEXTURESAMPLER durante l'accesso a Vertex Textures in vs_3_0 (DirectX HLSL).

[in] pTexture

Tipo: IDirect3DBaseTexture9*

Puntatore a un'interfaccia IDirect3DBaseTexture9 che rappresenta la trama impostata.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere D3DERR_INVALIDCALL.

Commenti

SetTexture non è consentito se la trama viene creata con un tipo di pool di D3DPOOL_SCRATCH. SetTexture non è consentito con un tipo di pool di D3DPOOL_SYSTEMMEM trama a meno che DevCaps non sia impostato con D3DDEVCAPS_TEXTURESYSTEMMEMORY.