SDL3-CS

C# bindings for the SDL3 family of libraries.

Product	Usage	Package
SDL	dotnet add package ppy.SDL3-CS
SDL_image	dotnet add package ppy.SDL3_image-CS
SDL_ttf	dotnet add package ppy.SDL3_ttf-CS
SDL_mixer	dotnet add package ppy.SDL3_mixer-CS

Contributions to keep the bindings up-to-date with upstream changes are welcome. If you have improvements or updates, feel free to submit a pull request.

Platform support

Product	win-x64	win-x86	win-arm64	osx-arm64	osx-x64	linux-x64	linux-x86	linux-arm64	linux-arm	ios	android
SDL3-CS	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
SDL3_image-CS	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
SDL3_ttf-CS	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
SDL3_mixer-CS	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	API 24+

How to update SDL

1. Ensure all submodules are correctly initialised:

   git submodule update --init --recursive

2. Check out submodules at new desired upstream commits.
3. Regenerate C# bindings via:

   docker build -t 'sdl-gen' .
   docker run --rm -v .:/app -w /app -it sdl-gen

4. Run the "Build Native" (.github/workflows/build.yml) workflow to generate platform binaries.

License

This code is released under MIT.