Método IDirect3DDevice9::SetTexture (d3d9helper.h)

Artigo
02/28/2024

Atribui uma textura a um estágio para um dispositivo.

Sintaxe

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

Parâmetros

[in] Stage

Tipo: DWORD

Número do sampler baseado em zero. As texturas são associadas a amostras; Os samplers definem o estado de amostragem, como o modo de filtragem e o modo de encapsulamento de endereço. As texturas são referenciadas de forma diferente pelo pipeline de função programável e fixa:

Sombreadores programáveis fazem referência a texturas usando o número do sampler. O número de amostras disponíveis para um sombreador programável depende da versão do sombreador. Para sombreadores de vértice, consulte Sampler (Direct3D 9 asm-vs). Para sombreadores de pixel, consulte Sampler (Direct3D 9 asm-ps).
O pipeline de função fixa, por outro lado, faz referência a texturas por número de estágio de textura. O número máximo de samplers é determinado a partir de duas tampas: MaxSimultaneousTextures e MaxTextureBlendStages da estrutura D3DCAPS9 .

Há dois outros casos especiais para números de estágio/amostra.

Um número especial chamado D3DDMAPSAMPLER é usado para Mapeamento de Deslocamento (Direct3D 9).
Um sombreador de vértice programável usa um número especial definido por um D3DVERTEXTEXTURESAMPLER ao acessar texturas de vértice em vs_3_0 (DirectX HLSL).

[in] pTexture

Tipo: IDirect3DBaseTexture9*

Ponteiro para uma interface IDirect3DBaseTexture9 , representando a textura que está sendo definida.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser D3DERR_INVALIDCALL.

Comentários

SetTexture não será permitido se a textura for criada com um tipo de pool de D3DPOOL_SCRATCH. SetTexture não é permitido com um tipo de pool de D3DPOOL_SYSTEMMEM textura, a menos que DevCaps esteja definido com D3DDEVCAPS_TEXTURESYSTEMMEMORY.