2015-06-21 17:33:46 +02:00
|
|
|
/*
|
|
|
|
|
Simple DirectMedia Layer
|
2024-01-01 13:15:26 -08:00
|
|
|
Copyright (C) 1997-2024 Sam Lantinga <slouken@libsdl.org>
|
2015-06-21 17:33:46 +02:00
|
|
|
|
|
|
|
|
This software is provided 'as-is', without any express or implied
|
|
|
|
|
warranty. In no event will the authors be held liable for any damages
|
|
|
|
|
arising from the use of this software.
|
|
|
|
|
|
|
|
|
|
Permission is granted to anyone to use this software for any purpose,
|
|
|
|
|
including commercial applications, and to alter it and redistribute it
|
|
|
|
|
freely, subject to the following restrictions:
|
|
|
|
|
|
|
|
|
|
1. The origin of this software must not be misrepresented; you must not
|
|
|
|
|
claim that you wrote the original software. If you use this software
|
|
|
|
|
in a product, an acknowledgment in the product documentation would be
|
|
|
|
|
appreciated but is not required.
|
|
|
|
|
2. Altered source versions must be plainly marked as such, and must not be
|
|
|
|
|
misrepresented as being the original software.
|
|
|
|
|
3. This notice may not be removed or altered from any source distribution.
|
|
|
|
|
*/
|
2022-11-29 18:34:15 -08:00
|
|
|
#include "SDL_internal.h"
|
2015-06-21 17:33:46 +02:00
|
|
|
|
2023-03-29 21:49:01 +00:00
|
|
|
#ifdef SDL_VIDEO_DRIVER_ANDROID
|
2015-06-21 17:33:46 +02:00
|
|
|
|
|
|
|
|
#include "../SDL_sysvideo.h"
|
|
|
|
|
#include "../../events/SDL_keyboard_c.h"
|
|
|
|
|
#include "../../events/SDL_mouse_c.h"
|
2018-06-12 13:22:58 -07:00
|
|
|
#include "../../events/SDL_windowevents_c.h"
|
2018-09-28 20:39:57 -07:00
|
|
|
#include "../../core/android/SDL_android.h"
|
2015-06-21 17:33:46 +02:00
|
|
|
|
|
|
|
|
#include "SDL_androidvideo.h"
|
|
|
|
|
#include "SDL_androidwindow.h"
|
|
|
|
|
|
2022-11-23 13:33:48 -08:00
|
|
|
|
2019-01-03 13:14:16 +01:00
|
|
|
/* Currently only one window */
|
|
|
|
|
SDL_Window *Android_Window = NULL;
|
|
|
|
|
|
2023-11-13 11:29:30 -08:00
|
|
|
int Android_CreateWindow(SDL_VideoDevice *_this, SDL_Window *window, SDL_PropertiesID create_props)
|
2015-06-21 17:33:46 +02:00
|
|
|
{
|
|
|
|
|
SDL_WindowData *data;
|
2019-01-03 13:38:33 +01:00
|
|
|
int retval = 0;
|
2019-01-03 14:18:06 +01:00
|
|
|
|
2019-06-28 16:38:42 +02:00
|
|
|
Android_ActivityMutex_Lock_Running();
|
2019-01-03 14:18:06 +01:00
|
|
|
|
2015-06-21 17:33:46 +02:00
|
|
|
if (Android_Window) {
|
2019-01-03 13:38:33 +01:00
|
|
|
retval = SDL_SetError("Android only supports one window");
|
|
|
|
|
goto endfunction;
|
2015-06-21 17:33:46 +02:00
|
|
|
}
|
2019-01-03 14:18:06 +01:00
|
|
|
|
2017-08-13 20:55:59 -07:00
|
|
|
/* Set orientation */
|
|
|
|
|
Android_JNI_SetOrientation(window->w, window->h, window->flags & SDL_WINDOW_RESIZABLE, SDL_GetHint(SDL_HINT_ORIENTATIONS));
|
|
|
|
|
|
2015-06-21 17:33:46 +02:00
|
|
|
/* Adjust the window data to match the screen */
|
|
|
|
|
window->x = 0;
|
|
|
|
|
window->y = 0;
|
2023-05-16 16:29:52 -07:00
|
|
|
window->w = Android_SurfaceWidth;
|
|
|
|
|
window->h = Android_SurfaceHeight;
|
2015-06-21 17:33:46 +02:00
|
|
|
|
|
|
|
|
/* One window, it always has focus */
|
|
|
|
|
SDL_SetMouseFocus(window);
|
|
|
|
|
SDL_SetKeyboardFocus(window);
|
2019-01-03 14:18:06 +01:00
|
|
|
|
2022-11-30 12:51:59 -08:00
|
|
|
data = (SDL_WindowData *)SDL_calloc(1, sizeof(*data));
|
2023-11-09 22:29:15 +01:00
|
|
|
if (!data) {
|
error: SDL's allocators now call SDL_OutOfMemory on error.
This means the allocator's caller doesn't need to use SDL_OutOfMemory directly
if the allocation fails.
This applies to the usual allocators: SDL_malloc, SDL_calloc, SDL_realloc
(all of these regardless of if the app supplied a custom allocator or we're
using system malloc() or an internal copy of dlmalloc under the hood),
SDL_aligned_alloc, SDL_small_alloc, SDL_strdup, SDL_asprintf, SDL_wcsdup...
probably others. If it returns something you can pass to SDL_free, it should
work.
The caller might still need to use SDL_OutOfMemory if something that wasn't
SDL allocated the memory: operator new in C++ code, Objective-C's alloc
message, win32 GlobalAlloc, etc.
Fixes #8642.
2023-11-30 00:14:27 -05:00
|
|
|
retval = -1;
|
2019-01-03 13:38:33 +01:00
|
|
|
goto endfunction;
|
2015-06-21 17:33:46 +02:00
|
|
|
}
|
2019-01-03 14:18:06 +01:00
|
|
|
|
2015-06-21 17:33:46 +02:00
|
|
|
data->native_window = Android_JNI_GetNativeWindow();
|
|
|
|
|
if (!data->native_window) {
|
|
|
|
|
SDL_free(data);
|
2019-01-03 13:38:33 +01:00
|
|
|
retval = SDL_SetError("Could not fetch native window");
|
|
|
|
|
goto endfunction;
|
2015-06-21 17:33:46 +02:00
|
|
|
}
|
2024-01-27 13:00:37 -08:00
|
|
|
SDL_SetProperty(SDL_GetWindowProperties(window), SDL_PROP_WINDOW_ANDROID_WINDOW_POINTER, data->native_window);
|
2015-06-21 17:33:46 +02:00
|
|
|
|
2017-05-16 06:30:39 -07:00
|
|
|
/* Do not create EGLSurface for Vulkan window since it will then make the window
|
|
|
|
|
incompatible with vkCreateAndroidSurfaceKHR */
|
2023-03-29 21:49:01 +00:00
|
|
|
#ifdef SDL_VIDEO_OPENGL_EGL
|
2023-02-03 22:08:42 +01:00
|
|
|
if (window->flags & SDL_WINDOW_OPENGL) {
|
2023-03-11 13:53:14 +01:00
|
|
|
data->egl_surface = SDL_EGL_CreateSurface(_this, window, (NativeWindowType)data->native_window);
|
2017-05-16 06:30:39 -07:00
|
|
|
|
|
|
|
|
if (data->egl_surface == EGL_NO_SURFACE) {
|
|
|
|
|
ANativeWindow_release(data->native_window);
|
|
|
|
|
SDL_free(data);
|
2019-01-03 16:22:33 +01:00
|
|
|
retval = -1;
|
2019-01-03 13:38:33 +01:00
|
|
|
goto endfunction;
|
2017-05-16 06:30:39 -07:00
|
|
|
}
|
2015-06-21 17:33:46 +02:00
|
|
|
}
|
2024-01-27 13:00:37 -08:00
|
|
|
SDL_SetProperty(SDL_GetWindowProperties(window), SDL_PROP_WINDOW_ANDROID_SURFACE_POINTER, data->egl_surface);
|
2022-03-11 15:14:51 +01:00
|
|
|
#endif
|
2015-06-21 17:33:46 +02:00
|
|
|
|
|
|
|
|
window->driverdata = data;
|
|
|
|
|
Android_Window = window;
|
2019-01-03 13:38:33 +01:00
|
|
|
|
|
|
|
|
endfunction:
|
2019-01-03 14:18:06 +01:00
|
|
|
|
2019-01-03 20:18:29 +01:00
|
|
|
SDL_UnlockMutex(Android_ActivityMutex);
|
2019-01-03 14:18:06 +01:00
|
|
|
|
2019-01-03 13:38:33 +01:00
|
|
|
return retval;
|
2015-06-21 17:33:46 +02:00
|
|
|
}
|
|
|
|
|
|
2023-05-09 12:55:11 +02:00
|
|
|
void Android_SetWindowTitle(SDL_VideoDevice *_this, SDL_Window *window)
|
2015-06-21 17:33:46 +02:00
|
|
|
{
|
|
|
|
|
Android_JNI_SetActivityTitle(window->title);
|
|
|
|
|
}
|
|
|
|
|
|
video: Implement asynchronous windowing
SDL window size, state, and position functions have been considered immediate, with their effects assuming to have taken effect upon successful return of the function. However, several windowing systems handle these requests asynchronously, resulting in the functions blocking until the changes have taken effect, potentially for long periods of time. Additionally, some windowing systems treat these as requests, and can potentially deny or fulfill the request in a manner differently than the application expects, such as not allowing a window to be positioned or sized beyond desktop borders, prohibiting fullscreen, and so on.
With these changes, applications can make requests of the window manager that do not block, with the understanding that an associated event will be sent if the request is fulfilled. Currently, size, position, maximize, minimize, and fullscreen calls are handled as asynchronous requests, with events being returned if the request is honored. If the application requires that the change take effect immediately, it can call the new SDL_SyncWindow function, which will attempt to block until the request is fulfilled, or some arbitrary timeout period elapses, the duration of which depends not only on the windowing system, but on the operation requested as well (e.g. a 100ms timeout is fine for most X11 events, but maximizing a window can take considerably longer for some reason). There is also a new hint 'SDL_VIDEO_SYNC_ALL_WINDOW_OPS' that will mimic the old behavior by synchronizing after every window operation with, again, the understanding that using this may result in the associated calls blocking for a relatively long period.
The deferred model also results in the window size and position getters not reporting false coordinates anymore, as they only forward what the window manager reports vs allowing applications to set arbitrary values, and fullscreen enter/leave events that were initiated via the window manager update the window state appropriately, where they didn't before.
Care was taken to ensure that order of operations is maintained, and that requests are not ignored or dropped. This does require some implicit internal synchronization in the various backends if many requests are made in a short period, as some state and behavior depends on other bits of state that need to be known at that particular point in time, but this isn't something that typical applications will hit, unless they are sending a lot of window state in a short time as the tests do.
The automated tests developed to test the previous behavior also resulted in previously undefined behavior being defined and normalized across platforms, particularly when it comes to the sizing and positioning of windows when they are in a fixed-size state, such as maximized or fullscreen. Size and position requests made when the window is not in a movable or resizable state will be deferred until it can be applied, so no requests are lost. These changes fix another long-standing issue with renderers recreating maximized windows, where the original non-maximized size was lost, resulting in the window being restored to the wrong size. All automated video tests pass across all platforms.
Overall, the "make a request/get an event" model better reflects how most windowing systems work, and some backends avoid spending significant time blocking while waiting for operations to complete.
2023-10-25 15:09:55 -04:00
|
|
|
int Android_SetWindowFullscreen(SDL_VideoDevice *_this, SDL_Window *window, SDL_VideoDisplay *display, SDL_bool fullscreen)
|
2018-02-11 18:23:37 -08:00
|
|
|
{
|
2019-01-09 15:18:41 +01:00
|
|
|
SDL_LockMutex(Android_ActivityMutex);
|
2018-10-08 12:49:25 -07:00
|
|
|
|
2019-01-09 15:18:41 +01:00
|
|
|
if (window == Android_Window) {
|
2022-05-30 12:02:08 -07:00
|
|
|
SDL_WindowData *data;
|
|
|
|
|
int old_w, old_h, new_w, new_h;
|
2018-09-28 20:39:57 -07:00
|
|
|
|
2019-01-09 15:18:41 +01:00
|
|
|
/* If the window is being destroyed don't change visible state */
|
|
|
|
|
if (!window->is_destroying) {
|
|
|
|
|
Android_JNI_SetWindowStyle(fullscreen);
|
|
|
|
|
}
|
2018-06-12 13:22:58 -07:00
|
|
|
|
2019-01-09 15:18:41 +01:00
|
|
|
/* Ensure our size matches reality after we've executed the window style change.
|
|
|
|
|
*
|
|
|
|
|
* It is possible that we've set width and height to the full-size display, but on
|
|
|
|
|
* Samsung DeX or Chromebooks or other windowed Android environemtns, our window may
|
|
|
|
|
* still not be the full display size.
|
|
|
|
|
*/
|
|
|
|
|
if (!SDL_IsDeXMode() && !SDL_IsChromebook()) {
|
|
|
|
|
goto endfunction;
|
|
|
|
|
}
|
2018-06-12 13:22:58 -07:00
|
|
|
|
2023-01-29 13:30:55 -08:00
|
|
|
data = window->driverdata;
|
2023-11-09 22:29:15 +01:00
|
|
|
if (!data || !data->native_window) {
|
2019-01-09 22:49:49 +01:00
|
|
|
if (data && !data->native_window) {
|
|
|
|
|
SDL_SetError("Missing native window");
|
|
|
|
|
}
|
2019-01-09 15:18:41 +01:00
|
|
|
goto endfunction;
|
|
|
|
|
}
|
|
|
|
|
|
2022-05-30 12:02:08 -07:00
|
|
|
old_w = window->w;
|
|
|
|
|
old_h = window->h;
|
2018-06-12 13:22:58 -07:00
|
|
|
|
2023-05-16 16:29:52 -07:00
|
|
|
new_w = ANativeWindow_getWidth(data->native_window);
|
|
|
|
|
new_h = ANativeWindow_getHeight(data->native_window);
|
2019-01-09 15:18:41 +01:00
|
|
|
|
2019-01-09 22:49:49 +01:00
|
|
|
if (new_w < 0 || new_h < 0) {
|
|
|
|
|
SDL_SetError("ANativeWindow_getWidth/Height() fails");
|
|
|
|
|
}
|
|
|
|
|
|
2019-01-09 15:18:41 +01:00
|
|
|
if (old_w != new_w || old_h != new_h) {
|
2023-01-23 17:54:09 -08:00
|
|
|
SDL_SendWindowEvent(window, SDL_EVENT_WINDOW_RESIZED, new_w, new_h);
|
2019-01-09 15:18:41 +01:00
|
|
|
}
|
2018-06-12 13:22:58 -07:00
|
|
|
}
|
2019-01-09 15:18:41 +01:00
|
|
|
|
|
|
|
|
endfunction:
|
|
|
|
|
|
|
|
|
|
SDL_UnlockMutex(Android_ActivityMutex);
|
video: Implement asynchronous windowing
SDL window size, state, and position functions have been considered immediate, with their effects assuming to have taken effect upon successful return of the function. However, several windowing systems handle these requests asynchronously, resulting in the functions blocking until the changes have taken effect, potentially for long periods of time. Additionally, some windowing systems treat these as requests, and can potentially deny or fulfill the request in a manner differently than the application expects, such as not allowing a window to be positioned or sized beyond desktop borders, prohibiting fullscreen, and so on.
With these changes, applications can make requests of the window manager that do not block, with the understanding that an associated event will be sent if the request is fulfilled. Currently, size, position, maximize, minimize, and fullscreen calls are handled as asynchronous requests, with events being returned if the request is honored. If the application requires that the change take effect immediately, it can call the new SDL_SyncWindow function, which will attempt to block until the request is fulfilled, or some arbitrary timeout period elapses, the duration of which depends not only on the windowing system, but on the operation requested as well (e.g. a 100ms timeout is fine for most X11 events, but maximizing a window can take considerably longer for some reason). There is also a new hint 'SDL_VIDEO_SYNC_ALL_WINDOW_OPS' that will mimic the old behavior by synchronizing after every window operation with, again, the understanding that using this may result in the associated calls blocking for a relatively long period.
The deferred model also results in the window size and position getters not reporting false coordinates anymore, as they only forward what the window manager reports vs allowing applications to set arbitrary values, and fullscreen enter/leave events that were initiated via the window manager update the window state appropriately, where they didn't before.
Care was taken to ensure that order of operations is maintained, and that requests are not ignored or dropped. This does require some implicit internal synchronization in the various backends if many requests are made in a short period, as some state and behavior depends on other bits of state that need to be known at that particular point in time, but this isn't something that typical applications will hit, unless they are sending a lot of window state in a short time as the tests do.
The automated tests developed to test the previous behavior also resulted in previously undefined behavior being defined and normalized across platforms, particularly when it comes to the sizing and positioning of windows when they are in a fixed-size state, such as maximized or fullscreen. Size and position requests made when the window is not in a movable or resizable state will be deferred until it can be applied, so no requests are lost. These changes fix another long-standing issue with renderers recreating maximized windows, where the original non-maximized size was lost, resulting in the window being restored to the wrong size. All automated video tests pass across all platforms.
Overall, the "make a request/get an event" model better reflects how most windowing systems work, and some backends avoid spending significant time blocking while waiting for operations to complete.
2023-10-25 15:09:55 -04:00
|
|
|
return 0;
|
2018-02-11 18:23:37 -08:00
|
|
|
}
|
|
|
|
|
|
2023-05-09 12:55:11 +02:00
|
|
|
void Android_MinimizeWindow(SDL_VideoDevice *_this, SDL_Window *window)
|
2019-06-10 21:58:03 +02:00
|
|
|
{
|
|
|
|
|
Android_JNI_MinizeWindow();
|
|
|
|
|
}
|
|
|
|
|
|
2023-05-09 12:55:11 +02:00
|
|
|
void Android_SetWindowResizable(SDL_VideoDevice *_this, SDL_Window *window, SDL_bool resizable)
|
2022-03-23 10:13:56 +01:00
|
|
|
{
|
|
|
|
|
/* Set orientation */
|
|
|
|
|
Android_JNI_SetOrientation(window->w, window->h, window->flags & SDL_WINDOW_RESIZABLE, SDL_GetHint(SDL_HINT_ORIENTATIONS));
|
|
|
|
|
}
|
|
|
|
|
|
2023-05-09 12:55:11 +02:00
|
|
|
void Android_DestroyWindow(SDL_VideoDevice *_this, SDL_Window *window)
|
2019-01-03 14:18:06 +01:00
|
|
|
{
|
2019-01-03 20:18:29 +01:00
|
|
|
SDL_LockMutex(Android_ActivityMutex);
|
2019-01-03 14:18:06 +01:00
|
|
|
|
2015-06-21 17:33:46 +02:00
|
|
|
if (window == Android_Window) {
|
|
|
|
|
Android_Window = NULL;
|
2019-01-03 14:18:06 +01:00
|
|
|
|
2019-01-03 13:38:33 +01:00
|
|
|
if (window->driverdata) {
|
2023-01-29 13:30:55 -08:00
|
|
|
SDL_WindowData *data = window->driverdata;
|
2022-03-11 15:14:51 +01:00
|
|
|
|
2023-03-29 21:49:01 +00:00
|
|
|
#ifdef SDL_VIDEO_OPENGL_EGL
|
2015-06-21 17:33:46 +02:00
|
|
|
if (data->egl_surface != EGL_NO_SURFACE) {
|
|
|
|
|
SDL_EGL_DestroySurface(_this, data->egl_surface);
|
|
|
|
|
}
|
2022-03-11 15:14:51 +01:00
|
|
|
#endif
|
|
|
|
|
|
2015-06-21 17:33:46 +02:00
|
|
|
if (data->native_window) {
|
|
|
|
|
ANativeWindow_release(data->native_window);
|
|
|
|
|
}
|
|
|
|
|
SDL_free(window->driverdata);
|
|
|
|
|
window->driverdata = NULL;
|
|
|
|
|
}
|
|
|
|
|
}
|
2019-01-03 14:18:06 +01:00
|
|
|
|
2019-01-03 20:18:29 +01:00
|
|
|
SDL_UnlockMutex(Android_ActivityMutex);
|
2015-06-21 17:33:46 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
#endif /* SDL_VIDEO_DRIVER_ANDROID */
|