Compartir a través de


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

Asigna una textura a una fase de un dispositivo.

Sintaxis

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

Parámetros

[in] Stage

Tipo: DWORD

Número de muestreador basado en cero. Las texturas se enlazan a los muestreadores; Los muestreadores definen el estado de muestreo, como el modo de filtrado y el modo de ajuste de direcciones. Las texturas se hacen referencia de forma diferente mediante la canalización de función programable y fija:

  • Los sombreadores programables hacen referencia a texturas mediante el número de muestreador. El número de muestreadores disponibles para un sombreador programable depende de la versión del sombreador. Para sombreadores de vértices, consulte Sampler (Direct3D 9 asm-vs). Para los sombreadores de píxeles, vea Sampler (Direct3D 9 asm-ps).
  • Por otro lado, la canalización de función fija hace referencia a texturas por número de fase de textura. El número máximo de muestreadores se determina a partir de dos mayúsculas: MaxSimultaneousTextures y MaxTextureBlendStages de la estructura D3DCAPS9 .
Hay otros dos casos especiales para números de fase o muestreo.

[in] pTexture

Tipo: IDirect3DBaseTexture9*

Puntero a una interfaz IDirect3DBaseTexture9 , que representa la textura que se establece.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto se puede D3DERR_INVALIDCALL.

Comentarios

No se permite SetTexture si la textura se crea con un tipo de grupo de D3DPOOL_SCRATCH. SetTexture no se permite con un tipo de grupo de D3DPOOL_SYSTEMMEM textura a menos que DevCaps esté establecido con D3DDEVCAPS_TEXTURESYSTEMMEMORY.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado d3d9helper.h (incluya D3D9.h)
Library D3D9.lib

Consulte también

GetTexture

GetTextureStageState

IDirect3DDevice9

SetTextureStageState