Go to file
Frank Praznik 4f3d4bd110 wayland: Add the ability to import and wrap external surfaces
Add the ability to import and wrap external surfaces from external toolkits such as Qt and GTK.

Wayland surfaces and windows are more intrinsically tied to the client library than other windowing systems, so it is necessary to provide a way to initialize SDL with an existing wl_display object, which needs to be set prior to video system initialization, or export the internal SDL wl_display object for use by external applications or toolkits. For this, the global property SDL_PROPERTY_GLOBAL_VIDEO_WAYLAND_WL_DISPLAY_POINTER is used.

A Wayland example was added to testnative, and a basic example of Qt 6 interoperation is provided in the Wayland readme to demonstrate the use of external windows with both SDL owning the wl_display, and an external toolkit owning it.
2024-01-15 13:54:35 -05:00
.github ci: do 'brew update' & don't run dependent checks on installed things 2023-11-26 06:01:26 +01:00
VisualC Rename SDL_mslibc_x64.asm -> SDL_mslibc_x64.masm 2024-01-04 17:46:07 +01:00
VisualC-GDK Make Xbox GDK code public (and fix some GDK code rot) (#8844) 2024-01-14 20:31:41 -08:00
VisualC-WinRT Rename SDL_mslibc_x64.asm -> SDL_mslibc_x64.masm 2024-01-04 17:46:07 +01:00
Xcode Updated copyright for 2024 2024-01-01 13:15:26 -08:00
android-project AndroidShowToast: make OneShotTask members private final 2024-01-01 08:31:34 -08:00
build-scripts Updated copyright for 2024 2024-01-01 13:15:26 -08:00
cmake SDL_hidapi requires libusb >= 1.0.16 2023-11-24 21:31:59 +01:00
docs wayland: Add the ability to import and wrap external surfaces 2024-01-15 13:54:35 -05:00
include wayland: Add the ability to import and wrap external surfaces 2024-01-15 13:54:35 -05:00
mingw/pkg-support/cmake build: don't add SDL3 subfolder to include path for external projects 2022-11-27 14:33:13 -08:00
src wayland: Add the ability to import and wrap external surfaces 2024-01-15 13:54:35 -05:00
test wayland: Add the ability to import and wrap external surfaces 2024-01-15 13:54:35 -05:00
wayland-protocols Add and event and flag to report when a window has been occluded 2023-07-18 16:42:05 -04:00
.clang-format Commented out syntax that causes Visual Studio 2019 to complain on every edit 2022-12-02 00:43:01 -08:00
.clang-tidy Fix size of memcpy in SDL_AudioDeviceFormatChangedAlreadyLocked 2023-08-05 14:14:45 -04:00
.editorconfig Fixed formatting for Haiku cc files 2023-01-25 03:03:41 -08:00
.gitignore Make Xbox GDK code public (and fix some GDK code rot) (#8844) 2024-01-14 20:31:41 -08:00
.wikiheaders-options sdlwiki: SDL3 advises users to include through 'SDL3/SDL.h' 2023-03-21 02:19:19 +01:00
Android.mk Always provide an implementation for all SDL3 symbols 2023-10-12 14:00:47 +02:00
BUGS.txt Cleaned up a few more Bugzilla mentions. 2021-02-12 14:46:49 -05:00
CMakeLists.txt Rename SDL_mslibc_x64.asm -> SDL_mslibc_x64.masm 2024-01-04 17:46:07 +01:00
CREDITS.md docs: Moved CREDITS and INSTALL to markdown format. 2023-11-29 12:31:27 -05:00
INSTALL.md docs: Moved CREDITS and INSTALL to markdown format. 2023-11-29 12:31:27 -05:00
LICENSE.txt Updated copyright for 2024 2024-01-01 13:15:26 -08:00
README-SDL.txt More HTTPS changes in the documentation. 2017-02-16 16:52:03 -05:00
README.md docs: Convert everything to Unix-style endlines. 2023-11-29 11:29:57 -05:00
WhatsNew.txt Remove SDL_{Set,Get}SurfaceScale(). 2023-12-22 02:08:49 -08:00

README.md

Simple DirectMedia Layer (SDL) Version 3.0

https://www.libsdl.org/

Simple DirectMedia Layer is a cross-platform development library designed to provide low level access to audio, keyboard, mouse, joystick, and graphics hardware via OpenGL and Direct3D. It is used by video playback software, emulators, and popular games including Valve's award winning catalog and many Humble Bundle games.

More extensive documentation is available in the docs directory, starting with README.md. If you are migrating to SDL 3.0 from SDL 2.0, the changes are extensively documented in README-migration.md.

Enjoy!

Sam Lantinga (slouken@libsdl.org)