SDL  2.0
SDL_androidvideo.c
Go to the documentation of this file.
1 /*
2  Simple DirectMedia Layer
3  Copyright (C) 1997-2018 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 #if SDL_VIDEO_DRIVER_ANDROID
24 
25 /* Android SDL video driver implementation
26 */
27 
28 #include "SDL_video.h"
29 #include "SDL_mouse.h"
30 #include "../SDL_sysvideo.h"
31 #include "../SDL_pixels_c.h"
32 #include "../../events/SDL_events_c.h"
33 #include "../../events/SDL_windowevents_c.h"
34 
35 #include "SDL_androidvideo.h"
36 #include "SDL_androidgl.h"
37 #include "SDL_androidclipboard.h"
38 #include "SDL_androidevents.h"
39 #include "SDL_androidkeyboard.h"
40 #include "SDL_androidmouse.h"
41 #include "SDL_androidtouch.h"
42 #include "SDL_androidwindow.h"
43 #include "SDL_androidvulkan.h"
44 
45 #define ANDROID_VID_DRIVER_NAME "Android"
46 
47 /* Initialization/Query functions */
48 static int Android_VideoInit(_THIS);
49 static void Android_VideoQuit(_THIS);
50 int Android_GetDisplayDPI(_THIS, SDL_VideoDisplay * display, float * ddpi, float * hdpi, float * vdpi);
51 
52 #include "../SDL_egl_c.h"
53 #define Android_GLES_GetProcAddress SDL_EGL_GetProcAddress
54 #define Android_GLES_UnloadLibrary SDL_EGL_UnloadLibrary
55 #define Android_GLES_SetSwapInterval SDL_EGL_SetSwapInterval
56 #define Android_GLES_GetSwapInterval SDL_EGL_GetSwapInterval
57 #define Android_GLES_DeleteContext SDL_EGL_DeleteContext
58 
59 /* Android driver bootstrap functions */
60 
61 
62 /* These are filled in with real values in Android_SetScreenResolution on init (before SDL_main()) */
63 int Android_SurfaceWidth = 0;
64 int Android_SurfaceHeight = 0;
65 int Android_DeviceWidth = 0;
66 int Android_DeviceHeight = 0;
68 static int Android_ScreenRate = 0;
69 
71 
72 /* Currently only one window */
74 
75 static int
76 Android_Available(void)
77 {
78  return 1;
79 }
80 
81 static void
82 Android_SuspendScreenSaver(_THIS)
83 {
85 }
86 
87 static void
88 Android_DeleteDevice(SDL_VideoDevice * device)
89 {
90  SDL_free(device->driverdata);
92 }
93 
94 static SDL_VideoDevice *
95 Android_CreateDevice(int devindex)
96 {
99 
100  /* Initialize all variables that we clean on shutdown */
102  if (!device) {
103  SDL_OutOfMemory();
104  return NULL;
105  }
106 
107  data = (SDL_VideoData*) SDL_calloc(1, sizeof(SDL_VideoData));
108  if (!data) {
109  SDL_OutOfMemory();
110  SDL_free(device);
111  return NULL;
112  }
113 
114  device->driverdata = data;
115 
116  /* Set the function pointers */
117  device->VideoInit = Android_VideoInit;
118  device->VideoQuit = Android_VideoQuit;
119  device->PumpEvents = Android_PumpEvents;
120 
121  device->GetDisplayDPI = Android_GetDisplayDPI;
122 
123  device->CreateSDLWindow = Android_CreateWindow;
124  device->SetWindowTitle = Android_SetWindowTitle;
125  device->SetWindowFullscreen = Android_SetWindowFullscreen;
126  device->DestroyWindow = Android_DestroyWindow;
127  device->GetWindowWMInfo = Android_GetWindowWMInfo;
128 
129  device->free = Android_DeleteDevice;
130 
131  /* GL pointers */
132  device->GL_LoadLibrary = Android_GLES_LoadLibrary;
133  device->GL_GetProcAddress = Android_GLES_GetProcAddress;
134  device->GL_UnloadLibrary = Android_GLES_UnloadLibrary;
135  device->GL_CreateContext = Android_GLES_CreateContext;
136  device->GL_MakeCurrent = Android_GLES_MakeCurrent;
137  device->GL_SetSwapInterval = Android_GLES_SetSwapInterval;
138  device->GL_GetSwapInterval = Android_GLES_GetSwapInterval;
139  device->GL_SwapWindow = Android_GLES_SwapWindow;
140  device->GL_DeleteContext = Android_GLES_DeleteContext;
141 
142 #if SDL_VIDEO_VULKAN
143  device->Vulkan_LoadLibrary = Android_Vulkan_LoadLibrary;
144  device->Vulkan_UnloadLibrary = Android_Vulkan_UnloadLibrary;
145  device->Vulkan_GetInstanceExtensions = Android_Vulkan_GetInstanceExtensions;
146  device->Vulkan_CreateSurface = Android_Vulkan_CreateSurface;
147 #endif
148 
149  /* Screensaver */
150  device->SuspendScreenSaver = Android_SuspendScreenSaver;
151 
152  /* Text input */
153  device->StartTextInput = Android_StartTextInput;
154  device->StopTextInput = Android_StopTextInput;
155  device->SetTextInputRect = Android_SetTextInputRect;
156 
157  /* Screen keyboard */
158  device->HasScreenKeyboardSupport = Android_HasScreenKeyboardSupport;
159  device->IsScreenKeyboardShown = Android_IsScreenKeyboardShown;
160 
161  /* Clipboard */
162  device->SetClipboardText = Android_SetClipboardText;
163  device->GetClipboardText = Android_GetClipboardText;
164  device->HasClipboardText = Android_HasClipboardText;
165 
166  return device;
167 }
168 
170  ANDROID_VID_DRIVER_NAME, "SDL Android video driver",
171  Android_Available, Android_CreateDevice
172 };
173 
174 
175 int
176 Android_VideoInit(_THIS)
177 {
179 
180  mode.format = Android_ScreenFormat;
183  mode.refresh_rate = Android_ScreenRate;
184  mode.driverdata = NULL;
185  if (SDL_AddBasicVideoDisplay(&mode) < 0) {
186  return -1;
187  }
188 
190 
192 
194 
196 
197  /* We're done! */
198  return 0;
199 }
200 
201 void
202 Android_VideoQuit(_THIS)
203 {
206 }
207 
208 int
209 Android_GetDisplayDPI(_THIS, SDL_VideoDisplay * display, float * ddpi, float * hdpi, float * vdpi)
210 {
211  return Android_JNI_GetDisplayDPI(ddpi, hdpi, vdpi);
212 }
213 
214 void
215 Android_SetScreenResolution(int surfaceWidth, int surfaceHeight, int deviceWidth, int deviceHeight, Uint32 format, float rate)
216 {
218  SDL_VideoDisplay *display;
219  Android_SurfaceWidth = surfaceWidth;
220  Android_SurfaceHeight = surfaceHeight;
221  Android_DeviceWidth = deviceWidth;
222  Android_DeviceHeight = deviceHeight;
224  Android_ScreenRate = rate;
225 
226  /*
227  Update the resolution of the desktop mode, so that the window
228  can be properly resized. The screen resolution change can for
229  example happen when the Activity enters or exits immersive mode,
230  which can happen after VideoInit().
231  */
233  if (device && device->num_displays > 0)
234  {
235  display = &device->displays[0];
239  display->desktop_mode.refresh_rate = Android_ScreenRate;
240  }
241 
242  if (Android_Window) {
243  /* Force the current mode to match the resize otherwise the SDL_WINDOWEVENT_RESTORED event
244  * will fall back to the old mode */
246 
247  display->display_modes[0].format = format;
248  display->display_modes[0].w = Android_DeviceWidth;
249  display->display_modes[0].h = Android_DeviceHeight;
250  display->display_modes[0].refresh_rate = rate;
251  display->current_mode = display->display_modes[0];
252 
253  SDL_SendWindowEvent(Android_Window, SDL_WINDOWEVENT_RESIZED, surfaceWidth, surfaceHeight);
254  }
255 }
256 
257 #endif /* SDL_VIDEO_DRIVER_ANDROID */
258 
259 /* vi: set ts=4 sw=4 expandtab: */
Android_PumpEvents
void Android_PumpEvents(_THIS)
format
GLint GLint GLsizei GLsizei GLsizei GLint GLenum format
Definition: SDL_opengl.h:1572
SDL_VideoDisplay::display_modes
SDL_DisplayMode * display_modes
Definition: SDL_sysvideo.h:130
Android_InitKeyboard
void Android_InitKeyboard(void)
SDL_DisplayMode::format
Uint32 format
Definition: SDL_video.h:55
SDL_androidmouse.h
SDL_androidevents.h
SDL_mouse.h
NULL
#define NULL
Definition: begin_code.h:164
mode
GLenum mode
Definition: SDL_opengl_glext.h:1122
Android_GetClipboardText
char * Android_GetClipboardText(_THIS)
Android_GLES_MakeCurrent
int Android_GLES_MakeCurrent(_THIS, SDL_Window *window, SDL_GLContext context)
SDL_GetDisplayForWindow
SDL_VideoDisplay * SDL_GetDisplayForWindow(SDL_Window *window)
Definition: SDL_video.c:1092
Android_GLES_SwapWindow
int Android_GLES_SwapWindow(_THIS, SDL_Window *window)
SDL_androidvideo.h
SDL_WINDOWEVENT_RESIZED
@ SDL_WINDOWEVENT_RESIZED
Definition: SDL_video.h:155
SDL_androidvulkan.h
Android_DeviceHeight
int Android_DeviceHeight
Uint32
uint32_t Uint32
Definition: SDL_stdinc.h:203
SDL_VideoDisplay::desktop_mode
SDL_DisplayMode desktop_mode
Definition: SDL_sysvideo.h:131
Android_bootstrap
VideoBootStrap Android_bootstrap
Android_InitMouse
void Android_InitMouse(void)
Android_SetWindowTitle
void Android_SetWindowTitle(_THIS, SDL_Window *window)
SDL_DisplayMode::h
int h
Definition: SDL_video.h:57
data
GLint GLenum GLsizei GLsizei GLsizei GLint GLsizei const GLvoid * data
Definition: SDL_opengl.h:1974
Android_ScreenFormat
Uint32 Android_ScreenFormat
SDL_Window
The type used to identify a window.
Definition: SDL_sysvideo.h:74
SDL_DisplayMode
The structure that defines a display mode.
Definition: SDL_video.h:54
SDL_AddDisplayMode
SDL_bool SDL_AddDisplayMode(SDL_VideoDisplay *display, const SDL_DisplayMode *mode)
Definition: SDL_video.c:754
Android_DestroyWindow
void Android_DestroyWindow(_THIS, SDL_Window *window)
Android_SurfaceHeight
int Android_SurfaceHeight
SDL_androidwindow.h
_this
static SDL_VideoDevice * _this
Definition: SDL_video.c:121
SDL_free
#define SDL_free
Definition: SDL_dynapi_overrides.h:377
Android_SetTextInputRect
void Android_SetTextInputRect(_THIS, SDL_Rect *rect)
SDL_DisplayMode::refresh_rate
int refresh_rate
Definition: SDL_video.h:58
SDL_VideoDevice::displays
SDL_VideoDisplay * displays
Definition: SDL_sysvideo.h:316
Android_SetWindowFullscreen
void Android_SetWindowFullscreen(_THIS, SDL_Window *window, SDL_VideoDisplay *display, SDL_bool fullscreen)
Android_HasScreenKeyboardSupport
SDL_bool Android_HasScreenKeyboardSupport(_THIS)
Android_StopTextInput
void Android_StopTextInput(_THIS)
_THIS
#define _THIS
Definition: SDL_alsa_audio.h:31
SDL_PIXELFORMAT_UNKNOWN
@ SDL_PIXELFORMAT_UNKNOWN
Definition: SDL_pixels.h:173
Android_SurfaceWidth
int Android_SurfaceWidth
SDL_DisplayMode::w
int w
Definition: SDL_video.h:56
Android_QuitTouch
void Android_QuitTouch(void)
Android_PauseSem
SDL_sem * Android_PauseSem
SDL_VideoDevice
Definition: SDL_sysvideo.h:149
Android_GLES_CreateContext
SDL_GLContext Android_GLES_CreateContext(_THIS, SDL_Window *window)
Android_CreateWindow
int Android_CreateWindow(_THIS, SDL_Window *window)
SDL_OutOfMemory
#define SDL_OutOfMemory()
Definition: SDL_error.h:52
Android_DeviceWidth
int Android_DeviceWidth
SDL_androidtouch.h
Android_SetScreenResolution
void Android_SetScreenResolution(int surfaceWidth, int surfaceHeight, int deviceWidth, int deviceHeight, Uint32 format, float rate)
SDL_calloc
#define SDL_calloc
Definition: SDL_dynapi_overrides.h:375
SDL_AddBasicVideoDisplay
int SDL_AddBasicVideoDisplay(const SDL_DisplayMode *desktop_mode)
Definition: SDL_video.c:592
Android_JNI_SuspendScreenSaver
void Android_JNI_SuspendScreenSaver(SDL_bool suspend)
SDL_VideoDisplay
Definition: SDL_sysvideo.h:126
Android_GetWindowWMInfo
SDL_bool Android_GetWindowWMInfo(_THIS, SDL_Window *window, struct SDL_SysWMinfo *info)
SDL_SendWindowEvent
int SDL_SendWindowEvent(SDL_Window *window, Uint8 windowevent, int data1, int data2)
Definition: SDL_windowevents.c:74
SDL_androidclipboard.h
Android_InitTouch
void Android_InitTouch(void)
Android_SetClipboardText
int Android_SetClipboardText(_THIS, const char *text)
SDL_androidkeyboard.h
SDL_video.h
SDL_GetVideoDevice
SDL_VideoDevice * SDL_GetVideoDevice(void)
Definition: SDL_video.c:586
Android_GLES_LoadLibrary
int Android_GLES_LoadLibrary(_THIS, const char *path)
SDL_VideoDisplay::current_mode
SDL_DisplayMode current_mode
Definition: SDL_sysvideo.h:132
SDL_androidgl.h
Android_StartTextInput
void Android_StartTextInput(_THIS)
VideoBootStrap
Definition: SDL_sysvideo.h:398
device
static SDL_AudioDeviceID device
Definition: loopwave.c:37
Android_QuitMouse
void Android_QuitMouse(void)
Android_Window
SDL_Window * Android_Window
SDL_VideoDevice::suspend_screensaver
SDL_bool suspend_screensaver
Definition: SDL_sysvideo.h:314
Android_IsScreenKeyboardShown
SDL_bool Android_IsScreenKeyboardShown(_THIS, SDL_Window *window)
Android_JNI_GetDisplayDPI
int Android_JNI_GetDisplayDPI(float *ddpi, float *xdpi, float *ydpi)
SDL_VideoData
Definition: SDL_androidvideo.h:36
Android_HasClipboardText
SDL_bool Android_HasClipboardText(_THIS)
Android_ResumeSem
SDL_sem * Android_ResumeSem
Definition: SDL_androidvideo.h:45