xref: /OK3568_Linux_fs/external/xserver/glamor/glamor_egl.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /*
2*4882a593Smuzhiyun  * Copyright © 2016 Red Hat, Inc.
3*4882a593Smuzhiyun  *
4*4882a593Smuzhiyun  * Permission is hereby granted, free of charge, to any person obtaining a
5*4882a593Smuzhiyun  * copy of this software and associated documentation files (the "Software"),
6*4882a593Smuzhiyun  * to deal in the Software without restriction, including without limitation
7*4882a593Smuzhiyun  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8*4882a593Smuzhiyun  * and/or sell copies of the Software, and to permit persons to whom the
9*4882a593Smuzhiyun  * Software is furnished to do so, subject to the following conditions:
10*4882a593Smuzhiyun  *
11*4882a593Smuzhiyun  * The above copyright notice and this permission notice (including the next
12*4882a593Smuzhiyun  * paragraph) shall be included in all copies or substantial portions of the
13*4882a593Smuzhiyun  * Software.
14*4882a593Smuzhiyun  *
15*4882a593Smuzhiyun  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16*4882a593Smuzhiyun  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17*4882a593Smuzhiyun  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
18*4882a593Smuzhiyun  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19*4882a593Smuzhiyun  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20*4882a593Smuzhiyun  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
21*4882a593Smuzhiyun  * DEALINGS IN THE SOFTWARE.
22*4882a593Smuzhiyun  *
23*4882a593Smuzhiyun  * Authors:
24*4882a593Smuzhiyun  *	Adam Jackson <ajax@redhat.com>
25*4882a593Smuzhiyun  */
26*4882a593Smuzhiyun 
27*4882a593Smuzhiyun #ifndef GLAMOR_EGL_H
28*4882a593Smuzhiyun #define GLAMOR_EGL_H
29*4882a593Smuzhiyun 
30*4882a593Smuzhiyun #define MESA_EGL_NO_X11_HEADERS
31*4882a593Smuzhiyun #define EGL_NO_X11
32*4882a593Smuzhiyun #include <epoxy/gl.h>
33*4882a593Smuzhiyun #include <epoxy/egl.h>
34*4882a593Smuzhiyun #include <glamor_egl_ext.h>
35*4882a593Smuzhiyun 
36*4882a593Smuzhiyun /*
37*4882a593Smuzhiyun  * Create an EGLDisplay from a native display type. This is a little quirky
38*4882a593Smuzhiyun  * for a few reasons.
39*4882a593Smuzhiyun  *
40*4882a593Smuzhiyun  * 1: GetPlatformDisplayEXT and GetPlatformDisplay are the API you want to
41*4882a593Smuzhiyun  * use, but have different function signatures in the third argument; this
42*4882a593Smuzhiyun  * happens not to matter for us, at the moment, but it means epoxy won't alias
43*4882a593Smuzhiyun  * them together.
44*4882a593Smuzhiyun  *
45*4882a593Smuzhiyun  * 2: epoxy 1.3 and earlier don't understand EGL client extensions, which
46*4882a593Smuzhiyun  * means you can't call "eglGetPlatformDisplayEXT" directly, as the resolver
47*4882a593Smuzhiyun  * will crash.
48*4882a593Smuzhiyun  *
49*4882a593Smuzhiyun  * 3: You can't tell whether you have EGL 1.5 at this point, because
50*4882a593Smuzhiyun  * eglQueryString(EGL_VERSION) is a property of the display, which we don't
51*4882a593Smuzhiyun  * have yet. So you have to query for extensions no matter what. Fortunately
52*4882a593Smuzhiyun  * epoxy_has_egl_extension _does_ let you query for client extensions, so
53*4882a593Smuzhiyun  * we don't have to write our own extension string parsing.
54*4882a593Smuzhiyun  *
55*4882a593Smuzhiyun  * 4. There is no EGL_KHR_platform_base to complement the EXT one, thus one
56*4882a593Smuzhiyun  * needs to know EGL 1.5 is supported in order to use the eglGetPlatformDisplay
57*4882a593Smuzhiyun  * function pointer.
58*4882a593Smuzhiyun  * We can workaround this (circular dependency) by probing for the EGL 1.5
59*4882a593Smuzhiyun  * platform extensions (EGL_KHR_platform_gbm and friends) yet it doesn't seem
60*4882a593Smuzhiyun  * like mesa will be able to adverise these (even though it can do EGL 1.5).
61*4882a593Smuzhiyun  */
62*4882a593Smuzhiyun static inline EGLDisplay
glamor_egl_get_display(EGLint type,void * native)63*4882a593Smuzhiyun glamor_egl_get_display(EGLint type, void *native)
64*4882a593Smuzhiyun {
65*4882a593Smuzhiyun     /* In practise any EGL 1.5 implementation would support the EXT extension */
66*4882a593Smuzhiyun     if (epoxy_has_egl_extension(NULL, "EGL_EXT_platform_base")) {
67*4882a593Smuzhiyun         PFNEGLGETPLATFORMDISPLAYEXTPROC getPlatformDisplayEXT =
68*4882a593Smuzhiyun             (void *) eglGetProcAddress("eglGetPlatformDisplayEXT");
69*4882a593Smuzhiyun         if (getPlatformDisplayEXT)
70*4882a593Smuzhiyun             return getPlatformDisplayEXT(type, native, NULL);
71*4882a593Smuzhiyun     }
72*4882a593Smuzhiyun 
73*4882a593Smuzhiyun     /* Welp, everything is awful. */
74*4882a593Smuzhiyun     return eglGetDisplay(native);
75*4882a593Smuzhiyun }
76*4882a593Smuzhiyun 
77*4882a593Smuzhiyun #endif
78