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

Artículo
08/23/2023

Establece entradas de paleta.

Sintaxis

HRESULT SetPaletteEntries(
  [in] UINT               PaletteNumber,
  [in] const PALETTEENTRY *pEntries
);

Parámetros

[in] PaletteNumber

Tipo: UINT

Valor ordinal que identifica la paleta determinada en la que se va a realizar la operación.

[in] pEntries

Tipo: const PALETTEENTRY*

Puntero a una estructura PALETTEENTRY , que representa las entradas de paleta que se van a establecer. Se supone que el número de estructuras PALETTEENTRY a las que apunta pEntries es 256. Vea la sección Comentarios.

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

En el caso de las aplicaciones de Direct3D 9, cualquier paleta enviada a este método debe ajustarse al bit de funcionalidad D3DPTEXTURECAPS_ALPHAPALETTE de la estructura D3DCAPS9 . Si no se establece D3DPTEXTURECAPS_ALPHAPALETTE, todas las entradas de la paleta deben tener alfa establecida en 1.0 o este método producirá un error con D3DERR_INVALIDCALL. Si se establece D3DPTEXTURECAPS_ALPHAPALETTE, se permite cualquier conjunto de valores alfa. Tenga en cuenta que el tiempo de ejecución de depuración imprimirá un mensaje de advertencia si todas las entradas de paleta tienen alfa establecida en 0.

Una sola paleta lógica está asociada al dispositivo y la comparten todas las fases de textura.