3.2.8

This is a stable bugfix release, with the following changes:

• Fixed restoring the desktop mode on macOS and X11
• Fixed being unable to get message box fonts on some Linux systems
• Fixed a potential crash unplugging a HIDAPI controller
• Fixed the 2D clip rect when logical presentation is enabled
• Fixed SDL GPU output orientation on Android

3.2.6

This is a stable bugfix release, with the following changes:

• Added support for Motion JPEG camera capture
• Allow 2D render targets to use logical presentation
• Ensure all drawing is completed before destroying a software renderer
• Fixed audio glitch when resampling between large frequency differences
• Fixed pen generated mouse events not having SDL_PEN_MOUSEID
• Added support for the 8BitDo Micro gamepad
• Fixed lack of input from Nintendo Switch Pro controllers when plugged in wired in some applications
• Added SDL_HINT_JOYSTICK_HAPTIC_AXES to specify how many haptic axes a device has
• Fixed SDL_GetRelativeMouseState() returning no motion when not in relative mouse mode
• Added SDL_PROP_SURFACE_HOTSPOT_X_NUMBER and SDL_PROP_SURFACE_HOTSPOT_Y_NUMBER to allow storing cursor hotspot positions directly in an SDL_Surface
• Fixed camera frame capture on Windows 7
• Fixed 2D texture rendering using the direct3d12 renderer on the latest NVIDIA drivers
• Improved naming of keyboards and mice under Windows
• Fixed opening one Joy-Con of a pair when the other is disconnected on Windows
• Fixed stack overflow when setting thread debug names on Windows
• Fixed Russian input on some Linux desktop environments
• Fixed non-text clipboard handling on Wayland
• Added support for high DPI icons on Wayland
• Added color management protocol support on Wayland
• Fixed flushing audio forever in some cases when recording PulseAudio on Linux
• Fixed a rare deadlock when opening an audio device using PipeWire on Linux
• Fixed SDL_WaitEvent() returning false when keys are repeated under Wayland
• Fixed not getting mouse focus on older versions of macOS
• Fixed the cursor confinement area when toggling window borders on macOS
• Added a mapping for the 8BitDo SN30 Pro+ controller on macOS
• Fixed visual orientation when using SDL GPU on Android

2.32.2

This is a stable bugfix release, with the following changes:

• Fixed stack overflow when setting thread debug names on Windows
• Fixed flushing audio forever in some cases when recording PulseAudio on Linux
• Fixed a crash when initializing with controllers connected on macOS
• Added SDL_HINT_JOYSTICK_HAPTIC_AXES to specify how many haptic axes a device has

2.32.0

SDL 3.0 recommended!

The SDL development team is focusing efforts on SDL3 and making sdl2-compat a drop-in replacement for SDL2. If you run into issues with SDL2, please consider upgrading to SDL3 or trying out sdl2-compat. We have made significant improvements across all platforms and your issue may already be resolved.

This is a stable bugfix release, with the following changes:

• Allow destroying a window and its renderer in either order
• Added cursor-shape-v1 protocol support on Wayland
• Fixed full immersive mode in Android 9 and higher
• Improved event processing latency when gamepad/sensor is open
• Added SDL_HINT_APPLE_RWFROMFILE_USE_RESOURCES to control whether SDL tries to open files from the app's resource directory on macOS
• Fixed conditional effect playback on Moza Racing devices
• Fixed input for Thrustmaster PlayStation wheels when hid-tmff2 is installed
• Enabled direct VRAM access when using the window surface API on PSP
• Improved window surface support on Nintendo 3DS
• Fixed condition variable implementation on Nintendo 3DS
• Fixed byte order detection on Solaris
• Implemented SDL_TriggerBreakpoint() on aarch64-w64-mingw32

3.2.4

This is a stable bugfix release, with the following changes:

• Fixed decoding 4-bit RLE encoded BMP files
• Fixed setting the position of X11 windows before they're shown
• Fixed D-Pad not working when using SDL2 controller mappings
• Fixed SDL_OpenHapticFromJoystick() not returning a valid haptic handle
• Added SDL_StretchSurface() as a replacement for SDL2 SDL_SoftStretch() and SDL_SoftStretchLinear()
• Fixed several memory leaks

3.2.2

This is a stable bugfix release, with the following changes:

• Fixed mouse motion while the mouse is grabbed on Linux
• Fixed audio gain not applying in some cases
• Fixed a potential crash when applying audio gain
• Removed audio resampling frequency limit
• Fixed a crash on Windows if a tray is created without any menus
• Fixed being able to open BMP files saved with SDL_SaveBMP() on macOS
• Fixed inverted Y axis pen input on macOS
• Allow the window manager to position windows that don't specify a position on Linux

2.30.12

This is a stable bugfix release, with the following changes:

• Improved XInput controller detection on Windows
• Added support for the 8BitDo Ultimate 2C Wireless in Bluetooth mode
• Fixed Steam Deck controller not being visible to games running on Proton 9 and older
• Fixed a crash when hot-plugging keyboards and mice on Linux
• Fixed a crash when disconnecting a Bluetooth audio device on macOS
• Fixed building with Xcode using older Apple SDKs
• Fixed a crash when disconnecting an external display on iOS
• Fixed detection of function keys on Emscripten

3.2.0

Announcing the SDL 3 official release!

SDL 3.0 is finally here!

We have many many people to thank on the road to get here, but I'd like to call out special thanks to:

• @slouken and @icculus, lead developers
• @flibitijibibo, @thatcosmonaut, and @TheSpydog, the GPU API team
• @1bsyl, @0x1F9F1, @Kontrabant, and @Semphriss, for general development and major contributions
• @madebr, our CMake wizard and build guru
• @smcv, for words of wisdom and sanity checks
• @sezero and @Sackzement, for dotting all our i's and crossing all our t's
  ... and literally hundreds of other people who have contributed feedback, pull requests, and bug reports, helping make SDL what it is today.

If you're migrating from SDL2, we've put a comprehensive list of changes and migration tips here:
https://github.com/libsdl-org/SDL/blob/main/docs/README-migration.md

Here are some of the highlights of what's new in SDL 3.0:

• Extremely good documentation: We've spent a ton of effort writing and revising the API reference.
• Example programs to get you started, running in your web browser!
• More consistent API naming conventions. Everything is named consistently across the API now, instead of different subsystems taking different approaches. Also, we've tended toward more descriptive names for things in SDL3.
• Main Callbacks: optionally run your program from callbacks instead of main().
• GPU API: access to modern 3D rendering and GPU compute in a cross-platform way.
• Dialog API: access to system file dialogs (file and folder selection UI for opening/saving).
• Filesystem API: simple directory management and globbing, access to topic-specific user folders.
• Storage API: Abstract interface to platform-specific storage.
• Camera API: access to webcams.
• Pen API: access to pens (like Wacom tablets and Apple Pencil, etc).
• Logical audio devices: different parts of an app can get their own unique audio device to use.
• Audio streams: handle buffering, converting, resampling, mixing, channel mapping, pitch, and gain. Bind to an audio device and go!
• Default audio devices: SDL3 will automatically manage migrating to new physical hardware as devices are plugged in, ripped out, or changed.
• Properties API: fast, flexible dictionaries of name/value pairs.
• Process API: Spawn child processes and communicate with them in various ways.
• Colorspace support: Surfaces and the renderer, etc, can manage multiple colorspaces.
• The Clipboard API can support any data type (SDL2 only handled text), and apps can provide data in multiple formats upon request in a provided callback.
• Better keyboard input, for all your keypress needs.
• Customizable virtual keyboards on iOS and Android.
• High DPI support is dramatically improved over SDL2.
• App metadata API for letting SDL report things about your app correctly (like in the About dialog on macOS, etc).
• and much, much more.

Please let us know what you think, and report any issues on GitHub:
https://github.com/libsdl-org/SDL/issues

3.1.10

This is the first release candidate for the official SDL 3.0 release!

We've gone through and smashed a ton of bugs and updated lots of documentation.
Please read through the installation documentation for the packages below, and check out the updated content on the wiki and let us know what you think!

3.1.8

This is an update to the SDL Stable ABI Preview.

As promised, this update maintains ABI compatibility with 3.1.3, and has lots of bug fixes as we head towards 3.2.0 release. In addition, this update adds asynchronous I/O, main thread dispatching, a desktop tray API, debug text rendering and other features, including the following functions:

SDL_AsyncIOFromFile
SDL_CloseAsyncIO
SDL_CreateAsyncIOQueue
SDL_CreateTray
SDL_CreateTrayMenu
SDL_CreateTraySubmenu
SDL_DestroyAsyncIOQueue
SDL_DestroyTray
SDL_GetAsyncIOResult
SDL_GetAsyncIOSize
SDL_GetCurrentDirectory
SDL_GetThreadState
SDL_GetTrayEntries
SDL_GetTrayEntryChecked
SDL_GetTrayEntryEnabled
SDL_GetTrayEntryLabel
SDL_GetTrayEntryParent
SDL_GetTrayMenu
SDL_GetTrayMenuParentEntry
SDL_GetTrayMenuParentTray
SDL_GetTraySubmenu
SDL_InsertTrayEntryAt
SDL_IsAudioDevicePhysical
SDL_IsAudioDevicePlayback
SDL_IsMainThread
SDL_LoadFileAsync
SDL_ReadAsyncIO
SDL_RemoveTrayEntry
SDL_RenderDebugTextFormat
SDL_RenderTextureAffine
SDL_RunOnMainThread
SDL_SaveFile
SDL_SaveFile_IO
SDL_SetGPUAllowedFramesInFlight
SDL_SetTrayEntryCallback
SDL_SetTrayEntryChecked
SDL_SetTrayEntryEnabled
SDL_SetTrayEntryLabel
SDL_SetTrayIcon
SDL_SetTrayTooltip
SDL_ShowFileDialogWithProperties
SDL_SignalAsyncIOQueue
SDL_WaitAndAcquireGPUSwapchainTexture
SDL_WaitAsyncIOResult
SDL_WaitForGPUSwapchain
SDL_WriteAsyncIO

Cheers!