src/video/SDL_egl_c.h
author Ryan C. Gordon <icculus@icculus.org>
Thu, 09 Apr 2015 22:28:37 -0400
changeset 9541 cf8fab52e33b
parent 8149 681eb46b8ac4
child 9619 b94b6d0bff0f
permissions -rw-r--r--
Merged Alex Szpakowski's iOS-improvement branch to default.

Fixes Bugzilla #2798.
Fixes Bugzilla #2212.
Fixes Bugzilla #2826.
Fixes Bugzilla #2661.
Fixes Bugzilla #1885.
Fixes Bugzilla #1578.
Fixes Bugzilla #2751.

(whew!)

Notable changes, from Alex's notes:

- The SDL_WINDOW_ALLOW_HIGHDPI flag is now needed (along with SDL_GL_GetDrawableSize or SDL_GetRendererOutputSize) to use Retina / high DPI resolutions, bringing SDL’s Retina-related behavior on iOS in line with Mac OS X. Window dimensions and display modes are now in the “points” (non-high DPI) coordinate system rather than pixels, whereas SDL_GL_GetDrawableSize is in pixels.

- Reworked the custom extended launch screen code:
- It now hides after the first SDL_PumpEvents call rather than SDL_CreateWindow, and it fades out in a similar manner to the system launch screen behavior.
- It now mirrors the system launch screen behavior when deciding which image to display: it falls back to using the Launch Images dictionary in Info.plist if the iOS 8+ launch screen nib isn’t available, and if the Launch Images dictionary doesn’t exist it uses the old standard launch image names.
- The extended launch screen can now be disabled via the SDL_IPHONE_LAUNCHSCREEN define in SDL_config_iphoneos.h.

- Added support for SDL_HINT_ACCELEROMETER_AS_JOYSTICK.

- Added access to a window view's renderbuffer and framebuffer to syswm.

- Added OpenGL ES debug labels for the Renderbuffer and Framebuffer Objects created with SDL_GL_CreateContext.

- Added support for sRGB OpenGL ES contexts on iOS 7+.

- Updated OpenGL ES contexts to support native-resolution rendering (when SDL_WINDOW_ALLOW_HIGHDPI is enabled) on the iPhone 6 Plus, i.e. 1080x1920 rather than 1242x2208.

- Updated SDL_GL_CreateContext, SDL_GL_SwapWindow, SDL_GL_MakeCurrent, and SDL_GL_DeleteContext to be more robust.

- Updated SDL windows to display a UIView at all times, even when an OpenGL context is not active. This allows rotation, touch events, and other windowing-related events to work properly without an active OpenGL context. It also makes it easier to use SDL_GetWindowWMInfo after creating a SDL window.

- Updated the iOS-specific Objective-C code to use cleaner and more modern language features and APIs, including ARC instead of manual reference counting.

- Updated SDL_HINT_ORIENTATIONS to allow disabling custom orientations if the hint is set with no valid orientation names.

- Fixed several rotation and orientation bugs with windows and display modes, especially in iOS 8+.

- Fixed SDL_SetWindowFullscreen failing to update the status bar visibility on iOS 7+.

- Fixed the orientation of the offset applied to the window’s view when the onscreen keyboard is shown in iOS 8+.

- Fixed SDL_IsScreenKeyboardShown (patch by Phil Hassey.)

- Fixed several major memory leaks caused by missing autorelease pool blocks in the iOS-specific Objective-C code.

- Removed several dead code paths.

- The iOS 7 SDK (Xcode 5) or newer is now required to build SDL for iOS.
     1 /*
     2   Simple DirectMedia Layer
     3   Copyright (C) 1997-2014 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     EGLBoolean(EGLAPIENTRY *eglInitialize) (EGLDisplay dpy, EGLint * major,
    41                                 EGLint * minor);
    42     EGLBoolean(EGLAPIENTRY  *eglTerminate) (EGLDisplay dpy);
    43     
    44     void *(EGLAPIENTRY *eglGetProcAddress) (const char * procName);
    45     
    46     EGLBoolean(EGLAPIENTRY *eglChooseConfig) (EGLDisplay dpy,
    47                                   const EGLint * attrib_list,
    48                                   EGLConfig * configs,
    49                                   EGLint config_size, EGLint * num_config);
    50     
    51     EGLContext(EGLAPIENTRY *eglCreateContext) (EGLDisplay dpy,
    52                                    EGLConfig config,
    53                                    EGLContext share_list,
    54                                    const EGLint * attrib_list);
    55     
    56     EGLBoolean(EGLAPIENTRY *eglDestroyContext) (EGLDisplay dpy, EGLContext ctx);
    57     
    58     EGLSurface(EGLAPIENTRY *eglCreateWindowSurface) (EGLDisplay dpy,
    59                                          EGLConfig config,
    60                                          NativeWindowType window,
    61                                          const EGLint * attrib_list);
    62     EGLBoolean(EGLAPIENTRY *eglDestroySurface) (EGLDisplay dpy, EGLSurface surface);
    63     
    64     EGLBoolean(EGLAPIENTRY *eglMakeCurrent) (EGLDisplay dpy, EGLSurface draw,
    65                                  EGLSurface read, EGLContext ctx);
    66     
    67     EGLBoolean(EGLAPIENTRY *eglSwapBuffers) (EGLDisplay dpy, EGLSurface draw);
    68     
    69     EGLBoolean(EGLAPIENTRY *eglSwapInterval) (EGLDisplay dpy, EGLint interval);
    70     
    71     const char *(EGLAPIENTRY *eglQueryString) (EGLDisplay dpy, EGLint name);
    72     
    73     EGLBoolean(EGLAPIENTRY  *eglGetConfigAttrib) (EGLDisplay dpy, EGLConfig config,
    74                                      EGLint attribute, EGLint * value);
    75     
    76     EGLBoolean(EGLAPIENTRY *eglWaitNative) (EGLint  engine);
    77 
    78     EGLBoolean(EGLAPIENTRY *eglWaitGL)(void);
    79     
    80     EGLBoolean(EGLAPIENTRY *eglBindAPI)(EGLenum);
    81 
    82 } SDL_EGL_VideoData;
    83 
    84 /* OpenGLES functions */
    85 extern int SDL_EGL_GetAttribute(_THIS, SDL_GLattr attrib, int *value);
    86 extern int SDL_EGL_LoadLibrary(_THIS, const char *path, NativeDisplayType native_display);
    87 extern void *SDL_EGL_GetProcAddress(_THIS, const char *proc);
    88 extern void SDL_EGL_UnloadLibrary(_THIS);
    89 extern int SDL_EGL_ChooseConfig(_THIS);
    90 extern int SDL_EGL_SetSwapInterval(_THIS, int interval);
    91 extern int SDL_EGL_GetSwapInterval(_THIS);
    92 extern void SDL_EGL_DeleteContext(_THIS, SDL_GLContext context);
    93 extern EGLSurface *SDL_EGL_CreateSurface(_THIS, NativeWindowType nw);
    94 extern void SDL_EGL_DestroySurface(_THIS, EGLSurface egl_surface);
    95 
    96 /* These need to be wrapped to get the surface for the window by the platform GLES implementation */
    97 extern SDL_GLContext SDL_EGL_CreateContext(_THIS, EGLSurface egl_surface);
    98 extern int SDL_EGL_MakeCurrent(_THIS, EGLSurface egl_surface, SDL_GLContext context);
    99 extern void SDL_EGL_SwapBuffers(_THIS, EGLSurface egl_surface);
   100 
   101 /* A few of useful macros */
   102 
   103 #define SDL_EGL_SwapWindow_impl(BACKEND) void \
   104 BACKEND ## _GLES_SwapWindow(_THIS, SDL_Window * window) \
   105 {\
   106     SDL_EGL_SwapBuffers(_this, ((SDL_WindowData *) window->driverdata)->egl_surface);\
   107 }
   108 
   109 #define SDL_EGL_MakeCurrent_impl(BACKEND) int \
   110 BACKEND ## _GLES_MakeCurrent(_THIS, SDL_Window * window, SDL_GLContext context) \
   111 {\
   112     if (window && context) { \
   113         return SDL_EGL_MakeCurrent(_this, ((SDL_WindowData *) window->driverdata)->egl_surface, context); \
   114     }\
   115     else {\
   116         return SDL_EGL_MakeCurrent(_this, NULL, NULL);\
   117     }\
   118 }
   119 
   120 #define SDL_EGL_CreateContext_impl(BACKEND) SDL_GLContext \
   121 BACKEND ## _GLES_CreateContext(_THIS, SDL_Window * window) \
   122 {\
   123     return SDL_EGL_CreateContext(_this, ((SDL_WindowData *) window->driverdata)->egl_surface);\
   124 }
   125 
   126 #endif /* SDL_VIDEO_OPENGL_EGL */
   127 
   128 #endif /* _SDL_egl_h */
   129 
   130 /* vi: set ts=4 sw=4 expandtab: */