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

Artículo
02/28/2024

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.

Se usa un número especial denominado D3DDMAPSAMPLER para la asignación de desplazamiento (Direct3D 9).
Un sombreador de vértices programable usa un número especial definido por un D3DVERTEXTEXTURESAMPLER al acceder a texturas de vértices en vs_3_0 (DirectX HLSL).

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