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

Artigo
08/23/2023

Define entradas de paleta.

Sintaxe

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

Parâmetros

[in] PaletteNumber

Tipo: UINT

Um valor ordinal que identifica a paleta específica na qual a operação deve ser executada.

[in] pEntries

Tipo: const PALETTEENTRY*

Ponteiro para uma estrutura PALETTEENTRY , representando as entradas de paleta a serem definidas. O número de estruturas PALETTEENTRY apontadas por pEntries é considerado 256. Consulte Observações.

Valor retornado

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

Para aplicativos Direct3D 9, qualquer paleta enviada a esse método deve estar em conformidade com o bit de funcionalidade D3DPTEXTURECAPS_ALPHAPALETTE da estrutura D3DCAPS9 . Se D3DPTEXTURECAPS_ALPHAPALETTE não estiver definido, cada entrada na paleta deverá ter alfa definido como 1.0 ou esse método falhará com D3DERR_INVALIDCALL. Se D3DPTEXTURECAPS_ALPHAPALETTE for definido, qualquer conjunto de valores alfa será permitido. Observe que o runtime de depuração imprimirá uma mensagem de aviso se todas as entradas de paleta tiverem alfa definido como 0.

Uma única paleta lógica está associada ao dispositivo e é compartilhada por todos os estágios de textura.