src/video/x11/SDL_x11modes.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.
slouken@1950
     1
/*
slouken@5535
     2
  Simple DirectMedia Layer
slouken@8149
     3
  Copyright (C) 1997-2014 Sam Lantinga <slouken@libsdl.org>
slouken@1950
     4
slouken@5535
     5
  This software is provided 'as-is', without any express or implied
slouken@5535
     6
  warranty.  In no event will the authors be held liable for any damages
slouken@5535
     7
  arising from the use of this software.
slouken@1950
     8
slouken@5535
     9
  Permission is granted to anyone to use this software for any purpose,
slouken@5535
    10
  including commercial applications, and to alter it and redistribute it
slouken@5535
    11
  freely, subject to the following restrictions:
slouken@1950
    12
slouken@5535
    13
  1. The origin of this software must not be misrepresented; you must not
slouken@5535
    14
     claim that you wrote the original software. If you use this software
slouken@5535
    15
     in a product, an acknowledgment in the product documentation would be
slouken@5535
    16
     appreciated but is not required.
slouken@5535
    17
  2. Altered source versions must be plainly marked as such, and must not be
slouken@5535
    18
     misrepresented as being the original software.
slouken@5535
    19
  3. This notice may not be removed or altered from any source distribution.
slouken@1950
    20
*/
icculus@8093
    21
#include "../../SDL_internal.h"
slouken@1950
    22
slouken@1950
    23
#ifndef _SDL_x11modes_h
slouken@1950
    24
#define _SDL_x11modes_h
slouken@1950
    25
slouken@1950
    26
typedef struct
slouken@1950
    27
{
slouken@1950
    28
    int screen;
slouken@1950
    29
    Visual *visual;
slouken@1951
    30
    int depth;
slouken@2916
    31
    int scanline_pad;
slouken@6548
    32
    int x;
slouken@6548
    33
    int y;
slouken@2873
    34
slouken@2873
    35
    int use_xinerama;
slouken@2873
    36
    int use_xrandr;
slouken@2873
    37
    int use_vidmode;
slouken@2873
    38
slouken@2873
    39
#if SDL_VIDEO_DRIVER_X11_XINERAMA
slouken@5408
    40
    XineramaScreenInfo xinerama_info;
slouken@6506
    41
    int xinerama_screen;
slouken@2873
    42
#endif
slouken@6548
    43
slouken@2873
    44
#if SDL_VIDEO_DRIVER_X11_XRANDR
slouken@6548
    45
    RROutput xrandr_output;
slouken@2873
    46
#endif
slouken@2873
    47
slouken@6565
    48
#if SDL_VIDEO_DRIVER_X11_XVIDMODE
slouken@6565
    49
    int vidmode_screen;
slouken@6565
    50
#endif
slouken@6565
    51
slouken@1950
    52
} SDL_DisplayData;
slouken@1950
    53
slouken@6548
    54
typedef struct
slouken@6548
    55
{
slouken@6548
    56
#if SDL_VIDEO_DRIVER_X11_XRANDR
slouken@6548
    57
    RRMode xrandr_mode;
slouken@6548
    58
#endif
slouken@6548
    59
slouken@6548
    60
#if SDL_VIDEO_DRIVER_X11_XVIDMODE
slouken@6548
    61
    XF86VidModeModeInfo vm_mode;
slouken@6548
    62
#endif
slouken@6548
    63
slouken@6548
    64
} SDL_DisplayModeData;
slouken@6548
    65
slouken@3521
    66
extern int X11_InitModes(_THIS);
slouken@3500
    67
extern void X11_GetDisplayModes(_THIS, SDL_VideoDisplay * display);
slouken@3500
    68
extern int X11_SetDisplayMode(_THIS, SDL_VideoDisplay * display, SDL_DisplayMode * mode);
slouken@1950
    69
extern void X11_QuitModes(_THIS);
slouken@1950
    70
slouken@5182
    71
/* Some utility functions for working with visuals */
slouken@5182
    72
extern int X11_GetVisualInfoFromVisual(Display * display, Visual * visual,
slouken@5182
    73
                                       XVisualInfo * vinfo);
slouken@5182
    74
extern Uint32 X11_GetPixelFormatFromVisualInfo(Display * display,
slouken@5182
    75
                                               XVisualInfo * vinfo);
gabomdq@6331
    76
extern int X11_GetDisplayBounds(_THIS, SDL_VideoDisplay * sdl_display, SDL_Rect * rect);
slouken@5182
    77
slouken@1950
    78
#endif /* _SDL_x11modes_h */
slouken@1950
    79
slouken@1950
    80
/* vi: set ts=4 sw=4 expandtab: */