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

Article
02/29/2024

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.

Un numéro spécial appelé D3DDMAPSAMPLER est utilisé pour le mappage des déplacements (Direct3D 9).
Un nuanceur de vertex programmable utilise un nombre spécial défini par un D3DVERTEXTEXTURESAMPLER lors de l’accès aux textures de vertex dans vs_3_0 (DirectX HLSL).

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