glAddSwapHintRectWIN-Funktion
Die Rückruffunktion glAddSwapHintRectWIN gibt einen Satz von Rechtecken an, die von SwapBuffers kopiert werden sollen.
Syntax
void WINAPI glAddSwapHintRectWIN(
GLint x,
GLint y,
GLsizei width,
GLsizei height
);
Parameter
-
x
-
Die x-Koordinate (in Fensterkoordinaten) der unteren linken Ecke des Rechtecks des Hinweisbereichs.
-
y
-
Die y-Koordinate (in Fensterkoordinaten) der unteren linken Ecke des Rechtecks des Hinweisbereichs.
-
width
-
Die Breite des Rechtecks des Hinweisbereichs.
-
height
-
Die Höhe des Rechtecks des Hinweisbereichs.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Bemerkungen
Die Funktion glAddSwapHintRectWIN beschleunigt die Animation, indem sie den Umfang der Neulackierung zwischen Frames reduziert. Mit glAddSwapHintRectWIN geben Sie eine Reihe rechteckiger Bereiche an, die beim Aufrufen von SwapBuffers kopiert werden sollen. Wenn Sie vor dem Aufrufen von SwapBuffers keine Rechtecke mit glAddSwapHintRectWIN angeben, wird der gesamte Framebuffer ausgetauscht. Die Verwendung von glAddSwapHintRectWIN zum Kopieren nur geänderter Teile des Puffers kann die Leistung von SwapBuffers erheblich erhöhen, insbesondere wenn SwapBuffers in Software implementiert ist.
Die Funktion glAddSwapHintRectWIN fügt dem Hinweisbereich ein Rechteck hinzu. Wenn das PFD_SWAP_COPY Flag der PIXELFORMATDESCRIPTOR-Pixelformatstruktur festgelegt ist, verwendet SwapBuffers diese Region, um das Kopieren des Backpuffers in den Frontpuffer auszuschneiden. Sie geben keine PFD_SWAP_COPY an. sie wird von fähiger Hardware festgelegt. Der Hinweisbereich wird nach jedem Aufruf von SwapBuffers gelöscht. Bei einigen Hardwarekonfigurationen können SwapBuffers den Hinweisbereich ignorieren und den gesamten Puffer austauschen. SwapBuffers wird vom System implementiert, nicht von der Anwendung.
OpenGL verwaltet einen separaten Hinweisbereich für jedes Fenster. Wenn Sie glAddSwapHintRectWIN in allen Renderingkontexten aufrufen, die einem Fenster zugeordnet sind, werden die Hinweisrechtecke in einer einzelnen Region kombiniert.
Rufen Sie glAddSwapHintRectWIN mit einem umgebenden Rechteck für jedes Objekt auf, das für einen Frame gezeichnet wurde, und für jedes Rechteck, das zum Löschen vorheriger Frameobjekte gelöscht wurde.
Hinweis
Die glAddSwapHintRectWIN-Funktion ist eine Erweiterungsfunktion, die nicht Teil der OpenGL-Standardbibliothek ist, sondern Teil der GL_WIN_swap_hint-Erweiterung ist. Rufen Sie glGetString(GL_EXTENSIONS) auf, um zu überprüfen, ob Ihre Implementierung von OpenGL glAddSwapHintRectWIN unterstützt. Wenn GL_WIN_swap_hint zurückgegeben wird, wird glAddSwapHintRectWIN unterstützt. Um die Adresse einer Erweiterungsfunktion abzurufen, rufen Sie wglGetProcAddress auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|