Partager via


Méthode IDirect3DDevice9 ::SetTexture (d3d9.h)

Affecte une texture à une étape pour un appareil.

Syntaxe

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

Paramètres

[in] Stage

Type : DWORD

Numéro d’échantillonneur basé sur zéro. Les textures sont liées aux échantillonneurs ; les échantillonneurs définissent l’état d’échantillonnage, par exemple le mode de filtrage et le mode d’habillage d’adresses. Les textures sont référencées différemment par le pipeline de fonction programmable et le pipeline de fonction fixe :

  • Les nuanceurs programmables référencent les textures à l’aide du numéro de l’échantillonneur. Le nombre d’échantillonneurs disponibles pour un nuanceur programmable dépend de la version du nuanceur. Pour les nuanceurs de vertex, consultez Sampler (Direct3D 9 asm-vs). Pour les nuanceurs de pixels, consultez Sampler (Direct3D 9 asm-ps).
  • Le pipeline de fonction fixe, quant à lui, référence les textures par numéro d’étape de texture. Le nombre maximal d’échantillonneurs est déterminé à partir de deux majuscules : MaxSimultaneousTextures et MaxTextureBlendStages de la structure D3DCAPS9 .
Il existe deux autres cas spéciaux pour les nombres de phases/échantillonneurs.

[in] pTexture

Type : IDirect3DBaseTexture9*

Pointeur vers une interface IDirect3DBaseTexture9 , représentant la texture définie.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour peut être D3DERR_INVALIDCALL.

Remarques

SetTexture n’est pas autorisé si la texture est créée avec un type de pool de D3DPOOL_SCRATCH. SetTexture n’est pas autorisé avec un type de pool de D3DPOOL_SYSTEMMEM texture, sauf si DevCaps est défini avec D3DDEVCAPS_TEXTURESYSTEMMEMORY.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d9.h (inclure D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

GetTexture

GetTextureStageState

IDirect3DDevice9

SetTextureStageState