Flutter Linux Embedder
fl_opengl_manager.h File Reference
#include <epoxy/egl.h>
#include <glib-object.h>

Go to the source code of this file.

Macros

#define EGL_NO_X11
 

Functions

G_BEGIN_DECLS G_DECLARE_FINAL_TYPE (FlOpenGLManager, fl_opengl_manager, FL, OPENGL_MANAGER, GObject) FlOpenGLManager *fl_opengl_manager_new()
 
gboolean fl_opengl_manager_make_current (FlOpenGLManager *manager)
 
gboolean fl_opengl_manager_make_resource_current (FlOpenGLManager *manager)
 
gboolean fl_opengl_manager_make_platform_current (FlOpenGLManager *manager)
 
gboolean fl_opengl_manager_clear_current (FlOpenGLManager *manager)
 
EGLDisplay fl_opengl_manager_get_display (FlOpenGLManager *manager)
 
EGLContext fl_opengl_manager_get_context (FlOpenGLManager *manager)
 
gboolean fl_opengl_manager_can_blit (FlOpenGLManager *manager)
 
gboolean fl_opengl_manager_can_fence (FlOpenGLManager *manager)
 
gboolean fl_opengl_manager_can_wait_sync (FlOpenGLManager *manager)
 

Macro Definition Documentation

◆ EGL_NO_X11

#define EGL_NO_X11

Definition at line 11 of file fl_opengl_manager.h.

Function Documentation

◆ fl_opengl_manager_can_blit()

gboolean fl_opengl_manager_can_blit ( FlOpenGLManager *  manager)

fl_opengl_manager_can_blit: @manager: an #FlOpenGLManager.

Checks whether glBlitFramebuffer can be used on the currently current OpenGL context. glBlitFramebuffer is a GLES3 / OpenGL 3.0 function that may be missing or broken on some drivers, so callers should fall back to shader compositing when this returns FALSE. Requires an OpenGL context to be current.

Returns: TRUE if glBlitFramebuffer is available.

Definition at line 155 of file fl_opengl_manager.cc.

155  {
156  g_return_val_if_fail(FL_IS_OPENGL_MANAGER(self), FALSE);
157 
158  // glBlitFramebuffer is a GLES3 / OpenGL 3.0 function and may not be present
159  // on older drivers, so treat it as optional. Evaluated for whichever OpenGL
160  // context is current.
161  return driver_supports_blit() &&
162  (epoxy_gl_version() >= 30 ||
163  epoxy_has_gl_extension("GL_EXT_framebuffer_blit"));
164 }
static gboolean driver_supports_blit()

References driver_supports_blit().

Referenced by fl_compositor_opengl_new(), and setup().

◆ fl_opengl_manager_can_fence()

gboolean fl_opengl_manager_can_fence ( FlOpenGLManager *  manager)

fl_opengl_manager_can_fence: @manager: an #FlOpenGLManager.

Checks whether fences can be used to synchronize rendering between OpenGL contexts. Fences are an extension that may be missing on some drivers, so callers should fall back to waiting for the rendering to complete, e.g. with glFinish(), when this returns FALSE.

Returns: TRUE if fences are available.

Definition at line 178 of file fl_opengl_manager.cc.

178  {
179  return has_extension(self, "EGL_KHR_fence_sync");
180 }
static gboolean has_extension(FlOpenGLManager *self, const gchar *extension)

References has_extension().

Referenced by fl_compositor_opengl_new().

◆ fl_opengl_manager_can_wait_sync()

gboolean fl_opengl_manager_can_wait_sync ( FlOpenGLManager *  manager)

fl_opengl_manager_can_wait_sync: @manager: an #FlOpenGLManager.

Checks whether a fence can be waited for by the GPU, i.e. without blocking the thread doing the waiting. This is an extension that may be missing on some drivers, so callers should fall back to blocking when this returns FALSE.

Returns: TRUE if fences can be waited for without blocking.

Definition at line 182 of file fl_opengl_manager.cc.

182  {
183  return has_extension(self, "EGL_KHR_wait_sync");
184 }

References has_extension().

Referenced by fl_gl_fence_new().

◆ fl_opengl_manager_clear_current()

gboolean fl_opengl_manager_clear_current ( FlOpenGLManager *  manager)

fl_opengl_manager_clear_current: @manager: an #FlOpenGLManager.

Clears the current rendering context.

Returns: TRUE if the context cleared.

Definition at line 116 of file fl_opengl_manager.cc.

116  {
117  return eglMakeCurrent(self->display, EGL_NO_SURFACE, EGL_NO_SURFACE,
118  EGL_NO_CONTEXT) == EGL_TRUE;
119 }

Referenced by fl_engine_gl_clear_current(), realize_cb(), and setup().

◆ fl_opengl_manager_get_context()

EGLContext fl_opengl_manager_get_context ( FlOpenGLManager *  manager)

fl_opengl_manager_get_context: @manager: an #FlOpenGLManager.

Gets the EGL context the engine renders with. This can be used as a share context when creating additional EGL contexts so they can access textures rendered by the engine directly (without using EGLImage).

Returns: an EGLContext.

Definition at line 125 of file fl_opengl_manager.cc.

125  {
126  return self->render_context;
127 }

Referenced by setup().

◆ fl_opengl_manager_get_display()

EGLDisplay fl_opengl_manager_get_display ( FlOpenGLManager *  manager)

fl_opengl_manager_get_display: @manager: an #FlOpenGLManager.

Gets the EGL display the engine renders to. This can be used to create additional EGL contexts that share resources with the engine.

Returns: an EGLDisplay.

Definition at line 121 of file fl_opengl_manager.cc.

121  {
122  return self->display;
123 }

Referenced by fl_gl_fence_new(), and get_display().

◆ fl_opengl_manager_make_current()

gboolean fl_opengl_manager_make_current ( FlOpenGLManager *  manager)

fl_opengl_manager_make_current: @manager: an #FlOpenGLManager.

Makes the rendering context current.

Returns: TRUE if the context made current.

Definition at line 101 of file fl_opengl_manager.cc.

101  {
102  return eglMakeCurrent(self->display, EGL_NO_SURFACE, EGL_NO_SURFACE,
103  self->render_context) == EGL_TRUE;
104 }

Referenced by collect_opengl_backing_store(), create_opengl_backing_store(), fl_compositor_opengl_new(), fl_engine_gl_make_current(), and fl_subsurface_egl_present().

◆ fl_opengl_manager_make_platform_current()

gboolean fl_opengl_manager_make_platform_current ( FlOpenGLManager *  manager)

fl_opengl_manager_make_platform_current: @manager: an #FlOpenGLManager.

Makes the platform rendering context current.

Returns: TRUE if the context made current.

Definition at line 111 of file fl_opengl_manager.cc.

111  {
112  return eglMakeCurrent(self->display, EGL_NO_SURFACE, EGL_NO_SURFACE,
113  self->platform_context) == EGL_TRUE;
114 }

Referenced by fl_compositor_opengl_shader_dispose(), and setup_shader().

◆ fl_opengl_manager_make_resource_current()

gboolean fl_opengl_manager_make_resource_current ( FlOpenGLManager *  manager)

fl_opengl_manager_make_resource_current: @manager: an #FlOpenGLManager.

Makes the resource rendering context current.

Returns: TRUE if the context made current.

Definition at line 106 of file fl_opengl_manager.cc.

106  {
107  return eglMakeCurrent(self->display, EGL_NO_SURFACE, EGL_NO_SURFACE,
108  self->resource_context) == EGL_TRUE;
109 }

Referenced by fl_engine_gl_make_resource_current().

◆ G_DECLARE_FINAL_TYPE()

G_BEGIN_DECLS G_DECLARE_FINAL_TYPE ( FlOpenGLManager  ,
fl_opengl_manager  ,
FL  ,
OPENGL_MANAGER  ,
GObject   
)

fl_opengl_manager_new:

Creates an object that allows Flutter to render by OpenGL ES.

Returns: a new #FlOpenGLManager.