funzione glAddSwapHintRectWIN

La funzione di callback glAddSwapHintRectWIN specifica un set di rettangoli da copiare da SwapBuffers.

Sintassi

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

Parametri

x

Coordinata x (nelle coordinate della finestra) dell'angolo inferiore sinistro del rettangolo dell'area di hint.

y

Coordinata y (nelle coordinate della finestra) dell'angolo inferiore sinistro del rettangolo dell'area di hint.

width

Larghezza del rettangolo dell'area hint.

height

Altezza del rettangolo dell'area di hint.

Valore restituito

Questa funzione non restituisce un valore.

Commenti

La funzione glAddSwapHintRectWIN accelera l'animazione riducendo la quantità di repainting tra fotogrammi. Con glAddSwapHintRectWIN, specificare un set di aree rettangolari che si desidera copiare quando si chiama SwapBuffers. Quando non si specificano rettangoli con glAddSwapHintRectWIN prima di chiamare SwapBuffers, l'intero framebuffer viene scambiato. L'uso di glAddSwapHintRectWIN per copiare solo le parti modificate del buffer può aumentare significativamente le prestazioni di SwapBuffers, soprattutto quando SwapBuffers viene implementato nel software.

La funzione glAddSwapHintRectWIN aggiunge un rettangolo all'area hint. Quando viene impostato il flag PFD_SWAP_COPY della struttura di formato pixel PIXELFORMATDESCRIPTOR , SwapBuffers usa questa area per ritagliare la copia del buffer indietro nel buffer anteriore. Non si specifica PFD_SWAP_COPY; è impostato dall'hardware in grado. L'area hint viene cancellata dopo ogni chiamata a SwapBuffers. Con alcune configurazioni hardware, SwapBuffers può ignorare l'area di hint e scambiare l'intero buffer. SwapBuffers viene implementato dal sistema, non dall'applicazione.

OpenGL gestisce un'area di hint separata per ogni finestra. Quando si chiama glAddSwapHintRectWIN in qualsiasi contesto di rendering associato a una finestra, i rettangoli hint vengono combinati in una singola area.

Chiamare glAddSwapHintRectWIN con un rettangolo di selezione per ogni oggetto disegnato per un frame e per ogni rettangolo cancellato per cancellare gli oggetti frame precedenti.

Nota

La funzione glAddSwapHintRectWIN è una funzione di estensione che non fa parte della libreria OpenGL standard, ma fa parte dell'estensione GL_WIN_swap_hint. Per verificare se l'implementazione di OpenGL supporta glAddSwapHintRectWIN, chiamare glGetString(GL_EXTENSIONS). Se restituisce GL_WIN_swap_hint, glAddSwapHintRectWIN è supportato. Per ottenere l'indirizzo di una funzione di estensione, chiamare wglGetProcAddress.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Gl.h

Vedi anche

glGetString

PIXELFORMATDESCRIPTOR

SwapBuffers

wglGetProcAddress