edwardgushchin /SDL3-CS

Modern C# bindings and native NuGet packages for SDL3 and its companion libraries.

★ 301⑂ 36👁 1⑃ 180● 132▤ 19
下载:SDL3-CS 3.4.20.0SDL3-CS-3.4.20.0 ↓3.4.20.02026-11-06
+1
日增长
301
stars
36
forks
1
watchers
180
prs
132
issues
19
releases

README

Modern C bindings for SDL3 and its companion libraries.


  Build cross-platform .NET applications with SDL3, SDL_image, SDL_ttf, SDL_mixer, and SDL_shadercross.



  
    
  
  
    
  
  
    
  
  
  
  



  
  
  
  



  
  
  
  
  
  



  About -
  Versioning -
  Documentation -
  Platforms -
  Installation -
  Examples -
  Projects -
  Feedback -
  License


⭐ Star us on GitHub - it motivates us a lot!

 🚀 About

SDL3 is a C wrapper and native package set for SDL3. It gives .NET applications direct access to SDL3 APIs while keeping native runtime distribution predictable across desktop, mobile, and Apple TV targets.

The repository contains:

- managed C bindings for SDL3, SDL_image, SDL_ttf, SDL_mixer, and SDL_shadercross;
- platform-specific native NuGet packages for Windows, Linux, macOS, Android, iOS, and tvOS;
- Android SDLActivity bridge bindings for managed Android applications;
- examples that cover window creation, rendering, input, audio, images, fonts, GPU usage, and mobile app setup;
- release tooling and tests that validate package layout, native assets, and wrapper metadata.

SDL3 is intended for developers who want low-level SDL3 access from modern .NET without maintaining a separate native binary distribution pipeline for every supported platform.

 🔢 Versioning and Native Compatibility

SDL3 package versions follow the native SDL component versions. The first three version segments identify the upstream native component version. The final segment is the SDL3 package revision and may contain binding, packaging, or documentation fixes.

This source tree targets the following release lines:

| Component | Package pattern | Native target | Package line |
|-----------|-----------------|---------------|--------------|
| SDL3 managed bindings | SDL3-CS | SDL 3.4.20 | 3.4.20.x |
| SDL3 native runtime | SDL3-CS.{Platform} | SDL 3.4.20 | 3.4.20.x |
| SDL_image native runtime | SDL3-CS.{Platform}.Image | SDL_image 3.4.8 | 3.4.8.x |
| SDL_ttf native runtime | SDL3-CS.{Platform}.TTF | SDL_ttf 3.2.2 | 3.2.2.x |
| SDL_mixer native runtime | SDL3-CS.{Platform}.Mixer | SDL_mixer 3.2.4 | 3.2.4.x |
| SDL_shadercross native runtime | SDL3-CS.{Platform}.Shadercross | SDL_shadercross 3.0.0 | 3.0.0.x |

{Platform} is one of Windows, Linux, MacOS, Android, iOS, or tvOS.

Published NuGet packages can lag behind the development state in main while native packages are being assembled. The NuGet badge, package pages, and GitHub Releases are authoritative for what is currently published.

 📚 Documentation

Project documentation lives in the SDL3-CS Wiki. Use the wiki, examples, and GitHub Releases for version notes, migration guidance, platform details, and release documentation.

For upstream SDL API documentation, see the official SDL3 Wiki.

 🧭 Supported Platforms

The managed SDL3-CS wrapper targets .NET 7, .NET 8, .NET 9, and .NET 10.

Official native package families are built for the following release targets:

| Platform family | Package su

Top issues

Discussions

Latest release

SDL3-CS 3.4.20.0 v3.4.20.0 2026-11-06
Стабильный выпуск SDL3-CS для SDL 3.4.20.

 Версии пакетов

| Семейство пакетов | Версия |
|------------------|--------|
| SDL3-CS | 3.4.20.0 |
| SDL3-CS. | 3.4.20.0 |
| SDL3-CS..Image | 3.4.8.1 |
| SDL3-CS..Mixer | 3.2.4.15 |
| SDL3-CS..TTF | 3.2.2.15 |
| SDL3-CS..Shadercross | 3.0.0.15 |

 Изменения

- Native SDL закреплён на точном upstream release-3.4.20, commit f00dc919ca35b9756316e86c4777392de442f9b2. Выпуск исправляет работу мыши, clipboard, Vulkan, контроллеров и мобильных платформ; полный список upstream.
- Добавлен SDL.Hints.PS2GSColorDepth; XML документация audio и k

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON