Método IDirect3DDevice9::SetTexture (d3d9.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. Texturas são associadas a amostradores; Os samplers definem o estado de amostragem, como o modo de filtragem e o modo de disposição de endereço. As texturas são referenciadas de forma diferente pelo pipeline de função programável e fixa:

• Sombreadores programáveis referenciam texturas usando o número do sampler. O número de exemplos 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 .

• 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 seja definido com D3DDEVCAPS_TEXTURESYSTEMMEMORY.

Requisitos

Confira também

GetTexture

GetTextureStageState

IDirect3DDevice9

Settexturestagestate