función glAddSwapHintRectWIN

La función de devolución de llamada glAddSwapHintRectWIN especifica un conjunto de rectángulos que se van a copiar mediante SwapBuffers.

Sintaxis

void WINAPI glAddSwapHintRectWIN(
   GLint   x,
   GLint   y,
   GLsizei width,
   GLsizei height
);

Parámetros

x

Coordenada x (en coordenadas de ventana) de la esquina inferior izquierda del rectángulo de la región de sugerencia.

y

Coordenada y (en coordenadas de ventana) de la esquina inferior izquierda del rectángulo de la región de sugerencia.

width

Ancho del rectángulo de la región de sugerencia.

height

Alto del rectángulo de la región de sugerencia.

Valor devuelto

Esta función no devuelve ningún valor.

Observaciones

La función glAddSwapHintRectWIN acelera la animación reduciendo la cantidad de reintentos entre fotogramas. Con glAddSwapHintRectWIN, especifique un conjunto de áreas rectangulares que desee copiar al llamar a SwapBuffers. Cuando no se especifican rectángulos con glAddSwapHintRectWIN antes de llamar a SwapBuffers, se intercambia todo el framebuffer. El uso de glAddSwapHintRectWIN para copiar solo partes modificadas del búfer puede aumentar significativamente el rendimiento de SwapBuffers, especialmente cuando SwapBuffers se implementa en software.

La función glAddSwapHintRectWIN agrega un rectángulo a la región de sugerencias. Cuando se establece la marca PFD_SWAP_COPY de la estructura de formato de píxel PIXELFORMATDESCRIPTOR , SwapBuffers usa esta región para recortar la copia del búfer de reserva en el búfer frontal. No se especifican PFD_SWAP_COPY; se establece mediante hardware compatible. La región de sugerencias se borra después de cada llamada a SwapBuffers. Con algunas configuraciones de hardware, SwapBuffers puede omitir la región de sugerencias e intercambiar todo el búfer. SwapBuffers lo implementa el sistema, no mediante la aplicación.

OpenGL mantiene una región de sugerencia independiente para cada ventana. Cuando se llama a glAddSwapHintRectWIN en cualquier contexto de representación asociado a una ventana, los rectángulos de sugerencias se combinan en una sola región.

Llame a glAddSwapHintRectWIN con un rectángulo delimitador para cada objeto dibujado para un marco y para cada rectángulo borrado para borrar objetos de marco anteriores.

Nota

La función glAddSwapHintRectWIN es una función de extensión que no forma parte de la biblioteca openGL estándar, sino que forma parte de la extensión GL_WIN_swap_hint. Para comprobar si la implementación de OpenGL admite glAddSwapHintRectWIN, llame a glGetString(GL_EXTENSIONS). Si devuelve GL_WIN_swap_hint, se admite glAddSwapHintRectWIN . Para obtener la dirección de una función de extensión, llame a wglGetProcAddress.

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]
Encabezado	Gl.h

Vea también

glGetString

PIXELFORMATDESCRIPTOR

SwapBuffers

wglGetProcAddress