mirror of https://github.com/libsdl-org/SDL.git
614 lines
24 KiB
C
614 lines
24 KiB
C
/*
|
|
Simple DirectMedia Layer
|
|
Copyright (C) 1997-2025 Sam Lantinga <slouken@libsdl.org>
|
|
|
|
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.
|
|
*/
|
|
#include "SDL_internal.h"
|
|
|
|
#ifndef SDL_sysvideo_h_
|
|
#define SDL_sysvideo_h_
|
|
|
|
#include <SDL3/SDL_vulkan.h>
|
|
|
|
#include "SDL_surface_c.h"
|
|
|
|
// The SDL video driver
|
|
|
|
typedef struct SDL_VideoDisplay SDL_VideoDisplay;
|
|
typedef struct SDL_VideoDevice SDL_VideoDevice;
|
|
typedef struct SDL_VideoData SDL_VideoData;
|
|
typedef struct SDL_DisplayData SDL_DisplayData;
|
|
typedef struct SDL_WindowData SDL_WindowData;
|
|
|
|
typedef struct
|
|
{
|
|
float SDR_white_level;
|
|
float HDR_headroom;
|
|
} SDL_HDROutputProperties;
|
|
|
|
// Define the SDL window structure, corresponding to toplevel windows
|
|
struct SDL_Window
|
|
{
|
|
SDL_WindowID id;
|
|
char *title;
|
|
SDL_Surface *icon;
|
|
int x, y;
|
|
int w, h;
|
|
int min_w, min_h;
|
|
int max_w, max_h;
|
|
float min_aspect;
|
|
float max_aspect;
|
|
int last_pixel_w, last_pixel_h;
|
|
SDL_WindowFlags flags;
|
|
SDL_WindowFlags pending_flags;
|
|
float display_scale;
|
|
bool external_graphics_context;
|
|
bool fullscreen_exclusive; // The window is currently fullscreen exclusive
|
|
SDL_DisplayID last_fullscreen_exclusive_display; // The last fullscreen_exclusive display
|
|
SDL_DisplayID last_displayID;
|
|
|
|
/* Stored position and size for the window in the non-fullscreen state,
|
|
* including when the window is maximized or tiled.
|
|
*
|
|
* This is the size and position to which the window should return when
|
|
* leaving the fullscreen state.
|
|
*/
|
|
SDL_Rect windowed;
|
|
|
|
/* Stored position and size for the window in the base 'floating' state;
|
|
* when not fullscreen, nor in a state such as maximized or tiled.
|
|
*
|
|
* This is the size and position to which the window should return when
|
|
* it's maximized and SDL_RestoreWindow() is called.
|
|
*/
|
|
SDL_Rect floating;
|
|
|
|
// The last client requested size and position for the window.
|
|
SDL_Rect pending;
|
|
|
|
/* Toggle for drivers to indicate that the current window state is tiled,
|
|
* and sizes set non-programmatically shouldn't be cached.
|
|
*/
|
|
bool tiled;
|
|
|
|
// Whether or not the initial position was defined
|
|
bool undefined_x;
|
|
bool undefined_y;
|
|
|
|
SDL_DisplayMode requested_fullscreen_mode;
|
|
SDL_DisplayMode current_fullscreen_mode;
|
|
SDL_HDROutputProperties HDR;
|
|
|
|
float opacity;
|
|
|
|
SDL_Surface *surface;
|
|
bool surface_valid;
|
|
|
|
bool is_hiding;
|
|
bool restore_on_show; // Child was hidden recursively by the parent, restore when shown.
|
|
bool last_position_pending; // This should NOT be cleared by the backend, as it is used for fullscreen positioning.
|
|
bool last_size_pending; // This should be cleared by the backend if the new size cannot be applied.
|
|
bool update_fullscreen_on_display_changed;
|
|
bool constrain_popup;
|
|
bool is_destroying;
|
|
bool is_dropping; // drag/drop in progress, expecting SDL_SendDropComplete().
|
|
|
|
int safe_inset_left;
|
|
int safe_inset_right;
|
|
int safe_inset_top;
|
|
int safe_inset_bottom;
|
|
SDL_Rect safe_rect;
|
|
|
|
SDL_PropertiesID text_input_props;
|
|
bool text_input_active;
|
|
SDL_Rect text_input_rect;
|
|
int text_input_cursor;
|
|
|
|
SDL_Rect mouse_rect;
|
|
|
|
SDL_HitTest hit_test;
|
|
void *hit_test_data;
|
|
|
|
SDL_ProgressState progress_state;
|
|
float progress_value;
|
|
|
|
SDL_PropertiesID props;
|
|
|
|
int num_renderers;
|
|
SDL_Renderer **renderers;
|
|
|
|
SDL_WindowData *internal;
|
|
|
|
// If a toplevel window, holds the current keyboard focus for grabbing popups.
|
|
SDL_Window *keyboard_focus;
|
|
|
|
SDL_Window *prev;
|
|
SDL_Window *next;
|
|
|
|
SDL_Window *parent;
|
|
SDL_Window *first_child;
|
|
SDL_Window *prev_sibling;
|
|
SDL_Window *next_sibling;
|
|
};
|
|
#define SDL_WINDOW_FULLSCREEN_VISIBLE(W) \
|
|
((((W)->flags & SDL_WINDOW_FULLSCREEN) != 0) && \
|
|
(((W)->flags & SDL_WINDOW_HIDDEN) == 0) && \
|
|
(((W)->flags & SDL_WINDOW_MINIMIZED) == 0))
|
|
|
|
#define SDL_WINDOW_IS_POPUP(W) \
|
|
(((W)->flags & (SDL_WINDOW_TOOLTIP | SDL_WINDOW_POPUP_MENU)) != 0)
|
|
|
|
/*
|
|
* Define the SDL display structure.
|
|
* This corresponds to physical monitors attached to the system.
|
|
*/
|
|
struct SDL_VideoDisplay
|
|
{
|
|
SDL_DisplayID id;
|
|
char *name;
|
|
int max_fullscreen_modes;
|
|
int num_fullscreen_modes;
|
|
SDL_DisplayMode *fullscreen_modes;
|
|
SDL_DisplayMode desktop_mode;
|
|
const SDL_DisplayMode *current_mode;
|
|
SDL_DisplayOrientation natural_orientation;
|
|
SDL_DisplayOrientation current_orientation;
|
|
float content_scale;
|
|
SDL_HDROutputProperties HDR;
|
|
|
|
// This is true if we are fullscreen or fullscreen is pending
|
|
bool fullscreen_active;
|
|
SDL_Window *fullscreen_window;
|
|
|
|
SDL_VideoDevice *device;
|
|
|
|
SDL_PropertiesID props;
|
|
|
|
SDL_DisplayData *internal;
|
|
};
|
|
|
|
// Video device flags
|
|
typedef enum
|
|
{
|
|
VIDEO_DEVICE_CAPS_MODE_SWITCHING_EMULATED = 0x01,
|
|
VIDEO_DEVICE_CAPS_HAS_POPUP_WINDOW_SUPPORT = 0x02,
|
|
VIDEO_DEVICE_CAPS_SENDS_FULLSCREEN_DIMENSIONS = 0x04,
|
|
VIDEO_DEVICE_CAPS_FULLSCREEN_ONLY = 0x08,
|
|
VIDEO_DEVICE_CAPS_SENDS_DISPLAY_CHANGES = 0x10,
|
|
VIDEO_DEVICE_CAPS_DISABLE_MOUSE_WARP_ON_FULLSCREEN_TRANSITIONS = 0x20,
|
|
VIDEO_DEVICE_CAPS_SENDS_HDR_CHANGES = 0x40
|
|
} DeviceCaps;
|
|
|
|
// Fullscreen operations
|
|
typedef enum
|
|
{
|
|
SDL_FULLSCREEN_OP_LEAVE = 0,
|
|
SDL_FULLSCREEN_OP_ENTER,
|
|
SDL_FULLSCREEN_OP_UPDATE
|
|
} SDL_FullscreenOp;
|
|
|
|
typedef enum
|
|
{
|
|
SDL_FULLSCREEN_FAILED,
|
|
SDL_FULLSCREEN_SUCCEEDED,
|
|
SDL_FULLSCREEN_PENDING
|
|
} SDL_FullscreenResult;
|
|
|
|
struct SDL_VideoDevice
|
|
{
|
|
/* * * */
|
|
// The name of this video driver
|
|
const char *name;
|
|
|
|
/* * * */
|
|
// Initialization/Query functions
|
|
|
|
/*
|
|
* Initialize the native video subsystem, filling in the list of
|
|
* displays for this driver, returning 0 or -1 if there's an error.
|
|
*/
|
|
bool (*VideoInit)(SDL_VideoDevice *_this);
|
|
|
|
/*
|
|
* Reverse the effects VideoInit() -- called if VideoInit() fails or
|
|
* if the application is shutting down the video subsystem.
|
|
*/
|
|
void (*VideoQuit)(SDL_VideoDevice *_this);
|
|
|
|
/*
|
|
* Reinitialize the touch devices -- called if an unknown touch ID occurs.
|
|
*/
|
|
void (*ResetTouch)(SDL_VideoDevice *_this);
|
|
|
|
/* * * */
|
|
/*
|
|
* Display functions
|
|
*/
|
|
|
|
/*
|
|
* Refresh the display list
|
|
*/
|
|
void (*RefreshDisplays)(SDL_VideoDevice *_this);
|
|
|
|
/*
|
|
* Get the bounds of a display
|
|
*/
|
|
bool (*GetDisplayBounds)(SDL_VideoDevice *_this, SDL_VideoDisplay *display, SDL_Rect *rect);
|
|
|
|
/*
|
|
* Get the usable bounds of a display (bounds minus menubar or whatever)
|
|
*/
|
|
bool (*GetDisplayUsableBounds)(SDL_VideoDevice *_this, SDL_VideoDisplay *display, SDL_Rect *rect);
|
|
|
|
/*
|
|
* Get a list of the available display modes for a display.
|
|
*/
|
|
bool (*GetDisplayModes)(SDL_VideoDevice *_this, SDL_VideoDisplay *display);
|
|
|
|
/*
|
|
* Setting the display mode is independent of creating windows, so
|
|
* when the display mode is changed, all existing windows should have
|
|
* their data updated accordingly, including the display surfaces
|
|
* associated with them.
|
|
*/
|
|
bool (*SetDisplayMode)(SDL_VideoDevice *_this, SDL_VideoDisplay *display, SDL_DisplayMode *mode);
|
|
|
|
/* * * */
|
|
/*
|
|
* Window functions
|
|
*/
|
|
bool (*CreateSDLWindow)(SDL_VideoDevice *_this, SDL_Window *window, SDL_PropertiesID create_props);
|
|
void (*SetWindowTitle)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
bool (*SetWindowIcon)(SDL_VideoDevice *_this, SDL_Window *window, SDL_Surface *icon);
|
|
bool (*SetWindowPosition)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
void (*SetWindowSize)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
void (*SetWindowMinimumSize)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
void (*SetWindowMaximumSize)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
void (*SetWindowAspectRatio)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
bool (*GetWindowBordersSize)(SDL_VideoDevice *_this, SDL_Window *window, int *top, int *left, int *bottom, int *right);
|
|
float (*GetWindowContentScale)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
void (*GetWindowSizeInPixels)(SDL_VideoDevice *_this, SDL_Window *window, int *w, int *h);
|
|
bool (*SetWindowOpacity)(SDL_VideoDevice *_this, SDL_Window *window, float opacity);
|
|
bool (*SetWindowParent)(SDL_VideoDevice *_this, SDL_Window *window, SDL_Window *parent);
|
|
bool (*SetWindowModal)(SDL_VideoDevice *_this, SDL_Window *window, bool modal);
|
|
void (*ShowWindow)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
void (*HideWindow)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
void (*RaiseWindow)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
void (*MaximizeWindow)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
void (*MinimizeWindow)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
void (*RestoreWindow)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
void (*SetWindowBordered)(SDL_VideoDevice *_this, SDL_Window *window, bool bordered);
|
|
void (*SetWindowResizable)(SDL_VideoDevice *_this, SDL_Window *window, bool resizable);
|
|
void (*SetWindowAlwaysOnTop)(SDL_VideoDevice *_this, SDL_Window *window, bool on_top);
|
|
SDL_FullscreenResult (*SetWindowFullscreen)(SDL_VideoDevice *_this, SDL_Window *window, SDL_VideoDisplay *display, SDL_FullscreenOp fullscreen);
|
|
void *(*GetWindowICCProfile)(SDL_VideoDevice *_this, SDL_Window *window, size_t *size);
|
|
SDL_DisplayID (*GetDisplayForWindow)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
bool (*SetWindowMouseRect)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
bool (*SetWindowMouseGrab)(SDL_VideoDevice *_this, SDL_Window *window, bool grabbed);
|
|
bool (*SetWindowKeyboardGrab)(SDL_VideoDevice *_this, SDL_Window *window, bool grabbed);
|
|
void (*DestroyWindow)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
bool (*CreateWindowFramebuffer)(SDL_VideoDevice *_this, SDL_Window *window, SDL_PixelFormat *format, void **pixels, int *pitch);
|
|
bool (*SetWindowFramebufferVSync)(SDL_VideoDevice *_this, SDL_Window *window, int vsync);
|
|
bool (*GetWindowFramebufferVSync)(SDL_VideoDevice *_this, SDL_Window *window, int *vsync);
|
|
bool (*UpdateWindowFramebuffer)(SDL_VideoDevice *_this, SDL_Window *window, const SDL_Rect *rects, int numrects);
|
|
void (*DestroyWindowFramebuffer)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
void (*OnWindowEnter)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
bool (*UpdateWindowShape)(SDL_VideoDevice *_this, SDL_Window *window, SDL_Surface *shape);
|
|
bool (*FlashWindow)(SDL_VideoDevice *_this, SDL_Window *window, SDL_FlashOperation operation);
|
|
bool (*ApplyWindowProgress)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
bool (*SetWindowFocusable)(SDL_VideoDevice *_this, SDL_Window *window, bool focusable);
|
|
bool (*SyncWindow)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
|
|
/* * * */
|
|
/*
|
|
* OpenGL support
|
|
*/
|
|
bool (*GL_LoadLibrary)(SDL_VideoDevice *_this, const char *path);
|
|
SDL_FunctionPointer (*GL_GetProcAddress)(SDL_VideoDevice *_this, const char *proc);
|
|
void (*GL_UnloadLibrary)(SDL_VideoDevice *_this);
|
|
SDL_GLContext (*GL_CreateContext)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
bool (*GL_MakeCurrent)(SDL_VideoDevice *_this, SDL_Window *window, SDL_GLContext context);
|
|
SDL_EGLSurface (*GL_GetEGLSurface)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
bool (*GL_SetSwapInterval)(SDL_VideoDevice *_this, int interval);
|
|
bool (*GL_GetSwapInterval)(SDL_VideoDevice *_this, int *interval);
|
|
bool (*GL_SwapWindow)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
bool (*GL_DestroyContext)(SDL_VideoDevice *_this, SDL_GLContext context);
|
|
void (*GL_DefaultProfileConfig)(SDL_VideoDevice *_this, int *mask, int *major, int *minor);
|
|
|
|
/* * * */
|
|
/*
|
|
* Vulkan support
|
|
*/
|
|
bool (*Vulkan_LoadLibrary)(SDL_VideoDevice *_this, const char *path);
|
|
void (*Vulkan_UnloadLibrary)(SDL_VideoDevice *_this);
|
|
char const * const *(*Vulkan_GetInstanceExtensions)(SDL_VideoDevice *_this, Uint32 *count);
|
|
bool (*Vulkan_CreateSurface)(SDL_VideoDevice *_this, SDL_Window *window, VkInstance instance, const struct VkAllocationCallbacks *allocator, VkSurfaceKHR *surface);
|
|
void (*Vulkan_DestroySurface)(SDL_VideoDevice *_this, VkInstance instance, VkSurfaceKHR surface, const struct VkAllocationCallbacks *allocator);
|
|
bool (*Vulkan_GetPresentationSupport)(SDL_VideoDevice *_this, VkInstance instance, VkPhysicalDevice physicalDevice, Uint32 queueFamilyIndex);
|
|
|
|
/* * * */
|
|
/*
|
|
* Metal support
|
|
*/
|
|
SDL_MetalView (*Metal_CreateView)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
void (*Metal_DestroyView)(SDL_VideoDevice *_this, SDL_MetalView view);
|
|
void *(*Metal_GetLayer)(SDL_VideoDevice *_this, SDL_MetalView view);
|
|
|
|
/* * * */
|
|
/*
|
|
* Event manager functions
|
|
*/
|
|
int (*WaitEventTimeout)(SDL_VideoDevice *_this, Sint64 timeoutNS);
|
|
void (*SendWakeupEvent)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
void (*PumpEvents)(SDL_VideoDevice *_this);
|
|
|
|
// Suspend/resume the screensaver
|
|
bool (*SuspendScreenSaver)(SDL_VideoDevice *_this);
|
|
|
|
// Text input
|
|
bool (*StartTextInput)(SDL_VideoDevice *_this, SDL_Window *window, SDL_PropertiesID props);
|
|
bool (*StopTextInput)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
bool (*UpdateTextInputArea)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
bool (*ClearComposition)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
|
|
// Screen keyboard
|
|
bool (*HasScreenKeyboardSupport)(SDL_VideoDevice *_this);
|
|
void (*ShowScreenKeyboard)(SDL_VideoDevice *_this, SDL_Window *window, SDL_PropertiesID props);
|
|
void (*HideScreenKeyboard)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
void (*SetTextInputProperties)(SDL_VideoDevice *_this, SDL_Window *window, SDL_PropertiesID props);
|
|
bool (*IsScreenKeyboardShown)(SDL_VideoDevice *_this, SDL_Window *window);
|
|
|
|
// Clipboard
|
|
const char **(*GetTextMimeTypes)(SDL_VideoDevice *_this, size_t *num_mime_types);
|
|
bool (*SetClipboardData)(SDL_VideoDevice *_this);
|
|
void *(*GetClipboardData)(SDL_VideoDevice *_this, const char *mime_type, size_t *size);
|
|
bool (*HasClipboardData)(SDL_VideoDevice *_this, const char *mime_type);
|
|
/* If you implement *ClipboardData, you don't need to implement *ClipboardText */
|
|
bool (*SetClipboardText)(SDL_VideoDevice *_this, const char *text);
|
|
char *(*GetClipboardText)(SDL_VideoDevice *_this);
|
|
bool (*HasClipboardText)(SDL_VideoDevice *_this);
|
|
// These functions are only needed if the platform has a separate primary selection buffer
|
|
bool (*SetPrimarySelectionText)(SDL_VideoDevice *_this, const char *text);
|
|
char *(*GetPrimarySelectionText)(SDL_VideoDevice *_this);
|
|
bool (*HasPrimarySelectionText)(SDL_VideoDevice *_this);
|
|
|
|
// MessageBox
|
|
bool (*ShowMessageBox)(SDL_VideoDevice *_this, const SDL_MessageBoxData *messageboxdata, int *buttonID);
|
|
|
|
// Hit-testing
|
|
bool (*SetWindowHitTest)(SDL_Window *window, bool enabled);
|
|
|
|
// Tell window that app enabled drag'n'drop events
|
|
void (*AcceptDragAndDrop)(SDL_Window *window, bool accept);
|
|
|
|
// Display the system-level window menu
|
|
void (*ShowWindowSystemMenu)(SDL_Window *window, int x, int y);
|
|
|
|
/* * * */
|
|
// Data common to all drivers
|
|
SDL_ThreadID thread;
|
|
bool checked_texture_framebuffer;
|
|
bool is_dummy;
|
|
bool suspend_screensaver;
|
|
void *wakeup_window;
|
|
int num_displays;
|
|
SDL_VideoDisplay **displays;
|
|
SDL_Rect desktop_bounds;
|
|
SDL_Window *windows;
|
|
SDL_Window *grabbed_window;
|
|
Uint32 clipboard_sequence;
|
|
SDL_ClipboardDataCallback clipboard_callback;
|
|
SDL_ClipboardCleanupCallback clipboard_cleanup;
|
|
void *clipboard_userdata;
|
|
char **clipboard_mime_types;
|
|
size_t num_clipboard_mime_types;
|
|
char *primary_selection_text;
|
|
bool setting_display_mode;
|
|
Uint32 device_caps;
|
|
SDL_SystemTheme system_theme;
|
|
|
|
/* * * */
|
|
// Data used by the GL drivers
|
|
struct
|
|
{
|
|
int red_size;
|
|
int green_size;
|
|
int blue_size;
|
|
int alpha_size;
|
|
int depth_size;
|
|
int buffer_size;
|
|
int stencil_size;
|
|
int double_buffer;
|
|
int accum_red_size;
|
|
int accum_green_size;
|
|
int accum_blue_size;
|
|
int accum_alpha_size;
|
|
int stereo;
|
|
int multisamplebuffers;
|
|
int multisamplesamples;
|
|
int floatbuffers;
|
|
int accelerated;
|
|
int major_version;
|
|
int minor_version;
|
|
int flags;
|
|
int profile_mask;
|
|
int share_with_current_context;
|
|
int release_behavior;
|
|
int reset_notification;
|
|
int framebuffer_srgb_capable;
|
|
int no_error;
|
|
int retained_backing;
|
|
int egl_platform;
|
|
int driver_loaded;
|
|
char driver_path[256];
|
|
SDL_SharedObject *dll_handle;
|
|
} gl_config;
|
|
|
|
SDL_EGLAttribArrayCallback egl_platformattrib_callback;
|
|
SDL_EGLIntArrayCallback egl_surfaceattrib_callback;
|
|
SDL_EGLIntArrayCallback egl_contextattrib_callback;
|
|
void *egl_attrib_callback_userdata;
|
|
|
|
/* * * */
|
|
// Cache current GL context; don't call the OS when it hasn't changed.
|
|
/* We have the global pointers here so Cocoa continues to work the way
|
|
it always has, and the thread-local storage for the general case.
|
|
*/
|
|
SDL_Window *current_glwin;
|
|
SDL_GLContext current_glctx;
|
|
SDL_TLSID current_glwin_tls;
|
|
SDL_TLSID current_glctx_tls;
|
|
|
|
/* Flag that stores whether it's allowed to call SDL_GL_MakeCurrent()
|
|
* with a NULL window, but a non-NULL context. (Not allowed in most cases,
|
|
* except on EGL under some circumstances.) */
|
|
bool gl_allow_no_surface;
|
|
|
|
/* * * */
|
|
// Data used by the Vulkan drivers
|
|
struct
|
|
{
|
|
SDL_FunctionPointer vkGetInstanceProcAddr;
|
|
SDL_FunctionPointer vkEnumerateInstanceExtensionProperties;
|
|
int loader_loaded;
|
|
char loader_path[256];
|
|
SDL_SharedObject *loader_handle;
|
|
} vulkan_config;
|
|
|
|
/* * * */
|
|
// Data private to this driver
|
|
SDL_VideoData *internal;
|
|
struct SDL_GLDriverData *gl_data;
|
|
|
|
#ifdef SDL_VIDEO_OPENGL_EGL
|
|
struct SDL_EGL_VideoData *egl_data;
|
|
#endif
|
|
|
|
#if defined(SDL_VIDEO_OPENGL_ES) || defined(SDL_VIDEO_OPENGL_ES2)
|
|
struct SDL_PrivateGLESData *gles_data;
|
|
#endif
|
|
|
|
/* * * */
|
|
// The function used to dispose of this structure
|
|
void (*free)(SDL_VideoDevice *_this);
|
|
};
|
|
|
|
typedef struct VideoBootStrap
|
|
{
|
|
const char *name;
|
|
const char *desc;
|
|
SDL_VideoDevice *(*create)(void);
|
|
bool (*ShowMessageBox)(const SDL_MessageBoxData *messageboxdata, int *buttonID); // can be done without initializing backend!
|
|
bool is_preferred;
|
|
} VideoBootStrap;
|
|
|
|
// Not all of these are available in a given build. Use #ifdefs, etc.
|
|
extern VideoBootStrap PRIVATE_bootstrap;
|
|
extern VideoBootStrap COCOA_bootstrap;
|
|
extern VideoBootStrap X11_bootstrap;
|
|
extern VideoBootStrap WINDOWS_bootstrap;
|
|
extern VideoBootStrap HAIKU_bootstrap;
|
|
extern VideoBootStrap UIKIT_bootstrap;
|
|
extern VideoBootStrap Android_bootstrap;
|
|
extern VideoBootStrap PS2_bootstrap;
|
|
extern VideoBootStrap PSP_bootstrap;
|
|
extern VideoBootStrap VITA_bootstrap;
|
|
extern VideoBootStrap RISCOS_bootstrap;
|
|
extern VideoBootStrap N3DS_bootstrap;
|
|
extern VideoBootStrap NGAGE_bootstrap;
|
|
extern VideoBootStrap RPI_bootstrap;
|
|
extern VideoBootStrap KMSDRM_bootstrap;
|
|
extern VideoBootStrap DUMMY_bootstrap;
|
|
extern VideoBootStrap DUMMY_evdev_bootstrap;
|
|
extern VideoBootStrap Wayland_preferred_bootstrap;
|
|
extern VideoBootStrap Wayland_bootstrap;
|
|
extern VideoBootStrap VIVANTE_bootstrap;
|
|
extern VideoBootStrap Emscripten_bootstrap;
|
|
extern VideoBootStrap OFFSCREEN_bootstrap;
|
|
extern VideoBootStrap QNX_bootstrap;
|
|
extern VideoBootStrap OPENVR_bootstrap;
|
|
|
|
extern bool SDL_UninitializedVideo(void);
|
|
// Use SDL_OnVideoThread() sparingly, to avoid regressions in use cases that currently happen to work
|
|
extern bool SDL_OnVideoThread(void);
|
|
extern SDL_VideoDevice *SDL_GetVideoDevice(void);
|
|
extern void SDL_SetSystemTheme(SDL_SystemTheme theme);
|
|
extern SDL_DisplayID SDL_AddBasicVideoDisplay(const SDL_DisplayMode *desktop_mode);
|
|
extern SDL_DisplayID SDL_AddVideoDisplay(const SDL_VideoDisplay *display, bool send_event);
|
|
extern void SDL_DelVideoDisplay(SDL_DisplayID display, bool send_event);
|
|
extern bool SDL_AddFullscreenDisplayMode(SDL_VideoDisplay *display, const SDL_DisplayMode *mode);
|
|
extern void SDL_ResetFullscreenDisplayModes(SDL_VideoDisplay *display);
|
|
extern void SDL_SetDesktopDisplayMode(SDL_VideoDisplay *display, const SDL_DisplayMode *mode);
|
|
extern void SDL_SetCurrentDisplayMode(SDL_VideoDisplay *display, const SDL_DisplayMode *mode);
|
|
extern void SDL_SetDisplayContentScale(SDL_VideoDisplay *display, float scale);
|
|
extern void SDL_SetDisplayHDRProperties(SDL_VideoDisplay *display, const SDL_HDROutputProperties *HDR);
|
|
extern bool SDL_SetDisplayModeForDisplay(SDL_VideoDisplay *display, SDL_DisplayMode *mode);
|
|
extern SDL_VideoDisplay *SDL_GetVideoDisplay(SDL_DisplayID display);
|
|
extern SDL_DisplayID SDL_GetDisplayForWindowPosition(SDL_Window *window);
|
|
extern SDL_VideoDisplay *SDL_GetVideoDisplayForWindow(SDL_Window *window);
|
|
extern SDL_VideoDisplay *SDL_GetVideoDisplayForFullscreenWindow(SDL_Window *window);
|
|
extern int SDL_GetDisplayIndex(SDL_DisplayID displayID);
|
|
extern SDL_DisplayData *SDL_GetDisplayDriverData(SDL_DisplayID display);
|
|
extern SDL_DisplayData *SDL_GetDisplayDriverDataForWindow(SDL_Window *window);
|
|
extern int SDL_GetMessageBoxCount(void);
|
|
extern void SDL_SetWindowHDRProperties(SDL_Window *window, const SDL_HDROutputProperties *HDR, bool send_event);
|
|
extern void SDL_SetWindowSafeAreaInsets(SDL_Window *window, int left, int right, int top, int bottom);
|
|
|
|
extern void SDL_GL_DeduceMaxSupportedESProfile(int *major, int *minor);
|
|
|
|
extern bool SDL_RecreateWindow(SDL_Window *window, SDL_WindowFlags flags);
|
|
extern bool SDL_HasWindows(void);
|
|
extern void SDL_RelativeToGlobalForWindow(SDL_Window *window, int rel_x, int rel_y, int *abs_x, int *abs_y);
|
|
extern void SDL_GlobalToRelativeForWindow(SDL_Window *window, int abs_x, int abs_y, int *rel_x, int *rel_y);
|
|
extern bool SDL_ShouldFocusPopup(SDL_Window *window);
|
|
extern bool SDL_ShouldRelinquishPopupFocus(SDL_Window *window, SDL_Window **new_focus);
|
|
|
|
extern void SDL_OnDisplayAdded(SDL_VideoDisplay *display);
|
|
extern void SDL_OnDisplayMoved(SDL_VideoDisplay *display);
|
|
extern void SDL_OnWindowShown(SDL_Window *window);
|
|
extern void SDL_OnWindowHidden(SDL_Window *window);
|
|
extern void SDL_OnWindowMoved(SDL_Window *window);
|
|
extern void SDL_OnWindowResized(SDL_Window *window);
|
|
extern void SDL_CheckWindowPixelSizeChanged(SDL_Window *window);
|
|
extern void SDL_OnWindowPixelSizeChanged(SDL_Window *window);
|
|
extern void SDL_OnWindowLiveResizeUpdate(SDL_Window *window);
|
|
extern void SDL_OnWindowMinimized(SDL_Window *window);
|
|
extern void SDL_OnWindowMaximized(SDL_Window *window);
|
|
extern void SDL_OnWindowRestored(SDL_Window *window);
|
|
extern void SDL_OnWindowEnter(SDL_Window *window);
|
|
extern void SDL_OnWindowLeave(SDL_Window *window);
|
|
extern void SDL_OnWindowFocusGained(SDL_Window *window);
|
|
extern void SDL_OnWindowFocusLost(SDL_Window *window);
|
|
extern void SDL_OnWindowDisplayChanged(SDL_Window *window);
|
|
extern void SDL_UpdateWindowGrab(SDL_Window *window);
|
|
extern bool SDL_UpdateFullscreenMode(SDL_Window *window, SDL_FullscreenOp fullscreen, bool commit);
|
|
extern SDL_Window *SDL_GetToplevelForKeyboardFocus(void);
|
|
|
|
extern bool SDL_ShouldAllowTopmost(void);
|
|
|
|
extern void SDL_ToggleDragAndDropSupport(void);
|
|
|
|
extern void SDL_UpdateDesktopBounds(void);
|
|
|
|
extern SDL_TextInputType SDL_GetTextInputType(SDL_PropertiesID props);
|
|
extern SDL_Capitalization SDL_GetTextInputCapitalization(SDL_PropertiesID props);
|
|
extern bool SDL_GetTextInputAutocorrect(SDL_PropertiesID props);
|
|
extern bool SDL_GetTextInputMultiline(SDL_PropertiesID props);
|
|
|
|
#endif // SDL_sysvideo_h_
|