Changelog:
=============
- MIX_DestroyTrack may now be called from a mixer callback
- Fixed WAV decoding on big-endian systems
Signed-off-by: Wang Mingyu <wangmy@fujitsu.com>
Signed-off-by: Khem Raj <khem.raj@oss.qualcomm.com>
Changelog:
===========
- Non-animated images can now be loaded as single frame animations
- Fixed animated WebP frame composition
- Fixed potential buffer overflow in tRNS handling
- Fixed out of bounds read in XCF image loader (CVE-2026-35444)
Signed-off-by: Wang Mingyu <wangmy@fujitsu.com>
Signed-off-by: Khem Raj <khem.raj@oss.qualcomm.com>
opusfile comes from meta-multimedia and meta-oe does
not depend on it, for keeping layer compatible, it
must be kept disabled
Fixes YP Compatible checks
Signed-off-by: Khem Raj <khem.raj@oss.qualcomm.com>
Cc: Markus Volk <f_l_k@t-online.de>
libsdl3-mixer has initially released
- binaries in wavpack-bin are only needed at runtime but cmake checks
for them during compilation and fails because they are (presumably
intentionally) not present in the target sysroot. Workround this issue
by touching the necessary files to please cmake.
Signed-off-by: Markus Volk <f_l_k@t-online.de>
Signed-off-by: Khem Raj <khem.raj@oss.qualcomm.com>
- Fix license checksum: Copyright year has been changed
- Add support for av1 and jxl
- libavif is in meta-multimedia -> disable av1 by default
Signed-off-by: Markus Volk <f_l_k@t-online.de>
Signed-off-by: Khem Raj <raj.khem@gmail.com>
- dont explicitly disable xinput support to fix compilation if x11
support is enabled (error: unknown type name 'XIRawEvent')
- add missing dependencies for libxcursor, xtst, xinput
In addition to lots of bug fixes and general system improvements, this release has some major themes of improved interoperability between the 3D GPU API and the 2D rendering API, improved Emscripten support, improved pen handling, and native support for PNG images.
Here is a full list of the API changes since the last release:
General:
Added SDL_CreateAnimatedCursor() to create animated color cursors
Added SDL_HINT_MOUSE_DPI_SCALE_CURSORS to automatically scale cursors based on the display scale
Added SDL_SetWindowProgressState(), SDL_SetWindowProgressValue(), SDL_GetWindowProgressState(), and SDL_GetWindowProgressValue() to show progress in the window's taskbar icon on Windows and Linux
Added GPU device creation properties to enable the GPU API on older hardware if you're not using these features:
SDL_PROP_GPU_DEVICE_CREATE_FEATURE_CLIP_DISTANCE_BOOLEAN
SDL_PROP_GPU_DEVICE_CREATE_FEATURE_DEPTH_CLAMPING_BOOLEAN
SDL_PROP_GPU_DEVICE_CREATE_FEATURE_INDIRECT_DRAW_FIRST_INSTANCE_BOOLEAN
SDL_PROP_GPU_DEVICE_CREATE_FEATURE_ANISOTROPY_BOOLEAN
SDL_PROP_GPU_DEVICE_CREATE_D3D12_ALLOW_FEWER_RESOURCE_SLOTS_BOOLEAN
Added SDL_PROP_GPU_DEVICE_CREATE_VULKAN_OPTIONS_POINTER to enable configuring Vulkan features when creating a GPU device
Added SDL_PROP_GPU_DEVICE_CREATE_VULKAN_REQUIRE_HARDWARE_ACCELERATION_BOOLEAN to allow requiring Vulkan hardware acceleration when creating a GPU device
Added SDL_GetGPUDeviceProperties() to query information from a GPU device:
SDL_PROP_GPU_DEVICE_NAME_STRING
SDL_PROP_GPU_DEVICE_DRIVER_NAME_STRING
SDL_PROP_GPU_DEVICE_DRIVER_VERSION_STRING
SDL_PROP_GPU_DEVICE_DRIVER_INFO_STRING
Added SDL_GetPixelFormatFromGPUTextureFormat() and SDL_GetGPUTextureFormatFromPixelFormat()
Added SDL_CreateGPURenderer() and SDL_GetGPURendererDevice() to create a 2D renderer for use with GPU rendering.
Added SDL_CreateGPURenderState(), SDL_SetGPURenderStateFragmentUniforms(), SDL_SetGPURenderState(), and SDL_DestroyGPURenderState() to use fragment shaders with a GPU 2D renderer
Added SDL_PROP_TEXTURE_CREATE_GPU_TEXTURE_POINTER to create a 2D texture from an existing GPU texture
Added SDL_PROP_TEXTURE_GPU_TEXTURE_POINTER to get the GPU texture from a 2D texture when using the GPU 2D renderer
Added support for YUV textures and HDR colorspaces to the GPU 2D renderer
Added support for textures with palettes, and SDL_GetTexturePalette() and SDL_SetTexturePalette() to interact with them
Added SDL_RenderTexture9GridTiled() to do tiled instead of stretched 9-grid texture rendering
Added SDL_GetDefaultTextureScaleMode() and SDL_SetDefaultTextureScaleMode() to set the texture scale mode for new textures
Added SDL_GetRenderTextureAddressMode() and SDL_SetRenderTextureAddressMode() to change the texture addressing mode
Added SDL_TEXTURE_ADDRESS_WRAP to allow wrapping of textures if the renderer has SDL_PROP_RENDERER_TEXTURE_WRAPPING_BOOLEAN set
The default YUV colorspace is BT.601 limited range, for compatibility with SDL2
Added SDL_SCALEMODE_PIXELART as an improved scaling algorithm for pixel art without introducing blurring
Added SDL_FLIP_HORIZONTAL_AND_VERTICAL to flip a surface both horizontally and vertically
Added SDL_LoadPNG(), SDL_LoadPNG_IO(), SDL_SavePNG(), and SDL_SavePNG_IO() to load and save PNG images
Added SDL_LoadSurface() and SDL_LoadSurface_IO() to detect BMP and PNG formats and load them as surfaces
Added SDL_PROP_SURFACE_ROTATION_FLOAT to indicate the rotation needed to display camera images upright
Added SDL_RotateSurface() to create a rotated copy of a surface
SDL_EVENT_WINDOW_EXPOSED now sets data1 to true if it is sent during live resizing
Added SDL_EVENT_DISPLAY_USABLE_BOUNDS_CHANGED, which is sent when the usable desktop bounds change
Added SDL_EVENT_SCREEN_KEYBOARD_SHOWN, which is sent when the on-screen keyboard has been shown
Added SDL_EVENT_SCREEN_KEYBOARD_HIDDEN, which is sent when the on-screen keyboard has been hidden
Added pinch gesture events: SDL_EVENT_PINCH_BEGIN, SDL_EVENT_PINCH_UPDATE, SDL_EVENT_PINCH_END
SDL_EVENT_AUDIO_DEVICE_ADDED will be sent during initialization for each audio device
SDL_GetCameraPermissionState() returns SDL_CameraPermissionState instead of int
Added SDL_PutAudioStreamDataNoCopy() to do more efficient audio stream processing in some cases
Added SDL_PutAudioStreamPlanarData() to add planar audio data instead of interleaved data to an audio stream
Added SDL_HINT_AUDIO_DEVICE_RAW_STREAM to signal that the OS shouldn't do further audio processing, useful for applications that handle noise canceling, etc.
Added SDL_PROP_AUDIOSTREAM_AUTO_CLEANUP_BOOLEAN to allow streams that persist beyond the audio subsystem lifetime.
Added enhanced support for 8BitDo controllers
Added enhanced support for FlyDigi controllers
Added enhanced support for Hand Held Legend SInput controllers
Added support for wired Nintendo Switch 2 controllers when built with libusb
Added SDL_hid_get_properties() to associate SDL properties with HID devices
Added SDL_PROP_HIDAPI_LIBUSB_DEVICE_HANDLE_POINTER to query the libusb handle from an SDL_hid_device, if it's been opened with libusb
Added SDL_SetRelativeMouseTransform() to add custom mouse input transformation
Added SDL_GetPenDeviceType() to determine whether a pen is on the screen or on a separate touchpad
SDL_HINT_MAIN_CALLBACK_RATE may be set to a floating point callback rate
Added SDL_GetEventDescription() to get an English description of an event, suitable for logging
Added SDL_PROP_IOSTREAM_MEMORY_FREE_FUNC_POINTER to allow custom freeing of the memory used by SDL_IOFromMem() and SDL_IOFromConstMem()
Added SDL_PROP_PROCESS_CREATE_WORKING_DIRECTORY_STRING to set the working directory for new processes
Added verbose log output when the DEBUG_INVOCATION environment variable is set to "1"
Added SDL_AddAtomicU32()
Added SDL_GetSystemPageSize() to get the system page size
Added SDL_ALIGNED() to signal that data should have a specific alignment
Windows:
Added SDL_HINT_RENDER_DIRECT3D11_WARP to enable D3D11 software rasterization
Using SDL_InsertGPUDebugLabel(), SDL_PushGPUDebugGroup(), and SDL_PopGPUDebugGroup() requires WinPixEventRuntime.dll to be in your PATH or in the same directory as your executable
Added SDL_PROP_DISPLAY_WINDOWS_HMONITOR_POINTER so you can query the HMONITOR associated with a display
SDL_HINT_AUDIO_DEVICE_STREAM_ROLE is used by the WASAPI audio driver to set the audio stream category
Added SDL_HINT_AUDIO_DEVICE_RAW_STREAM to signal whether the OS audio driver should do additional signal processing
Added SDL_HINT_WINDOWS_RAW_KEYBOARD_EXCLUDE_HOTKEYS to allow disabling some system hotkeys when in raw input mode
SDL_HINT_WINDOWS_GAMEINPUT is disabled by default
macOS:
Added SDL_HINT_MAC_PRESS_AND_HOLD to control whether holding down a key will repeat the pressed key or open the accents menu
Linux:
Added atomic support for KMSDRM
Added SDL_HINT_KMSDRM_ATOMIC to control whether KMSDRM will use atomic functionality
Added SDL_PROP_DISPLAY_WAYLAND_WL_OUTPUT_POINTER so you can query the wl_output associated with a display
Emscripten:
Added SDL_WINDOW_FILL_DOCUMENT to indicate that windows expand to fill the whole browser window
Added SDL_SetWindowFillDocument() to change whether windows expand to fill the whole browser window
Added SDL_PROP_WINDOW_CREATE_EMSCRIPTEN_CANVAS_ID_STRING to allow setting the SDL canvas ID, and SDL_PROP_WINDOW_EMSCRIPTEN_CANVAS_ID_STRING to query it on existing windows
Added SDL_PROP_WINDOW_CREATE_EMSCRIPTEN_KEYBOARD_ELEMENT_STRING to specify where keyboard input is bound, and SDL_PROP_WINDOW_EMSCRIPTEN_KEYBOARD_ELEMENT_STRING to query it on existing windows
iOS:
SDL now supports window scenes, fixing the warning "CLIENT OF UIKIT REQUIRES UPDATE"
Added SDL_PROP_WINDOW_CREATE_WINDOWSCENE_POINTER to specify the window scene for a window
visionOS:
The default refresh rate has been increased to 90Hz
SDL_SetWindowSize() changes the size of the window on Vision Pro headsets
PlayStation 2:
Added the following hints to control the display parameters: SDL_HINT_PS2_GS_WIDTH, SDL_HINT_PS2_GS_HEIGHT, SDL_HINT_PS2_GS_PROGRESSIVE, SDL_HINT_PS2_GS_MODE
Signed-off-by: Markus Volk <f_l_k@t-online.de>
Signed-off-by: Khem Raj <raj.khem@gmail.com>
- fix license checkksum: Copyright year has been changed
This is a stable bugfix release, with the following changes:
Fixed surface memory leak in some circumstances
Fixed mouse grab not persisting past window recreation
Fixed picking the correct fullscreen resolution
Signed-off-by: Markus Volk <f_l_k@t-online.de>
Signed-off-by: Khem Raj <raj.khem@gmail.com>
- Fix license checksum: Copyright year has been changed
- Add support for av1 and jxl
Signed-off-by: Markus Volk <f_l_k@t-online.de>
Signed-off-by: Khem Raj <raj.khem@gmail.com>
- Starting with [https://github.com/libsdl-org/sdl2-compat/pull/536], it
is possible to compile without x11. Remove x11 from
REQUIRED_DISTRO_FEATURES
Changelog:
2.32.62:
This is a stable bugfix release, with the following changes:
Improved support for GNU/Hurd
Fixed crash if hidapi strings are not available
2.32.60:
This is a stable bugfix release, with the following changes:
Fixed crash at startup in Dwarf Fortress
Fixed crash at startup in Stellaris
Fixed mouse stuttering in Amiberry
Fixed the viewport not being reset when the window is resized
Signed-off-by: Markus Volk <f_l_k@t-online.de>
Signed-off-by: Khem Raj <raj.khem@gmail.com>
This is a stable bugfix release, with the following changes:
Fixed a crash at startup in Hearts of Iron IV
Fixed mouse movement in Heroes of Might and Magic III
Fixed crash under Wayland with Heavy Gear 2
Fixed crash at shutdown in Sim City 3000
Fixed stuck mouse cursor in Seven Kingdoms
Added a fast path for SDL_MapRGB() and SDL_MapRGBA()
Fixed the colorspace for YUV to RGB conversion
Fixed deadlock when opening audio on some systems
Added logging when games are launched with DEBUG_INVOCATION=1
Signed-off-by: Markus Volk <f_l_k@t-online.de>
Signed-off-by: Khem Raj <raj.khem@gmail.com>
This is a stable bugfix release, with the following changes:
Improved validation and fixed memory leaks in the GPU subsystem
Fixed a delay at shutdown when the mouse is grabbed under X11
Do full rectangle intersection for empty rectangles
Fixed destination coordinates when using scale with the software renderer
Clipboard callbacks are only called with the mime types they expect
Fixed the Moonlander MK1 Keyboard being detected as a controller
Fixed the 8BitDo Ultimate 2C Wireless Controller showing up twice on some systems
Added a Linux mapping for the 8BitDo Pro 3 controller
Fixed getting keyboard events from gamepads on iOS 26
Added support for the Zenaim Arcade Controller
Fixed emulated touch on Android
Added a workaround for the Android 14 OS bug "java.lang.NullPointerException android.view.View.onResolvePointerIcon"
Fixed page alignment for the Android release archive
Corrected texture colors on PS2
Signed-off-by: Markus Volk <f_l_k@t-online.de>
Signed-off-by: Khem Raj <raj.khem@gmail.com>
Please see
https://git.yoctoproject.org/poky/commit/?id=4dd321f8b83afecd962393101b2a6861275b5265
for what changes are needed, and sed commands that can be used to make them en masse.
I've verified that bitbake -c patch world works with these, but did not run a world
build; the majority of recipes shouldn't need further fixups, but if there are
some that still fall out, they can be fixed in followups.
Signed-off-by: Alexander Kanavin <alex@linutronix.de>
Signed-off-by: Khem Raj <raj.khem@gmail.com>
2.32.56
This is a stable bugfix release, with the following changes:
Fixed rendering in Mesen2
Fixed brightness in ioquake3
Fixed a hang at launch in the xemu emulator
Fixed crackling and sped up audio in OpenRCT2
Fixed fullscreen window positioning on Wayland with multiple displays
Key events are now sent for dead keys on X11
Fixed mouse wheel integer scrolling values
Fixed a double-free when working with RLE surfaces
Fixed a memory leak in SDL_LockTextureToSurface()
Fixed sending SDL3 controller events to SDL2 applications
2.32.54
This is a stable bugfix release, with the following changes:
sdl2_compat.pc was renamed to sdl2-compat.pc
Fixed creating fullscreen exclusive windows
Fixed relative mouse motion for Half-Life and mods on Windows
Fixed crash during controller hotplug in RetroArch
Fixed display scale under Wayland in ioquake3
Default to using X11 for the UE5 editor, fixing mouse input
Fixed SDL_SetWindowInputFocus() return value
Improved accuracy of SDL_GetRenderDriverInfo()
Improved handling of very slight mouse movements
Signed-off-by: Markus Volk <f_l_k@t-online.de>
Signed-off-by: Khem Raj <raj.khem@gmail.com>
- do not disable xrandr to avoid:
| /home/flk/poky/build/tmp/work/corei7-64-poky-linux/libsdl3/3.2.12/SDL3-3.2.12/src/video/x11/SDL_x11messagebox.c:506:13: error: unknown type name 'XRRScreenResources'
| 506 | XRRScreenResources *screen = X11_XRRGetScreenResourcesCurrent(display, DefaultRootWindow(display));
| | ^~~~~~~~~~~~~~~~~~
| /home/flk/poky/build/tmp/work/corei7-64-poky-linux/libsdl3/3.2.12/SDL3-3.2.12/src/video/x11/SDL_x11messagebox.c:506:42: error: implicit declaration of function 'X11_XRRGetScreenResourcesCurrent' [-Wimplicit-function-declaration]
| 506 | XRRScreenResources *screen = X11_XRRGetScreenResourcesCurrent(display, DefaultRootWindow(display));
| | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
| /home/flk/poky/build/tmp/work/corei7-64-poky-linux/libsdl3/3.2.12/SDL3-3.2.12/src/video/x11/SDL_x11messagebox.c:506:42: error: initialization of 'int *' from 'int' makes pointer from integer without a cast [-Wint-conversion]
| /home/flk/poky/build/tmp/work/corei7-64-poky-linux/libsdl3/3.2.12/SDL3-3.2.12/src/video/x11/SDL_x11messagebox.c:507:13: error: unknown type name 'XRRCrtcInfo'
| 507 | XRRCrtcInfo *crtc_info = X11_XRRGetCrtcInfo(display, screen, screen->crtcs[0]);
| | ^~~~~~~~~~~
| /home/flk/poky/build/tmp/work/corei7-64-poky-linux/libsdl3/3.2.12/SDL3-3.2.12/src/video/x11/SDL_x11messagebox.c:507:38: error: implicit declaration of function 'X11_XRRGetCrtcInfo' [-Wimplicit-function-declaration]
| 507 | XRRCrtcInfo *crtc_info = X11_XRRGetCrtcInfo(display, screen, screen->crtcs[0]);
| | ^~~~~~~~~~~~~~~~~~
| /home/flk/poky/build/tmp/work/corei7-64-poky-linux/libsdl3/3.2.12/SDL3-3.2.12/src/video/x11/SDL_x11messagebox.c:507:80: error: request for member 'crtcs' in something not a structure or union
| 507 | XRRCrtcInfo *crtc_info = X11_XRRGetCrtcInfo(display, screen, screen->crtcs[0]);
| | ^~
| /home/flk/poky/build/tmp/work/corei7-64-poky-linux/libsdl3/3.2.12/SDL3-3.2.12/src/video/x11/SDL_x11messagebox.c:508:27: error: request for member 'width' in something not a structure or union
| 508 | x = (crtc_info->width - data->dialog_width) / 2;
| | ^~
| /home/flk/poky/build/tmp/work/corei7-64-poky-linux/libsdl3/3.2.12/SDL3-3.2.12/src/video/x11/SDL_x11messagebox.c:509:27: error: request for member 'height' in something not a structure or union
| 509 | y = (crtc_info->height - data->dialog_height) / 3;
| |
This is a stable bugfix release, with the following changes:
Fixed crash if SDL_BlitSurfaceScaled() is used with a surface that has no pixels
Removed timeout in SDL_RunOnMainThread()
Allow rendering a zero sized source rectangle in the SDL render API
Fixed texture colorspace when creating a texture from a surface with the SDL render API
Renamed SDL_PROP_GPU_TEXTURE_CREATE_D3D12_CLEAR_STENCIL_UINT8 to SDL_PROP_GPU_TEXTURE_CREATE_D3D12_CLEAR_STENCIL_NUMBER
Allow a NULL shader entry point for SDL_GPUShaderCreateInfo, defaulting to the one used by SDL_shadercross
Fixed failing to create a GPU device if the D3D12 debug layers aren't available on Windows
Added support for the share button on the GameSir-K1 FLUX controller
Added support for the PowerA Battle Dragon Advanced Wireless Controller
Added support for the HORI Taiko No Tatsujin Drum Controller
Fixed the Keychron K1 Pro System Control keyboard being detected as a joystick
Fixed right mouse button emulation when using a Wacom tablet in Windows Ink mode
Fixed missing simulated mouse events using a Wacom tablet when Windows Ink mode is disabled
Fixed process I/O redirection to NUL on Windows
Key events are now sent for dead keys on X11
Improved handling of window management edge conditions on X11
Fixed message box location on multi-monitor configurations on X11
Fixed XInput2 mouse tracking outside the window on X11
Fixed window focus after showing a file dialog on macOS
Ignore mouse clicks and motion on tooltip windows on macOS
Fixed message boxes shown on a background thread on iOS
Fixed Android audio crackling introduced in 3.2.10
Fixed handling of SDL_HINT_ANDROID_ALLOW_RECREATE_ACTIVITY
Fixed A/B/X/Y buttons on Nintendo 3DS
Fixed building for Xbox One
Signed-off-by: Markus Volk <f_l_k@t-online.de>
Signed-off-by: Khem Raj <raj.khem@gmail.com>
Since libsdl2 and libsdl2-compat are now mutually exclusive
we can afford to rename the .pc file from sdl2-compat.pc to sdl2.pc
This helps other projects which use pkgconfig to find libsdl2
Allow to build libsdl2-compat for native and nativesdk. This is required
to build qemu
Signed-off-by: Markus Volk <f_l_k@t-online.de>
Signed-off-by: Khem Raj <raj.khem@gmail.com>
libsdl2 and libsdl2-compat share the same headers.
Therefore, using one or the other is an either-or decision
Signed-off-by: Markus Volk <f_l_k@t-online.de>
Signed-off-by: Khem Raj <raj.khem@gmail.com>
This is a drop in replacement for libsdl2 that uses libsdl3 behind the scenes
Signed-off-by: Markus Volk <f_l_k@t-online.de>
Signed-off-by: Khem Raj <raj.khem@gmail.com>
Khem Raj
Wang Mingyu
Markus Volk
Khem Raj
Liu Yiding
Alexander Kanavin