Método IDirectDraw7::CreatePalette (ddraw.h)
Cria um objeto DirectDrawPalette para este objeto DirectDraw.
Sintaxe
HRESULT CreatePalette(
[in] DWORD unnamedParam1,
[in] LPPALETTEENTRY unnamedParam2,
[out] LPDIRECTDRAWPALETTE *unnamedParam3,
[in] IUnknown *unnamedParam4
);
Parâmetros
[in] unnamedParam1
Esse valor consiste em um ou mais dos seguintes sinalizadores:
DDPCAPS_1BIT
O índice é de 1 bit. Há duas entradas na tabela de cores.
DDPCAPS_2BIT
O índice é de 2 bits. Há quatro entradas na tabela de cores.
DDPCAPS_4BIT
O índice é de 4 bits. Há 16 entradas na tabela de cores.
DDPCAPS_8BIT
O índice é de 8 bits. Há 256 entradas na tabela de cores.
DDPCAPS_8BITENTRIES
O índice refere-se a um índice de cores de 8 bits. Esse sinalizador só é válido quando usado com o sinalizador DDPCAPS_1BIT, DDPCAPS_2BIT ou DDPCAPS_4BIT e quando a superfície de destino é de 8 bpp. Cada entrada de cor tem 1 byte de comprimento e é um índice para a paleta de 8 bpp de uma superfície de destino.
DDPCAPS_ALPHA
O membro peFlags da estrutura PALETTEENTRY associada deve ser interpretado como um único valor alfa de 8 bits (além dos membros peRed, peGreen e peBlue ). Uma paleta criada usando esse sinalizador só pode ser anexada a uma textura: uma superfície criada com o sinalizador de funcionalidade DDSCAPS_TEXTURE.
DDPCAPS_ALLOW256
Essa paleta pode ter todas as 256 entradas definidas.
DDPCAPS_INITIALIZE
Obsoleto. O DirectDraw sempre inicializa essa paleta com as cores na matriz de cores passadas em lpDDColorArray.
DDPCAPS_PRIMARYSURFACE
Essa paleta está anexada à superfície primária. Alterar a tabela de cores dessa paleta afeta imediatamente a exibição, a menos que DDPSETPAL_VSYNC seja especificada e com suporte.
DDPCAPS_PRIMARYSURFACELEFT
Essa paleta é aquela anexada à superfície primária do olho esquerdo. Alterar a tabela de cores dessa paleta afeta imediatamente a exibição do olho esquerdo, a menos que DDPSETPAL_VSYNC seja especificada e com suporte.
DDPCAPS_VSYNC
Essa paleta pode ter modificações sincronizadas com a taxa de atualização do monitor.
[in] unnamedParam2
Endereço de uma matriz de 2, 4, 16 ou 256 estruturas PALETTEENTRY para inicializar o objeto DirectDrawPalette.
[out] unnamedParam3
Endereço de uma variável a ser definida como um ponteiro de interface IDirectDrawPalette válido se a chamada for bem-sucedida.
[in] unnamedParam4
Permite compatibilidade futura com recursos de agregação COM. Atualmente, esse método retornará um erro se esse parâmetro não for NULL.
Retornar valor
Se o método for bem-sucedido, o valor retornado será DD_OK.
Se falhar, o método poderá retornar um dos seguintes valores de erro:
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_NOCOOPERATIVELEVELSET
- DDERR_OUTOFMEMORY
- DDERR_UNSUPPORTED
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | ddraw.h |
| Biblioteca | Ddraw.lib |
| DLL | Ddraw.dll |