Função wglRealizeLayerPalette (wingdi.h)

Artigo
08/27/2023

A função wglRealizeLayerPalette mapeia entradas de paleta de um determinado plano de camada de índice de cores para a paleta física ou inicializa a paleta de um plano de camada RGBA.

Sintaxe

BOOL wglRealizeLayerPalette(
  HDC  unnamedParam1,
  int  unnamedParam2,
  BOOL unnamedParam3
);

Parâmetros

unnamedParam1

Especifica o contexto do dispositivo de uma janela cuja paleta de planos de camada deve ser realizada na paleta física.

unnamedParam2

Especifica a sobreposição ou o plano de sobreposição. Os valores positivos de iLayerPlane identificam planos de sobreposição, em que 1 é o primeiro plano de sobreposição sobre o plano main, 2 é o segundo plano de sobreposição sobre o primeiro plano de sobreposição e assim por diante. Valores negativos identificam planos de subposição, em que 1 é o primeiro plano de base sob o plano main, 2 é o segundo plano de sobreposição sob o primeiro plano de sobreposição e assim por diante. O número de planos de sobreposição e de subposição é fornecido no membro bReserved da estrutura PIXELFORMATDESCRIPTOR .

unnamedParam3

Indica se a paleta deve ser realizada na paleta física. Quando bRealize é TRUE, as entradas de paleta são mapeadas para a paleta física quando disponíveis. Quando bRealize é FALSE, as entradas de paleta para o plano de camada da janela não são mais necessárias e podem ser liberadas para uso por outra janela em primeiro plano.

Retornar valor

Se a função for bem-sucedida, o valor retornado será TRUE, mesmo que bRealize seja TRUE e a paleta física não esteja disponível. Se a função falhar ou quando nenhum formato de pixel for selecionado, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A paleta física de um plano de camada é um recurso compartilhado entre janelas com planos de camada. Quando mais de uma janela tenta realizar uma paleta para um determinado plano de camada física, apenas uma paleta de cada vez é realizada. Quando você chama a função wglRealizeLayerPalette , a paleta de camadas de uma janela em primeiro plano é sempre realizada primeiro.

Quando a paleta de camadas de uma janela é realizada, suas entradas de paleta são sempre mapeadas um para um na paleta física. Ao contrário das paletas lógicas GDI, com wglRealizeLayerPalette não há mapeamento das paletas de camadas de outras janelas para a paleta física atual.

Sempre que uma janela se tornar a janela em primeiro plano, chame wglRealizeLayerPalette para perceber suas paletas de camadas novamente, mesmo que o tipo de pixel do plano de camada seja RGBA.

Como wglRealizeLayerPalette não percebe a paleta do plano main, use funções de paleta GDI para perceber a paleta do plano main.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h
Biblioteca	Opengl32.lib
DLL	Opengl32.dll