blankie
/
wlroots
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
wlroots/include/wlr/render/egl.h

89 lines
2.2 KiB
C
Raw Normal View History

Initial pass on API stability guarantees This introduces -DWLR_USE_UNSTABLE and adds information regarding the stability status to all headers. I started with a conservative set of headers to mark as stable: - types/wlr_matrix.h - util/edges.h - util/log.h - util/region.h - xcursor.h
2018-07-13 12:40:56 +00:00
/*
* This an unstable interface of wlroots. No guarantees are made regarding the
* future consistency of this API.
*/
#ifndef WLR_USE_UNSTABLE
#error "Add -DWLR_USE_UNSTABLE to enable unstable wlroots features"
#endif
Reformat all #include directives
2018-02-12 20:29:23 +00:00
#ifndef WLR_RENDER_EGL_H
#define WLR_RENDER_EGL_H
Added EGL interface for backends.
2017-05-03 05:04:41 +00:00
Add new define EGL_NO_X11 for newer mesa library Define both MESA_EGL_NO_X11_HEADERS and EGL_NO_X11 for backward combatibility.
2019-10-16 13:16:53 +00:00
#ifndef MESA_EGL_NO_X11_HEADERS
Tell Mesa not to attempt X11 headers If no X11 related things are being built, tell Mesa's eglplatform.h not to attempt inclusion of associated X11 header.
2018-11-09 19:31:11 +00:00
#define MESA_EGL_NO_X11_HEADERS
#endif
Add new define EGL_NO_X11 for newer mesa library Define both MESA_EGL_NO_X11_HEADERS and EGL_NO_X11 for backward combatibility.
2019-10-16 13:16:53 +00:00
#ifndef EGL_NO_X11
#define EGL_NO_X11
#endif
render: define EGL_NO_PLATFORM_SPECIFIC_TYPES (#2452) This avoids Xlib.h inclusion via EGL headers. See [1] for discussion. This change is based on a Weston commit [2]. [1]: https://github.com/KhronosGroup/EGL-Registry/pull/111 [2]: https://gitlab.freedesktop.org/wayland/weston/commit/526765ddfdfd
2020-11-02 09:51:52 +00:00
#ifndef EGL_NO_PLATFORM_SPECIFIC_TYPES
#define EGL_NO_PLATFORM_SPECIFIC_TYPES
#endif
Tell Mesa not to attempt X11 headers If no X11 related things are being built, tell Mesa's eglplatform.h not to attempt inclusion of associated X11 header.
2018-11-09 19:31:11 +00:00
render/egl: include EGL/eglmesaext.h only if present This patch will make the EGL renderer work on any EGL/GLESv2 driver providing the EGL_WL_bind_wayland_display extensions. Mesa used to declare provisional EGL_WL_bind_wayland_display directly in <EGL/eglext.h>. Then, all unofficial extensions were moved to <EGL/eglmesaext.h>, to have a cleaner implementation. See: https://gitlab.freedesktop.org/mesa/mesa/-/commit/ab7bb10a2af711086319ce35815acd797b86fe27 The extension was then approved at Khronos Group, and reached the official <EGL/eglext.h>. See: https://www.khronos.org/registry/EGL/extensions/WL/EGL_WL_bind_wayland_display.txt https://github.com/KhronosGroup/EGL-Registry/commit/aa9b63f3ab18aee92c95786a2478156430f809e4 In order to make sure the renderer will work on any version of any implementation providing the extension, only include the mesa-specific header if it's present. Signed-off-by: Julien Olivain <juju@cotds.org>
2020-05-11 06:58:30 +00:00
#include <wlr/config.h>
Added EGL interface for backends.
2017-05-03 05:04:41 +00:00
#include <EGL/egl.h>
Implement drm (egl) buffer attaching
2017-08-09 19:25:34 +00:00
#include <EGL/eglext.h>
Swap buffers with damage
2018-02-09 21:54:14 +00:00
#include <pixman.h>
Reformat all #include directives
2018-02-12 20:29:23 +00:00
#include <stdbool.h>
Remove all wayland-server.h includes The documentation for wayland-server.h says: > Use of this header file is discouraged. Prefer including > wayland-server-core.h instead, which does not include the server protocol > header and as such only defines the library PI, excluding the deprecated API > below. Replacing wayland-server.h with wayland-server-core.h allows us to drop the WL_HIDE_DEPRECATED declaration.
2019-07-27 08:53:54 +00:00
#include <wayland-server-core.h>
Only allow one modifier per DMA-BUF, split attributes struct in render/
2018-05-29 21:38:00 +00:00
#include <wlr/render/dmabuf.h>
render: switch wlr_renderer to wlr_drm_format_set
2019-04-01 16:17:23 +00:00
#include <wlr/render/drm_format_set.h>
Added EGL interface for backends.
2017-05-03 05:04:41 +00:00
struct wlr_egl {
EGLDisplay display;
EGLContext context;
render/egl: introduce wlr_egl_dup_drm_fd
2020-06-10 12:26:39 +00:00
EGLDeviceEXT device; // may be EGL_NO_DEVICE_EXT
Revert "render/egl: remove unused gbm_device member" This reverts commit 306cf11d8702c82be61e027a9bb76e27e89b34d3.
2021-01-20 20:20:55 +00:00
struct gbm_device *gbm_device;
Implement drm (egl) buffer attaching
2017-08-09 19:25:34 +00:00
output: add damage tracking via buffer age
2018-01-20 23:06:35 +00:00
struct {
render/egl: introduce wlr_egl_dup_drm_fd
2020-06-10 12:26:39 +00:00
// Display extensions
render/egl: rename wlr_egl.exts to better match Khronos Khronos refers to extensions with their namespace as a prefix in uppercase. Change our naming to align with Khronos conventions. This also makes grepping easier.
2021-07-11 17:55:32 +00:00
bool KHR_image_base;
bool EXT_image_dma_buf_import;
bool EXT_image_dma_buf_import_modifiers;
render/egl: store IMG_context_priority in wlr_egl The next commit will split extension lookup and context initialization.
2021-12-01 13:03:37 +00:00
bool IMG_context_priority;
render/egl: introduce wlr_egl_dup_drm_fd
2020-06-10 12:26:39 +00:00
// Device extensions
render/egl: rename wlr_egl.exts to better match Khronos Khronos refers to extensions with their namespace as a prefix in uppercase. Change our naming to align with Khronos conventions. This also makes grepping easier.
2021-07-11 17:55:32 +00:00
bool EXT_device_drm;
render/egl: add support for EGL_EXT_device_drm_render_node This EGL extension has been added in [1]. The upsides are: - We directly get a render node, instead of having to convert the primary node name to a render node name. - If EGL_DRM_RENDER_NODE_FILE_EXT returns NULL, that means there is no render node being used by the driver. [1]: https://github.com/KhronosGroup/EGL-Registry/pull/127
2021-07-09 11:07:22 +00:00
bool EXT_device_drm_render_node;
render/egl: initialize wlr_egl with EGL_PLATFORM_DEVICE_EXT Uses the EXT_device_query extension to get the EGL device matching the requested DRM file descriptor. If the extension is not supported or no device is found, the EGL device will be retrieved using GBM. Depends on the EGL_EXT_device_enumeration to get the list of EGL devices.
2021-01-21 02:14:04 +00:00
// Client extensions
bool EXT_device_query;
bool KHR_platform_gbm;
bool EXT_platform_device;
render/egl: only request high priority context on DRM
2018-06-07 23:17:45 +00:00
} exts;
Implement drm (egl) buffer attaching
2017-08-09 19:25:34 +00:00
Refactor EGL/GL API loading Remove glapi.sh code generation, replace it with hand-written loading code that checks extension strings before calling eglGetProcAddress. The GLES2 renderer still uses global state because of: - {PUSH,POP}_GLES2_DEBUG macros - wlr_gles2_texture_from_* taking a wlr_egl instead of the renderer
2019-11-10 13:31:33 +00:00
struct {
PFNEGLGETPLATFORMDISPLAYEXTPROC eglGetPlatformDisplayEXT;
PFNEGLCREATEIMAGEKHRPROC eglCreateImageKHR;
PFNEGLDESTROYIMAGEKHRPROC eglDestroyImageKHR;
PFNEGLQUERYWAYLANDBUFFERWL eglQueryWaylandBufferWL;
PFNEGLQUERYDMABUFFORMATSEXTPROC eglQueryDmaBufFormatsEXT;
PFNEGLQUERYDMABUFMODIFIERSEXTPROC eglQueryDmaBufModifiersEXT;
PFNEGLDEBUGMESSAGECONTROLKHRPROC eglDebugMessageControlKHR;
render/egl: introduce wlr_egl_dup_drm_fd
2020-06-10 12:26:39 +00:00
PFNEGLQUERYDISPLAYATTRIBEXTPROC eglQueryDisplayAttribEXT;
PFNEGLQUERYDEVICESTRINGEXTPROC eglQueryDeviceStringEXT;
render/egl: initialize wlr_egl with EGL_PLATFORM_DEVICE_EXT Uses the EXT_device_query extension to get the EGL device matching the requested DRM file descriptor. If the extension is not supported or no device is found, the EGL device will be retrieved using GBM. Depends on the EGL_EXT_device_enumeration to get the list of EGL devices.
2021-01-21 02:14:04 +00:00
PFNEGLQUERYDEVICESEXTPROC eglQueryDevicesEXT;
Refactor EGL/GL API loading Remove glapi.sh code generation, replace it with hand-written loading code that checks extension strings before calling eglGetProcAddress. The GLES2 renderer still uses global state because of: - {PUSH,POP}_GLES2_DEBUG macros - wlr_gles2_texture_from_* taking a wlr_egl instead of the renderer
2019-11-10 13:31:33 +00:00
} procs;
render/egl: improve modifier support detection Support for EXT_image_dma_buf_import_modifiers doesn't necessarily indicate support for modifiers. For instance, Mesa will advertise EXT_image_dma_buf_import_modifiers for all drivers. This is a trick to allow EGL clients to enumerate supported formats (something EXT_image_dma_buf_import is missing). For more information, see [1]. Add a new wlr_egl.has_modifiers flag which indicates whether modifiers are supported. It's set to true if any eglQueryDmaBufModifiersEXT query returned a non-empty list. Use that flag to figure out whether the buffer modifier should be passed to the EGL implementation on import. [1]: https://github.com/KhronosGroup/EGL-Registry/issues/142
2021-11-27 17:33:04 +00:00
bool has_modifiers;
render: rename wlr_renderer_get_dmabuf_formats Rename wlr_renderer_get_dmabuf_formats to wlr_renderer_get_dmabuf_texture_formats. This makes it clear the formats are only suitable for creating wlr_textures.
2020-11-18 13:53:13 +00:00
struct wlr_drm_format_set dmabuf_texture_formats;
render: introduce wlr_renderer_get_dmabuf_render_formats It describes which DMA-BUF formats can be used to render.
2020-11-18 13:16:22 +00:00
struct wlr_drm_format_set dmabuf_render_formats;
Added EGL interface for backends.
2017-05-03 05:04:41 +00:00
};
render/egl: add wlr_egl_create_with_context This allows creating a wlr_egl from an already-existing EGL display and context. This is useful to allow compositors to choose the exact EGL initialization parameters.
2021-11-27 19:01:48 +00:00
struct wlr_egl *wlr_egl_create_with_context(EGLDisplay display,
EGLContext context);
render/egl: introduce wlr_egl_unset_current This function can be called after wlr_egl_make_current to cleanup the EGL context. This avoids having lingering EGL contexts that make things work by chance. Closes: https://github.com/swaywm/wlroots/issues/2197
2020-05-19 09:54:59 +00:00
/**
render/egl: remove surface and buffer age args from make_current These aren't used anymore.
2021-01-09 11:13:35 +00:00
* Make the EGL context current.
render/egl: introduce wlr_egl_unset_current This function can be called after wlr_egl_make_current to cleanup the EGL context. This avoids having lingering EGL contexts that make things work by chance. Closes: https://github.com/swaywm/wlroots/issues/2197
2020-05-19 09:54:59 +00:00
*
* Callers are expected to clear the current context when they are done by
* calling wlr_egl_unset_current.
*/
render/egl: remove surface and buffer age args from make_current These aren't used anymore.
2021-01-09 11:13:35 +00:00
bool wlr_egl_make_current(struct wlr_egl *egl);
output: add damage tracking via buffer age
2018-01-20 23:06:35 +00:00
render/egl: introduce wlr_egl_unset_current This function can be called after wlr_egl_make_current to cleanup the EGL context. This avoids having lingering EGL contexts that make things work by chance. Closes: https://github.com/swaywm/wlroots/issues/2197
2020-05-19 09:54:59 +00:00
bool wlr_egl_unset_current(struct wlr_egl *egl);
Untie wlr_gles2_renderer and wlr_gles2_texture
2018-04-01 20:07:50 +00:00
bool wlr_egl_is_current(struct wlr_egl *egl);
Added EGL interface for backends.
2017-05-03 05:04:41 +00:00
#endif