Compartilhar via


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

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.

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

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d9helper.h (inclua D3D9.h)
Biblioteca D3D9.lib

Confira também

GetTexture

GetTextureStageState

IDirect3DDevice9

Settexturestagestate