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

Artículo
02/29/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 muestrador de base cero. Las texturas están enlazadas a los muestreadores; Los muestradores definen el estado de muestreo, como el modo de filtrado y el modo de ajuste de direcciones. La canalización de funciones fijas hace referencia a las texturas de forma diferente:

Los sombreadores programables hacen referencia a texturas mediante el número de muestra. El número de muestras disponibles para un sombreador programable depende de la versión del sombreador. Para sombreadores de vértices, consulta Sampler (Direct3D 9 asm-vs). Para sombreadores de píxeles, consulta 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 los números de fase y 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értice 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 ejecuta 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 se establezca con D3DDEVCAPS_TEXTURESYSTEMMEMORY.