Announcing the SDL 3 official release!

slouken · January 21, 2025, 7:32pm

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:

libsdl-org/SDL/blob/main/docs/README-migration.md

# Migrating to SDL 3.0

This guide provides useful information for migrating applications from SDL 2.0 to SDL 3.0.

Details on API changes are organized by SDL 2.0 header below.

The file with your main() function should include <SDL3/SDL_main.h>, as that is no longer included in SDL.h.

Functions that previously returned a negative error code now return bool.

Code that used to look like this:
```c
    if (SDL_Function() < 0 || SDL_Function() == -1) {
        /* Failure... */
    }
```
or
```c
    if (SDL_Function() == 0) {
        /* Success... */

This file has been truncated. show original

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:

sjr · January 22, 2025, 7:03am

This is fantastic news! Congratulations to @slouken, @icculus, and everyone else!

slouken · February 2, 2025, 1:39am

Our first SDL3 update has been released!

We’re happy, this has been a very smooth release and this update is small with only a few important bug fixes.

slouken · February 7, 2025, 12:38am

A minor update with bug fixes has been released:

Mathias · February 7, 2025, 4:39pm

Fixed setting the position of X11 windows before they’re shown

I just tried it with 3.2.4 and the developer version. In both cases the window pops up briefly in a different location before moving.
Tested with Linux Mint 64bit and X11.

    SDL_init(SDL_INIT_VIDEO);
    win := SDL_CreateWindow('SDL3 Window', 640, 480, SDL_WINDOW_RESIZABLE);
    SDL_SetWindowPosition(win, 500, 500);    
    SDL_Log('Version: %s', SDL_GetRevision);

slouken · February 7, 2025, 5:18pm

The default state for newly created windows is shown, so it’s showing it with an initial position and then you’re moving it. If you want to create it hidden, add SDL_WINDOW_HIDDEN to your creation flags.

Mathias · February 7, 2025, 6:21pm

The default state for newly created windows is shown, so it’s showing it with an initial position and then you’re moving it. If you want to create it hidden, add SDL_WINDOW_HIDDEN to your creation flags.

I’ve tried it with Hidden, but it still pops up briefly. If I add SDL_Delay, the window still pops up briefly in the wrong place, albeit delayed by a second.

    SDL_init(SDL_INIT_VIDEO);
    win := SDL_CreateWindow('SDL3 Window', 640, 480, SDL_WINDOW_RESIZABLE or SDL_WINDOW_HIDDEN);
    SDL_SetWindowPosition(win, 500, 500);
    SDL_Delay(1000);
    SDL_ShowWindow(win);
    SDL_Log('Version: %s', SDL_GetRevision);

slouken · February 7, 2025, 10:07pm

Go ahead and enter a bug report:

Mathias · February 8, 2025, 7:58am

Go ahead and enter a bug report:

github.com/libsdl-org/SDL

[SDL 3.2.4 - Linux 64bit X11] SDL_SetWindowPosition failure

opened 07:56AM - 08 Feb 25 UTC

sechshelme

In the following test program, the window pops up briefly at the default locatio…n before jumping to the position specified with `SDL_SetWindowPosition`. I only added the delay as a test to see if that was the cause. ```c // gcc main.c -o main -lSDL3 #include <SDL3/SDL.h> int main(int argc, char *argv[]) { int quit = 0; SDL_Window *win = SDL_CreateWindow("SDL3 Window", 640, 480, SDL_WINDOW_RESIZABLE | SDL_WINDOW_HIDDEN); SDL_SetWindowPosition(win, 500, 500); SDL_Delay(1000); // with test SDL_ShowWindow(win); SDL_Log("Version: %s", SDL_GetRevision()); SDL_Renderer *renderer = SDL_CreateRenderer(win, NULL); while (!quit) { SDL_Event ev; while (SDL_PollEvent(&ev) != 0) { switch(ev.type) { case SDL_EVENT_QUIT: quit = 1; break; } } SDL_SetRenderDrawColor(renderer, 20, 0, 0, 255); SDL_RenderClear(renderer); SDL_RenderPresent(renderer); } SDL_DestroyRenderer(renderer); SDL_DestroyWindow(win); SDL_Quit(); return 0; } ```