sungmg/mutter-performance-source
1
0
Fork 0
Code Activity
mutter-performance-source/src/backends/meta-egl.h

263 lines
13 KiB
C
Raw Normal View History

Add EGL abstraction class MetaEgl Add a MetaEgl meant to deal with EGL. It is intended to be use by EGL based renderers and handle extension symbols loading, handle errors etc. https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-08-18 02:18:28 +00:00
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
/*
* Copyright (C) 2016 Red Hat Inc.
egl: Introduce meta_egl_create_dmabuf_image This bit of code was more or less duplicated in meta-renderer-native-gles3.c and meta-wayland-dma-buf.c. Start consolidating the two implementations by moving the *-gles3.c function into meta-egl.c and generalizing it so it could also accommodate the meta-wayland-dma-buf.c usage. The workaround in the *-gles3.c implementation is moved to the caller. It is the caller's responsibility to check for the existence of the appropriate EGL extensions. Commit 6f59e4858e24c828e3ab0e611d36dfaaded1b272 worked around the lack of EGL_EXT_image_dma_buf_import_modifiers with the assumption that if the modifier is linear, there is no need to pass it into EGL. The problem is that not passing a modifier explicitly to EGL invokes implementation-defined behaviour, so we should not have that workaround in meta-egl.c. This patch intends to be pure refactoring, no behavioral changes. The one change is the addition of g_assert to catch overwriting arbitrary memory. https://gitlab.gnome.org/GNOME/mutter/merge_requests/615
2019-06-10 14:07:55 +00:00
* Copyright (C) 2019 DisplayLink (UK) Ltd.
Add EGL abstraction class MetaEgl Add a MetaEgl meant to deal with EGL. It is intended to be use by EGL based renderers and handle extension symbols loading, handle errors etc. https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-08-18 02:18:28 +00:00
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation; either version 2 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
* 02111-1307, USA.
*
* Written by:
* Jonas Ådahl <jadahl@gmail.com>
*/
#ifndef META_EGL_H
#define META_EGL_H
#include <EGL/egl.h>
MetaEgl: Add EGL extensions support Add proc symbol loading and helper functions for calling them, dealing with errors etc. So far no extension symbols are loaded, only the infrastructure is there. https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-08-18 03:05:20 +00:00
#include <EGL/eglext.h>
Add EGL abstraction class MetaEgl Add a MetaEgl meant to deal with EGL. It is intended to be use by EGL based renderers and handle extension symbols loading, handle errors etc. https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-08-18 02:18:28 +00:00
#include <glib-object.h>
egl: Pass EGL errors via custom error domain Introduce META_EGL_ERROR and have the error code be EGL error codes. https://bugzilla.gnome.org/show_bug.cgi?id=779112
2017-02-16 09:20:43 +00:00
#define META_EGL_ERROR meta_egl_error_quark ()
Add EGL abstraction class MetaEgl Add a MetaEgl meant to deal with EGL. It is intended to be use by EGL based renderers and handle extension symbols loading, handle errors etc. https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-08-18 02:18:28 +00:00
#define META_TYPE_EGL (meta_egl_get_type ())
G_DECLARE_FINAL_TYPE (MetaEgl, meta_egl, META, EGL, GObject)
egl: Pass EGL errors via custom error domain Introduce META_EGL_ERROR and have the error code be EGL error codes. https://bugzilla.gnome.org/show_bug.cgi?id=779112
2017-02-16 09:20:43 +00:00
GQuark meta_egl_error_quark (void);
egl: Expose .._has_extensions_..() function It will be used by e.g. a future GLES helper unit needing similar functionality. https://bugzilla.gnome.org/show_bug.cgi?id=785381
2017-07-24 07:56:59 +00:00
gboolean
Fix const qualifier usage As with the commits earlier, this also adds const qualifiers where expected. However, the const variables are casted to non-const variants so they can be passed to glib functions that take non-const variants but expect const-like input.
2019-01-20 10:46:46 +00:00
meta_extensions_string_has_extensions_valist (const char *extensions_str,
const char ***missing_extensions,
const char *first_extension,
va_list var_args);
gboolean meta_egl_has_extensions (MetaEgl *egl,
EGLDisplay display,
const char ***missing_extensions,
const char *first_extension,
MetaEgl: Add EGL extensions support Add proc symbol loading and helper functions for calling them, dealing with errors etc. So far no extension symbols are loaded, only the infrastructure is there. https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-08-18 03:05:20 +00:00
...);
egl: Add eglInitialize helper https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-09-29 14:26:24 +00:00
gboolean meta_egl_initialize (MetaEgl *egl,
EGLDisplay display,
GError **error);
egl: Expose eglGetProcAddress It will be needed for OpenGL ES extension function symbol loading. https://bugzilla.gnome.org/show_bug.cgi?id=785381
2017-07-24 09:15:21 +00:00
gpointer meta_egl_get_proc_address (MetaEgl *egl,
const char *procname,
GError **error);
egl: Rename EGL simple config chooser It just picked the first config, so name it accordingly. https://gitlab.gnome.org/GNOME/mutter/issues/2
2018-02-23 14:13:11 +00:00
gboolean meta_egl_choose_first_config (MetaEgl *egl,
EGLDisplay display,
const EGLint *attrib_list,
EGLConfig *chosen_config,
GError **error);
MetaRendererNative: Use pbuffer surface as dummy surface Lets use a pbuffer surface as a dummy surface instead of a gbm based one, so that we don't need to rely on the availability of gbm to create a dummy surface when there is no need for it. https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-08-31 03:25:45 +00:00
renderer/native: Force EGL config pixel format We just arbitrarily chose the first EGL config matching the passed attributes, but we then assumed we always got GBM_FORMAT_XRGB8888. That was not a correct assumption. Instead, make sure we always pick the format we expect. Closes: https://gitlab.gnome.org/GNOME/mutter/issues/2
2018-02-23 14:14:07 +00:00
gboolean meta_egl_get_config_attrib (MetaEgl *egl,
EGLDisplay display,
EGLConfig config,
EGLint attribute,
EGLint *value,
GError **error);
EGLConfig * meta_egl_choose_all_configs (MetaEgl *egl,
EGLDisplay display,
const EGLint *attrib_list,
EGLint *out_num_configs,
GError **error);
egl: Add more API used when rendering Eventually, we'll render buffers without using Cogl, and for this we need to be able to do things like creating, destroying and changing the context, as well as swapping buffers. https://bugzilla.gnome.org/show_bug.cgi?id=785381
2017-07-24 09:17:25 +00:00
EGLContext meta_egl_create_context (MetaEgl *egl,
EGLDisplay display,
EGLConfig config,
EGLContext share_context,
const EGLint *attrib_list,
GError **error);
gboolean meta_egl_destroy_context (MetaEgl *egl,
EGLDisplay display,
EGLContext context,
GError **error);
egl: Add helpers for importing Wayland buffers as EGLImage's https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-10-20 06:15:28 +00:00
EGLImageKHR meta_egl_create_image (MetaEgl *egl,
EGLDisplay display,
EGLContext context,
EGLenum target,
EGLClientBuffer buffer,
const EGLint *attrib_list,
GError **error);
gboolean meta_egl_destroy_image (MetaEgl *egl,
EGLDisplay display,
EGLImageKHR image,
GError **error);
egl: Introduce meta_egl_create_dmabuf_image This bit of code was more or less duplicated in meta-renderer-native-gles3.c and meta-wayland-dma-buf.c. Start consolidating the two implementations by moving the *-gles3.c function into meta-egl.c and generalizing it so it could also accommodate the meta-wayland-dma-buf.c usage. The workaround in the *-gles3.c implementation is moved to the caller. It is the caller's responsibility to check for the existence of the appropriate EGL extensions. Commit 6f59e4858e24c828e3ab0e611d36dfaaded1b272 worked around the lack of EGL_EXT_image_dma_buf_import_modifiers with the assumption that if the modifier is linear, there is no need to pass it into EGL. The problem is that not passing a modifier explicitly to EGL invokes implementation-defined behaviour, so we should not have that workaround in meta-egl.c. This patch intends to be pure refactoring, no behavioral changes. The one change is the addition of g_assert to catch overwriting arbitrary memory. https://gitlab.gnome.org/GNOME/mutter/merge_requests/615
2019-06-10 14:07:55 +00:00
EGLImageKHR meta_egl_create_dmabuf_image (MetaEgl *egl,
EGLDisplay egl_display,
unsigned int width,
unsigned int height,
uint32_t drm_format,
uint32_t n_planes,
const int *fds,
const uint32_t *strides,
const uint32_t *offsets,
const uint64_t *modifiers,
GError **error);
renderer-native: Always use MetaEgl when interacting with EGL Partly for consistency, partly for error handling functionality. https://bugzilla.gnome.org/show_bug.cgi?id=785381
2017-07-24 08:19:55 +00:00
EGLSurface meta_egl_create_window_surface (MetaEgl *egl,
EGLDisplay display,
EGLConfig config,
EGLNativeWindowType native_window_type,
const EGLint *attrib_list,
GError **error);
MetaRendererNative: Use pbuffer surface as dummy surface Lets use a pbuffer surface as a dummy surface instead of a gbm based one, so that we don't need to rely on the availability of gbm to create a dummy surface when there is no need for it. https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-08-31 03:25:45 +00:00
EGLSurface meta_egl_create_pbuffer_surface (MetaEgl *egl,
EGLDisplay display,
EGLConfig config,
const EGLint *attrib_list,
GError **error);
renderer-native: Always use MetaEgl when interacting with EGL Partly for consistency, partly for error handling functionality. https://bugzilla.gnome.org/show_bug.cgi?id=785381
2017-07-24 08:19:55 +00:00
gboolean meta_egl_destroy_surface (MetaEgl *egl,
EGLDisplay display,
EGLSurface surface,
GError **error);
MetaEgl: Add eglGetPlatformDisplayEXT helper Prepare a helper function for the more reliable way to get a platform display. https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-10-28 11:15:02 +00:00
EGLDisplay meta_egl_get_platform_display (MetaEgl *egl,
EGLenum platform,
void *native_display,
const EGLint *attrib_list,
GError **error);
renderer-native: Always use MetaEgl when interacting with EGL Partly for consistency, partly for error handling functionality. https://bugzilla.gnome.org/show_bug.cgi?id=785381
2017-07-24 08:19:55 +00:00
gboolean meta_egl_terminate (MetaEgl *egl,
EGLDisplay display,
GError **error);
egl: Add more API used when rendering Eventually, we'll render buffers without using Cogl, and for this we need to be able to do things like creating, destroying and changing the context, as well as swapping buffers. https://bugzilla.gnome.org/show_bug.cgi?id=785381
2017-07-24 09:17:25 +00:00
gboolean meta_egl_make_current (MetaEgl *egl,
EGLDisplay display,
EGLSurface draw,
EGLSurface read,
EGLContext context,
GError **error);
gboolean meta_egl_swap_buffers (MetaEgl *egl,
EGLDisplay display,
EGLSurface surface,
GError **error);
egl: Add helpers for importing Wayland buffers as EGLImage's https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-10-20 06:15:28 +00:00
gboolean meta_egl_query_wayland_buffer (MetaEgl *egl,
EGLDisplay display,
struct wl_resource *buffer,
EGLint attribute,
EGLint *value,
GError **error);
MetaEgl: Add EGL procs necessary for EGLDevice based rendering https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-08-18 03:27:45 +00:00
gboolean meta_egl_query_devices (MetaEgl *egl,
EGLint max_devices,
EGLDeviceEXT *devices,
EGLint *num_devices,
GError **error);
const char * meta_egl_query_device_string (MetaEgl *egl,
EGLDeviceEXT device,
EGLint name,
GError **error);
Fix const qualifier usage As with the commits earlier, this also adds const qualifiers where expected. However, the const variables are casted to non-const variants so they can be passed to glib functions that take non-const variants but expect const-like input.
2019-01-20 10:46:46 +00:00
gboolean meta_egl_egl_device_has_extensions (MetaEgl *egl,
EGLDeviceEXT device,
const char ***missing_extensions,
const char *first_extension,
MetaEgl: Add EGL procs necessary for EGLDevice based rendering https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-08-18 03:27:45 +00:00
...);
gboolean meta_egl_get_output_layers (MetaEgl *egl,
EGLDisplay display,
const EGLAttrib *attrib_list,
EGLOutputLayerEXT *layers,
EGLint max_layers,
EGLint *num_layers,
GError **error);
gboolean meta_egl_query_output_layer_attrib (MetaEgl *egl,
EGLDisplay display,
EGLOutputLayerEXT layer,
EGLint attribute,
EGLAttrib *value,
GError **error);
EGLStreamKHR meta_egl_create_stream (MetaEgl *egl,
EGLDisplay display,
const EGLint *attrib_list,
GError **error);
gboolean meta_egl_destroy_stream (MetaEgl *egl,
EGLDisplay display,
EGLStreamKHR stream,
GError **error);
gboolean meta_egl_query_stream (MetaEgl *egl,
EGLDisplay display,
EGLStreamKHR stream,
EGLenum attribute,
EGLint *value,
GError **error);
egl: Add EGL_WL_wayland_eglstream helpers These are to replace the file descriptor hack currently in use. https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-12-09 03:12:11 +00:00
EGLStreamKHR meta_egl_create_stream_attrib (MetaEgl *egl,
EGLDisplay display,
const EGLAttrib *attrib_list,
GError **error);
MetaEgl: Add EGL procs necessary for EGLDevice based rendering https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-08-18 03:27:45 +00:00
EGLSurface meta_egl_create_stream_producer_surface (MetaEgl *egl,
EGLDisplay display,
EGLConfig config,
EGLStreamKHR stream,
const EGLint *attrib_list,
GError **error);
gboolean meta_egl_stream_consumer_output (MetaEgl *egl,
EGLDisplay display,
EGLStreamKHR stream,
EGLOutputLayerEXT layer,
GError **error);
gboolean meta_egl_stream_consumer_acquire_attrib (MetaEgl *egl,
EGLDisplay display,
EGLStreamKHR stream,
EGLAttrib *attrib_list,
GError **error);
egl: Add vfuncs needed for client EGLStream surfaces https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-10-20 08:44:18 +00:00
gboolean meta_egl_stream_consumer_acquire (MetaEgl *egl,
EGLDisplay display,
EGLStreamKHR stream,
GError **error);
MetaEgl: Add EGL procs necessary for EGLDevice based rendering https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-08-18 03:27:45 +00:00
gboolean meta_egl_stream_consumer_gl_texture_external (MetaEgl *egl,
EGLDisplay display,
EGLStreamKHR stream,
GError **error);
wayland: Add zwp_linux_dmabuf_v1 support https://bugzilla.gnome.org/show_bug.cgi?id=785262 Signed-off-by: Daniel Stone <daniels@collabora.com>
2017-07-11 15:03:26 +00:00
gboolean meta_egl_query_dma_buf_formats (MetaEgl *egl,
EGLDisplay display,
EGLint max_formats,
EGLint *formats,
EGLint *num_formats,
GError **error);
gboolean meta_egl_query_dma_buf_modifiers (MetaEgl *egl,
EGLDisplay display,
EGLint format,
EGLint max_modifiers,
EGLuint64KHR *modifiers,
EGLBoolean *external_only,
EGLint *num_formats,
GError **error);
Add EGL abstraction class MetaEgl Add a MetaEgl meant to deal with EGL. It is intended to be use by EGL based renderers and handle extension symbols loading, handle errors etc. https://bugzilla.gnome.org/show_bug.cgi?id=773629
2016-08-18 02:18:28 +00:00
#endif /* META_EGL_H */
Copy permalink