Función wglRealizeLayerPalette (wingdi.h)

Artículo
03/08/2023

La función wglRealizeLayerPalette asigna entradas de paleta de un plano de capa de índice de color determinado a la paleta física o inicializa la paleta de un plano de capa RGBA.

Sintaxis

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

Parámetros

unnamedParam1

Especifica el contexto del dispositivo de una ventana cuya paleta de plano de capa se va a realizar en la paleta física.

unnamedParam2

Especifica la superposición o el plano de superposición. Los valores positivos de iLayerPlane identifican los planos de superposición, donde 1 es el primer plano de superposición sobre el plano principal, 2 es el segundo plano superpuesto sobre el primer plano de superposición, etc. Los valores negativos identifican planos de superposición, donde 1 es el primer plano subyacente bajo el plano principal, 2 es el segundo plano subyacente bajo el primer plano de superposición, etc. El número de planos superpuestos y de subposición se proporciona en el miembro bReserved de la estructura PIXELFORMATDESCRIPTOR .

unnamedParam3

Indica si la paleta se va a realizar en la paleta física. Cuando bRealize es TRUE, las entradas de la paleta se asignan a la paleta física cuando está disponible. Cuando bRealize es FALSE, las entradas de paleta para el plano de capa de la ventana ya no son necesarias y pueden liberarse para su uso por otra ventana en primer plano.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es TRUE, incluso si bRealize es TRUE y la paleta física no está disponible. Si se produce un error en la función o cuando no se selecciona ningún formato de píxel, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La paleta física de un plano de capa es un recurso compartido entre ventanas con planos de capa. Cuando más de una ventana intenta realizar una paleta para un plano de capa física determinado, solo se realiza una paleta a la vez. Cuando se llama a la función wglRealizeLayerPalette , la paleta de capas de una ventana en primer plano siempre se realiza primero.

Cuando se realiza la paleta de capas de una ventana, sus entradas de paleta siempre se asignan uno a uno en la paleta física. A diferencia de las paletas lógicas de GDI, con wglRealizeLayerPalette no hay ninguna asignación de las paletas de capas de otras ventanas a la paleta física actual.

Cada vez que una ventana se convierte en la ventana de primer plano, llame a wglRealizeLayerPalette para volver a realizar sus paletas de capas, incluso si el tipo de píxel del plano de capa es RGBA.

Dado que wglRealizeLayerPalette no se da cuenta de la paleta del plano principal, use las funciones de paleta de GDI para realizar la paleta del plano principal.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h
Library	Opengl32.lib
Archivo DLL	Opengl32.dll