3 * @brief EGL OpenGL extension module
5 /*****************************************************************************
6 * Copyright © 2010-2011 Rémi Denis-Courmont
8 * This program is free software; you can redistribute it and/or modify it
9 * under the terms of the GNU Lesser General Public License as published by
10 * the Free Software Foundation; either version 2.1 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public License
19 * along with this program; if not, write to the Free Software Foundation,
20 * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
21 *****************************************************************************/
31 #include <vlc_common.h>
32 #include <vlc_plugin.h>
33 #include <vlc_opengl.h>
34 #include <vlc_vout_window.h>
36 # include <vlc_xlib.h>
39 /* Plugin callbacks */
40 static int OpenGLES2 (vlc_object_t *);
41 static int OpenGLES (vlc_object_t *);
42 static int OpenGL (vlc_object_t *);
43 static void Close (vlc_object_t *);
46 set_shortname (N_("EGL"))
47 set_description (N_("EGL extension for OpenGL"))
48 set_category (CAT_VIDEO)
49 set_subcategory (SUBCAT_VIDEO_VOUT)
50 set_capability ("opengl", 50)
51 set_callbacks (OpenGL, Close)
54 set_capability ("opengl es2", 50)
55 set_callbacks (OpenGLES2, Close)
58 set_capability ("opengl es", 50)
59 set_callbacks (OpenGLES, Close)
63 typedef struct vlc_gl_sys_t
70 /* OpenGL callbacks */
71 static int MakeCurrent (vlc_gl_t *);
72 static void SwapBuffers (vlc_gl_t *);
73 static void *GetSymbol(vlc_gl_t *, const char *);
75 static bool CheckAPI (EGLDisplay dpy, const char *api)
77 const char *apis = eglQueryString (dpy, EGL_CLIENT_APIS);
78 size_t apilen = strlen (api);
80 /* Cannot use strtok_r() on constant string... */
85 if (!strncmp (apis, api, apilen)
86 && (memchr (" ", apis[apilen], 2) != NULL))
89 apis = strchr (apis, ' ');
106 * Probe EGL display availability
108 static int Open (vlc_object_t *obj, const struct gl_api *api)
110 vlc_gl_t *gl = (vlc_gl_t *)obj;
112 /* <EGL/eglplatform.h> defines the list and order of platforms */
113 #if defined(_WIN32) || defined(__VC32__) \
114 && !defined(__CYGWIN__) && !defined(__SCITECH_SNAP__)
115 # define vlc_eglGetWindow(w) ((w)->handle.hwnd)
117 #elif defined(__WINSCW__) || defined(__SYMBIAN32__) /* Symbian */
118 # error Symbian EGL not supported.
120 #elif defined(WL_EGL_PLATFORM)
121 # error Wayland EGL not supported.
123 #elif defined(__GBM__)
124 # error Glamor EGL not supported.
126 #elif defined(ANDROID)
127 # error Android EGL not supported
129 #elif defined(__unix__) /* X11 */
130 # define vlc_eglGetWindow(w) ((w)->handle.xid)
131 /* EGL can only use the default X11 display */
132 if (gl->surface->display.x11 != NULL)
134 if (!vlc_xlib_init (obj))
138 # error EGL platform not recognized.
141 /* Initialize EGL display */
142 /* TODO: support various display types */
143 EGLDisplay dpy = eglGetDisplay (EGL_DEFAULT_DISPLAY);
144 if (dpy == EGL_NO_DISPLAY)
147 vlc_gl_sys_t *sys = malloc (sizeof (*sys));
148 if (unlikely(sys == NULL))
154 if (eglInitialize (dpy, &major, &minor) != EGL_TRUE)
156 /* No need to call eglTerminate() in this case */
161 if (major != 1 || minor < api->min_minor || !CheckAPI (dpy, api->name))
164 msg_Dbg (obj, "EGL version %s by %s", eglQueryString (dpy, EGL_VERSION),
165 eglQueryString (dpy, EGL_VENDOR));
167 const char *ext = eglQueryString (dpy, EGL_EXTENSIONS);
169 msg_Dbg (obj, " extensions: %s", ext);
172 const EGLint conf_attr[] = {
176 EGL_RENDERABLE_TYPE, api->render_bit,
182 if (eglChooseConfig (dpy, conf_attr, cfgv, 1, &cfgc) != EGL_TRUE
186 /* Create a drawing surface */
187 EGLNativeWindowType win = vlc_eglGetWindow(gl->surface);
188 EGLSurface surface = eglCreateWindowSurface (dpy, cfgv[0], win, NULL);
189 if (surface == EGL_NO_SURFACE)
191 msg_Err (obj, "cannot create EGL window surface");
194 sys->surface = surface;
196 if (eglBindAPI (api->api) != EGL_TRUE)
198 msg_Err (obj, "cannot bind EGL API");
202 EGLContext ctx = eglCreateContext (dpy, cfgv[0], EGL_NO_CONTEXT,
204 if (ctx == EGL_NO_CONTEXT)
206 msg_Err (obj, "cannot create EGL context");
211 /* Initialize OpenGL callbacks */
213 gl->makeCurrent = MakeCurrent;
214 gl->swap = SwapBuffers;
215 gl->getProcAddress = GetSymbol;
225 static int OpenGLES2 (vlc_object_t *obj)
227 static const struct gl_api api = {
228 "OpenGL_ES", EGL_OPENGL_ES_API, 3, EGL_OPENGL_ES2_BIT,
229 { EGL_CONTEXT_CLIENT_VERSION, 2, EGL_NONE },
231 return Open (obj, &api);
234 static int OpenGLES (vlc_object_t *obj)
236 static const struct gl_api api = {
237 "OpenGL_ES", EGL_OPENGL_ES_API, 0, EGL_OPENGL_ES_BIT,
238 { EGL_CONTEXT_CLIENT_VERSION, 1, EGL_NONE },
240 return Open (obj, &api);
243 static int OpenGL (vlc_object_t *obj)
245 static const struct gl_api api = {
246 "OpenGL", EGL_OPENGL_API, 4, EGL_OPENGL_BIT,
249 return Open (obj, &api);
252 static void Close (vlc_object_t *obj)
254 vlc_gl_t *gl = (vlc_gl_t *)obj;
255 vlc_gl_sys_t *sys = gl->sys;
257 eglTerminate (sys->display);
261 static int MakeCurrent (vlc_gl_t *gl)
263 vlc_gl_sys_t *sys = gl->sys;
265 if (eglMakeCurrent (sys->display, sys->surface, sys->surface,
266 sys->context) != EGL_TRUE)
271 static void SwapBuffers (vlc_gl_t *gl)
273 vlc_gl_sys_t *sys = gl->sys;
275 eglSwapBuffers (sys->display, sys->surface);
278 static void *GetSymbol(vlc_gl_t *gl, const char *procname)
281 return (void *)eglGetProcAddress (procname);