diff options
| author | ManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com> | 2023-07-08 09:23:38 +0200 |
|---|---|---|
| committer | ManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com> | 2023-07-08 09:23:38 +0200 |
| commit | 18befa5e818b7399c1443b6533f1638a2d2eccf9 (patch) | |
| tree | 23cc834ebf9193317e6e13f0d92f4cf640272fc3 /documentation/src | |
| parent | 3d03a5426b649f7c78c2c3dde3e6149e573f9d99 (diff) | |
Add details to documentation of Fl_Wayland_Gl_Window_Driver::swap_buffers()
Diffstat (limited to 'documentation/src')
| -rw-r--r-- | documentation/src/wayland.dox | 12 |
1 files changed, 9 insertions, 3 deletions
diff --git a/documentation/src/wayland.dox b/documentation/src/wayland.dox index 87285319a..c873c17fd 100644 --- a/documentation/src/wayland.dox +++ b/documentation/src/wayland.dox @@ -1052,12 +1052,12 @@ and puts in the returned \c Fl_Gl_Choice object the first matching configuration The filtering gets done with bits \c EGL_WINDOW_BIT, to support the creation of window surfaces, and \c EGL_OPENGL_BIT, to support the creation of OpenGL contexts. -EGL needs 2 more objects created for each \c Fl_Gl_Window of type -<tt>struct wl_egl_window</tt> and \c EGLSurface. Both are created by member +EGL needs 2 more objects created for each \c Fl_Gl_Window. They have types +<tt>struct wl_egl_window</tt> and \c EGLSurface, and are created by member function \c Fl_Wayland_Gl_Window_Driver::make_current_before() which runs at the beginning of \c Fl_Gl_Window::make_current(). The first argument of the call to \c wl_egl_window_create() therein has type -<tt>struct wl_surface *</tt> and is what connects EGL with the desired Wayland window. +<tt>struct wl_surface *</tt> and is what connects EGL with the targetted Wayland window. EGL creates with \c eglCreateContext() an object of type \c EGLContext via member function \c Fl_Wayland_Gl_Window_Driver::create_gl_context() called by @@ -1078,6 +1078,12 @@ emulate an overlay buffer to support Fl_Gl_Window objects overriding their Then, it calls function \c eglSwapBuffers() after having called \c wl_display_dispatch_pending() to synchronize EGL use with the rest of the Wayland compositor's activity. +Function \c wl_display_dispatch_pending() calls the listeners attached to +commands the Wayland compositor recently sent to the client. +The fact that this function gets called during the process of drawing an Fl_Gl_Window +makes possible a scenario that cannot occur with other FLTK platforms : a GL window can be +closed while being drawn. Function \c Fl_Wayland_Window_Driver::hide() is written to +handle such scenario without error (see comments therein). The overridden \c Fl_Wayland_Gl_Window_Driver::resize() function is implemented with calls to \c wl_egl_window_get_attached_size() and \c wl_egl_window_resize(). |