src/video/winrt/SDL_winrtvideo_cpp.h
author Ryan C. Gordon <icculus@icculus.org>
Thu, 09 Apr 2015 22:28:37 -0400
changeset 9541 cf8fab52e33b
parent 8755 f2fc45874b9c
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.
dludwig@8512
     1
/*
dludwig@8512
     2
  Simple DirectMedia Layer
slouken@8615
     3
  Copyright (C) 1997-2014 Sam Lantinga <slouken@libsdl.org>
dludwig@8512
     4
dludwig@8512
     5
  This software is provided 'as-is', without any express or implied
dludwig@8512
     6
  warranty.  In no event will the authors be held liable for any damages
dludwig@8512
     7
  arising from the use of this software.
dludwig@8512
     8
dludwig@8512
     9
  Permission is granted to anyone to use this software for any purpose,
dludwig@8512
    10
  including commercial applications, and to alter it and redistribute it
dludwig@8512
    11
  freely, subject to the following restrictions:
dludwig@8512
    12
dludwig@8512
    13
  1. The origin of this software must not be misrepresented; you must not
dludwig@8512
    14
     claim that you wrote the original software. If you use this software
dludwig@8512
    15
     in a product, an acknowledgment in the product documentation would be
dludwig@8512
    16
     appreciated but is not required.
dludwig@8512
    17
  2. Altered source versions must be plainly marked as such, and must not be
dludwig@8512
    18
     misrepresented as being the original software.
dludwig@8512
    19
  3. This notice may not be removed or altered from any source distribution.
dludwig@8512
    20
*/
dludwig@8512
    21
dludwig@8512
    22
/* Windows includes: */
dludwig@8512
    23
#include <windows.h>
dludwig@8512
    24
#ifdef __cplusplus_winrt
dludwig@8512
    25
#include <agile.h>
dludwig@8512
    26
#endif
dludwig@8512
    27
dludwig@8512
    28
/* SDL includes: */
dludwig@8541
    29
#include "SDL_video.h"
dludwig@8512
    30
#include "SDL_events.h"
dludwig@8512
    31
dludwig@8541
    32
extern "C" {
dludwig@8541
    33
#include "../SDL_sysvideo.h"
dludwig@8545
    34
#include "../SDL_egl_c.h"
dludwig@8541
    35
}
dludwig@8541
    36
dludwig@8663
    37
/* Private display data */
dludwig@8663
    38
typedef struct SDL_VideoData {
dludwig@8663
    39
    /* An object created by ANGLE/WinRT (OpenGL ES 2 for WinRT) that gets
dludwig@8663
    40
     * passed to eglGetDisplay and eglCreateWindowSurface:
dludwig@8663
    41
     */
dludwig@8663
    42
    IUnknown *winrtEglWindow;
dludwig@8663
    43
} SDL_VideoData;
dludwig@8512
    44
dludwig@8515
    45
/* The global, WinRT, SDL Window.
dludwig@8515
    46
   For now, SDL/WinRT only supports one window (due to platform limitations of
dludwig@8515
    47
   WinRT.
dludwig@8515
    48
*/
dludwig@8515
    49
extern SDL_Window * WINRT_GlobalSDLWindow;
dludwig@8515
    50
slouken@8582
    51
/* Creates a display mode for Plain Direct3D (non-XAML) apps, using the lone, native window's settings.
slouken@8582
    52
slouken@8582
    53
   Pass in an allocated SDL_DisplayMode field to store the data in.
slouken@8582
    54
slouken@8582
    55
   This function will return 0 on success, -1 on failure.
slouken@8582
    56
slouken@8582
    57
   If this function succeeds, be sure to call SDL_free on the
slouken@8582
    58
   SDL_DisplayMode's driverdata field.
slouken@8582
    59
*/
slouken@8582
    60
extern int WINRT_CalcDisplayModeUsingNativeWindow(SDL_DisplayMode * mode);
slouken@8582
    61
slouken@8582
    62
/* Duplicates a display mode, copying over driverdata as necessary */
slouken@8582
    63
extern int WINRT_DuplicateDisplayMode(SDL_DisplayMode * dest, const SDL_DisplayMode * src);
slouken@8582
    64
slouken@8582
    65
/* Display mode internals */
slouken@8582
    66
typedef struct
slouken@8582
    67
{
slouken@8582
    68
    Windows::Graphics::Display::DisplayOrientations currentOrientation;
dludwig@8578
    69
} SDL_DisplayModeData;
dludwig@8515
    70
dludwig@8512
    71
#ifdef __cplusplus_winrt
dludwig@8512
    72
dludwig@8755
    73
/* A convenience macro to get a WinRT display property */
dludwig@8755
    74
#if NTDDI_VERSION > NTDDI_WIN8
dludwig@8755
    75
#define WINRT_DISPLAY_PROPERTY(NAME) (Windows::Graphics::Display::DisplayInformation::GetForCurrentView()->NAME)
dludwig@8755
    76
#else
dludwig@8755
    77
#define WINRT_DISPLAY_PROPERTY(NAME) (Windows::Graphics::Display::DisplayProperties::NAME)
dludwig@8755
    78
#endif
dludwig@8755
    79
dludwig@8512
    80
/* Internal window data */
slouken@8582
    81
struct SDL_WindowData
slouken@8582
    82
{
slouken@8582
    83
    SDL_Window *sdlWindow;
slouken@8582
    84
    Platform::Agile<Windows::UI::Core::CoreWindow> coreWindow;
slouken@8582
    85
#ifdef SDL_VIDEO_OPENGL_EGL
slouken@8582
    86
    EGLSurface egl_surface;
slouken@8582
    87
#endif
dludwig@8512
    88
};
dludwig@8512
    89
dludwig@8512
    90
#endif // ifdef __cplusplus_winrt