mirrors/arsd
1
0
Fork 0
mirror of https://github.com/adamdruppe/arsd.git synced 2025-04-26 13:20:05 +03:00
Code Issues Projects Releases Packages Wiki Activity Actions

note about buffer swapping

Browse source
This commit is contained in:
Adam D. Ruppe 2024-10-05 10:45:17 -04:00
parent 4947ea9efd
commit eaf60b4101
1 changed files with 10 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

13
simpledisplay.d
View file

@ -3272,11 +3272,18 @@ class SimpleWindow : CapableOfHandlingNativeEvent, CapableOfBeingDrawnUpon {
/++
simpledisplay always uses double buffering, usually automatically. This
manually swaps the OpenGL buffers.
manually swaps the OpenGL buffers. You should only use this if you are NOT
using the [redrawOpenGlScene] delegate.
You should not need to call this yourself because simpledisplay will do it
for you after calling your `redrawOpenGlScene`.
You must not this yourself if you use [redrawOpenGlScene] because simpledisplay will do it
for you after calling your `redrawOpenGlScene`. Please note that once you swap
buffers, the contents become undefined - the implementation, in the OpenGL driver
or the desktop compositor, may not actually just swap two buffers. The back buffer's
contents are $(B undefined) after calling this function.
See: https://learn.microsoft.com/en-us/windows/win32/api/wingdi/nf-wingdi-swapbuffers
and https://linux.die.net/man/3/glxswapbuffers
Remember that this may throw an exception, which you can catch in a multithreaded
application to keep your thread from dying from an unhandled exception.