Condividi tramite


Metodo IDirect3DDevice9::SetTexture (d3d9helper.h)

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.

[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.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione d3d9helper.h (include D3D9.h)
Libreria D3D9.lib

Vedi anche

GetTexture

GetTextureStageState

IDirect3DDevice9

SetTextureStageState