src/video/SDL_egl_c.h
author Sam Lantinga <slouken@libsdl.org>
Wed, 02 Aug 2017 10:22:48 -0700
changeset 11175 cbc6a8a5b701
parent 10740 bb53965b659d
child 11677 aed6a9ff3c99
permissions -rw-r--r--
Fixed bug 3690 - SDL2 KMS/DRM render context support

Manuel

The attached patch adds support for KMS/DRM context graphics.

It builds with no problem on X86_64 GNU/Linux systems, provided the needed libraries are present, and on ARM GNU/Linux systems that have KMS/DRM support and a GLES2 implementation.
Tested on Raspberry Pi: KMS/DRM is what the Raspberry Pi will use as default in the near future, once the propietary DispmanX API by Broadcom is overtaken by open graphics stack, it's possible to boot current Raspbian system in KMS mode by adding "dtoverlay=vc4-kms-v3d" to config.txt on Raspbian's boot partition.
X86 systems use KMS right away in every current GNU/Linux system.

Simple build instructions:

$./autogen.sh
$./configure --enable-video-kmsdrm
$make
     1 /*
     2   Simple DirectMedia Layer
     3   Copyright (C) 1997-2017 Sam Lantinga <slouken@libsdl.org>
     4 
     5   This software is provided 'as-is', without any express or implied
     6   warranty.  In no event will the authors be held liable for any damages
     7   arising from the use of this software.
     8 
     9   Permission is granted to anyone to use this software for any purpose,
    10   including commercial applications, and to alter it and redistribute it
    11   freely, subject to the following restrictions:
    12 
    13   1. The origin of this software must not be misrepresented; you must not
    14      claim that you wrote the original software. If you use this software
    15      in a product, an acknowledgment in the product documentation would be
    16      appreciated but is not required.
    17   2. Altered source versions must be plainly marked as such, and must not be
    18      misrepresented as being the original software.
    19   3. This notice may not be removed or altered from any source distribution.
    20 */
    21 #include "../SDL_internal.h"
    22 
    23 #ifndef SDL_egl_h_
    24 #define SDL_egl_h_
    25 
    26 #if SDL_VIDEO_OPENGL_EGL
    27 
    28 #include "SDL_egl.h"
    29 
    30 #include "SDL_sysvideo.h"
    31 
    32 typedef struct SDL_EGL_VideoData
    33 {
    34     void *egl_dll_handle, *dll_handle;
    35     EGLDisplay egl_display;
    36     EGLConfig egl_config;
    37     int egl_swapinterval;
    38     
    39     EGLDisplay(EGLAPIENTRY *eglGetDisplay) (NativeDisplayType display);
    40     EGLDisplay(EGLAPIENTRY *eglGetPlatformDisplay) (EGLenum platform,
    41                                 void *native_display,
    42                                 const EGLint *attrib_list);
    43     EGLDisplay(EGLAPIENTRY *eglGetPlatformDisplayEXT) (EGLenum platform,
    44                                 void *native_display,
    45                                 const EGLint *attrib_list);
    46     EGLBoolean(EGLAPIENTRY *eglInitialize) (EGLDisplay dpy, EGLint * major,
    47                                 EGLint * minor);
    48     EGLBoolean(EGLAPIENTRY  *eglTerminate) (EGLDisplay dpy);
    49     
    50     void *(EGLAPIENTRY *eglGetProcAddress) (const char * procName);
    51     
    52     EGLBoolean(EGLAPIENTRY *eglChooseConfig) (EGLDisplay dpy,
    53                                   const EGLint * attrib_list,
    54                                   EGLConfig * configs,
    55                                   EGLint config_size, EGLint * num_config);
    56     
    57     EGLContext(EGLAPIENTRY *eglCreateContext) (EGLDisplay dpy,
    58                                    EGLConfig config,
    59                                    EGLContext share_list,
    60                                    const EGLint * attrib_list);
    61     
    62     EGLBoolean(EGLAPIENTRY *eglDestroyContext) (EGLDisplay dpy, EGLContext ctx);
    63     
    64     EGLSurface(EGLAPIENTRY *eglCreateWindowSurface) (EGLDisplay dpy,
    65                                          EGLConfig config,
    66                                          NativeWindowType window,
    67                                          const EGLint * attrib_list);
    68     EGLBoolean(EGLAPIENTRY *eglDestroySurface) (EGLDisplay dpy, EGLSurface surface);
    69     
    70     EGLBoolean(EGLAPIENTRY *eglMakeCurrent) (EGLDisplay dpy, EGLSurface draw,
    71                                  EGLSurface read, EGLContext ctx);
    72     
    73     EGLBoolean(EGLAPIENTRY *eglSwapBuffers) (EGLDisplay dpy, EGLSurface draw);
    74     
    75     EGLBoolean(EGLAPIENTRY *eglSwapInterval) (EGLDisplay dpy, EGLint interval);
    76     
    77     const char *(EGLAPIENTRY *eglQueryString) (EGLDisplay dpy, EGLint name);
    78     
    79     EGLBoolean(EGLAPIENTRY  *eglGetConfigAttrib) (EGLDisplay dpy, EGLConfig config,
    80                                      EGLint attribute, EGLint * value);
    81     
    82     EGLBoolean(EGLAPIENTRY *eglWaitNative) (EGLint  engine);
    83 
    84     EGLBoolean(EGLAPIENTRY *eglWaitGL)(void);
    85     
    86     EGLBoolean(EGLAPIENTRY *eglBindAPI)(EGLenum);
    87 
    88     EGLint(EGLAPIENTRY *eglGetError)(void);
    89 
    90 } SDL_EGL_VideoData;
    91 
    92 /* OpenGLES functions */
    93 extern int SDL_EGL_GetAttribute(_THIS, SDL_GLattr attrib, int *value);
    94 /* SDL_EGL_LoadLibrary can get a display for a specific platform (EGL_PLATFORM_*)
    95  * or, if 0 is passed, let the implementation decide.
    96  */
    97 extern int SDL_EGL_LoadLibrary(_THIS, const char *path, NativeDisplayType native_display, EGLenum platform);
    98 extern void *SDL_EGL_GetProcAddress(_THIS, const char *proc);
    99 extern void SDL_EGL_UnloadLibrary(_THIS);
   100 extern int SDL_EGL_ChooseConfig(_THIS);
   101 extern int SDL_EGL_SetSwapInterval(_THIS, int interval);
   102 extern int SDL_EGL_GetSwapInterval(_THIS);
   103 extern void SDL_EGL_DeleteContext(_THIS, SDL_GLContext context);
   104 extern EGLSurface *SDL_EGL_CreateSurface(_THIS, NativeWindowType nw);
   105 extern void SDL_EGL_DestroySurface(_THIS, EGLSurface egl_surface);
   106 
   107 /* These need to be wrapped to get the surface for the window by the platform GLES implementation */
   108 extern SDL_GLContext SDL_EGL_CreateContext(_THIS, EGLSurface egl_surface);
   109 extern int SDL_EGL_MakeCurrent(_THIS, EGLSurface egl_surface, SDL_GLContext context);
   110 extern int SDL_EGL_SwapBuffers(_THIS, EGLSurface egl_surface);
   111 
   112 /* SDL Error-reporting */
   113 extern int SDL_EGL_SetErrorEx(const char * message, const char * eglFunctionName, EGLint eglErrorCode);
   114 #define SDL_EGL_SetError(message, eglFunctionName) SDL_EGL_SetErrorEx(message, eglFunctionName, _this->egl_data->eglGetError())
   115 
   116 /* A few of useful macros */
   117 
   118 #define SDL_EGL_SwapWindow_impl(BACKEND) int \
   119 BACKEND ## _GLES_SwapWindow(_THIS, SDL_Window * window) \
   120 {\
   121     return SDL_EGL_SwapBuffers(_this, ((SDL_WindowData *) window->driverdata)->egl_surface);\
   122 }
   123 
   124 #define SDL_EGL_MakeCurrent_impl(BACKEND) int \
   125 BACKEND ## _GLES_MakeCurrent(_THIS, SDL_Window * window, SDL_GLContext context) \
   126 {\
   127     if (window && context) { \
   128         return SDL_EGL_MakeCurrent(_this, ((SDL_WindowData *) window->driverdata)->egl_surface, context); \
   129     }\
   130     else {\
   131         return SDL_EGL_MakeCurrent(_this, NULL, NULL);\
   132     }\
   133 }
   134 
   135 #define SDL_EGL_CreateContext_impl(BACKEND) SDL_GLContext \
   136 BACKEND ## _GLES_CreateContext(_THIS, SDL_Window * window) \
   137 {\
   138     return SDL_EGL_CreateContext(_this, ((SDL_WindowData *) window->driverdata)->egl_surface);\
   139 }
   140 
   141 #endif /* SDL_VIDEO_OPENGL_EGL */
   142 
   143 #endif /* SDL_egl_h_ */
   144 
   145 /* vi: set ts=4 sw=4 expandtab: */