Función wglCreateLayerContext (wingdi.h)

Artículo
08/27/2023

La función wglCreateLayerContext crea un nuevo contexto de representación de OpenGL para dibujar en un plano de capa especificado en un contexto de dispositivo.

Sintaxis

HGLRC wglCreateLayerContext(
  HDC unnamedParam1,
  int unnamedParam2
);

Parámetros

unnamedParam1

Especifica el contexto del dispositivo para un nuevo contexto de representación.

unnamedParam2

Especifica el plano de capa al que desea enlazar un contexto de representación. El valor 0 identifica el plano principal. 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 de superposición sobre el primer plano de superposición, etc. Los valores negativos identifican planos subyacentes, donde 1 es el primer plano subyacente bajo el plano principal, 2 es el segundo plano subyacente bajo el primer plano subyacente, etc. El número de planos superpuestos y subyacentes se proporciona en el miembro bReserved de la estructura PIXELFORMATDESCRIPTOR .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador de un contexto de representación de OpenGL.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Un contexto de representación es un puerto a través del cual se pasan todos los comandos de OpenGL. Cada subproceso que realiza llamadas a OpenGL debe tener un contexto de representación activo actual. Un contexto de representación no es el mismo que un contexto de dispositivo; un contexto de representación contiene información específica de OpenGL, mientras que un contexto de dispositivo contiene información específica de GDI.

Antes de crear un contexto de representación, establezca el formato de píxel del contexto del dispositivo con la función SetPixelFormat . Puede usar un contexto de representación en un plano de capa especificado de una ventana solo con formatos de píxeles idénticos.

Con las aplicaciones de OpenGL que usan varios subprocesos, se crea un contexto de representación, se selecciona como el contexto de representación actual de un subproceso y se realizan llamadas OpenGL para el subproceso especificado. Cuando haya terminado con el contexto de representación del subproceso, llame a la función wglDeleteContext .

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar wglCreateLayerContext.

// The following code fragment shows how to render to overlay 1  
// This example assumes that the pixel format of hdc includes   
// overlay plane 1  
 
HDC hdc; 
HGLRC; 
 
// create a rendering context for overlay plane 1  
hglrc = wglCreateLayerContext(hdc, 1); 
 
// make it the calling thread's current rendering context  
wglMakeCurrent(hdc, hglrc); 
 
// call OpenGL functions here. . .  
 
// when the rendering context is no longer needed. . .  
 
// make the rendering context not current  
wglMakeCurrent(NULL, NULL); 
 
// delete the rendering context  
wglDeleteContext(hglrc);

Requisitos


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