SDL3-CS
3.2.24.1
See the version list below for details.
dotnet add package SDL3-CS --version 3.2.24.1
NuGet\Install-Package SDL3-CS -Version 3.2.24.1
<PackageReference Include="SDL3-CS" Version="3.2.24.1" />
<PackageVersion Include="SDL3-CS" Version="3.2.24.1" />
<PackageReference Include="SDL3-CS" />
paket add SDL3-CS --version 3.2.24.1
#r "nuget: SDL3-CS, 3.2.24.1"
#:package SDL3-CS@3.2.24.1
#addin nuget:?package=SDL3-CS&version=3.2.24.1
#tool nuget:?package=SDL3-CS&version=3.2.24.1
🚀 About
This is SDL3#, a C# wrapper for SDL3.
📚 Documentation
For more information about SDL3, visit the SDL wiki.
📝 Installation
git clone https://github.com/edwardgushchin/SDL3-CS
cd SDL3-CS
dotnet build -c Release
or
dotnet add package SDL3-CS
Optional:
dotnet add package SDL3-CS.Native
dotnet add package SDL3-CS.Native.Image
dotnet add package SDL3-CS.Native.TTF
dotnet add package SDL3-CS.Native.Mixer
🎓 Examples
using SDL3;
namespace Create_Window;
internal static class Program
{
[STAThread]
private static void Main()
{
if (!SDL.Init(SDL.InitFlags.Video))
{
SDL.LogError(SDL.LogCategory.System, $"SDL could not initialize: {SDL.GetError()}");
return;
}
if (!SDL.CreateWindowAndRenderer("SDL3 Create Window", 800, 600, 0, out var window, out var renderer))
{
SDL.LogError(SDL.LogCategory.Application, $"Error creating window and rendering: {SDL.GetError()}");
return;
}
SDL.SetRenderDrawColor(renderer, 100, 149, 237, 0);
var loop = true;
while (loop)
{
while (SDL.PollEvent(out var e))
{
if ((SDL.EventType)e.Type == SDL.EventType.Quit)
{
loop = false;
}
}
SDL.RenderClear(renderer);
SDL.RenderPresent(renderer);
}
SDL.DestroyRenderer(renderer);
SDL.DestroyWindow(window);
SDL.Quit();
}
}
More examples can be found here.
✅ Readiness
| Library | Stage |
|---|---|
| SDL3 |  |
| SDL_image | |
| SDL_mixer | |
| SDL_tff | |
| SDL_shadercross | |
🤝 Feedback and Contributions
Do you have an idea or found a bug? Please open an issue or start a discussion.
Please note we have a code of conduct, please follow it in all your interactions with the project.
If you have any feedback, please reach out to us at eduardgushchin@yandex.ru.
We also have a chat in Telegram, where I am ready to answer any of your questions.
💻 Authors
- Eduard Gushchin - Initial work - edwardgushchin
See also the list of contributors who participated in this project.
📃 License
SDL3 and SDL3# are released under the zlib license. See LICENSE for details.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net7.0
- No dependencies.
-
net8.0
- No dependencies.
-
net9.0
- No dependencies.
NuGet packages (2)
Showing the top 2 NuGet packages that depend on SDL3-CS:
| Package | Downloads |
|---|---|
|
3DEngine
3D Game Engine - Vulkan - SDL3 - .NET 10 - C# 14 |
|
|
3DEngine.Window
3D Game Engine - Vulkan - SDL3 - .NET 10 - C# 14 |
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on SDL3-CS:
| Repository | Stars |
|---|---|
|
Valkirie/HandheldCompanion
ControllerService
|
| Version | Downloads | Last Updated |
|---|---|---|
| 3.3.3-preview.20251108-095121 | 98 | 11/8/2025 |
| 3.3.2.1 | 4,208 | 10/27/2025 |
| 3.3.2 | 327 | 10/26/2025 |
| 3.2.24.1 | 1,231 | 10/17/2025 |
| 3.2.24 | 786 | 10/5/2025 |
| 3.2.20 | 2,722 | 8/5/2025 |
| 3.2.18 | 639 | 7/15/2025 |
| 3.2.16.7 | 249 | 7/10/2025 |
| 3.2.16.6 | 200 | 7/8/2025 |
| 3.2.16.5 | 173 | 7/8/2025 |
| 3.2.16.4 | 260 | 7/1/2025 |
| 3.2.16.3 | 289 | 6/20/2025 |
| 3.2.16.1 | 528 | 6/8/2025 |
| 3.2.16 | 208 | 6/7/2025 |
| 3.2.14.2 | 777 | 5/21/2025 |
| 3.2.14.1 | 216 | 5/19/2025 |
| 3.2.14 | 247 | 5/16/2025 |
| 3.2.12.4 | 273 | 5/14/2025 |
| 3.2.12.3 | 199 | 5/11/2025 |
| 3.2.12.2 | 157 | 5/9/2025 |
| 3.2.12.1 | 590 | 5/8/2025 |
| 3.2.12 | 191 | 5/8/2025 |
| 3.2.10 | 728 | 4/1/2025 |
| 3.2.8.3 | 335 | 3/12/2025 |
| 3.2.8.2 | 483 | 3/11/2025 |
| 3.2.8.1 | 287 | 3/7/2025 |
| 3.2.4.7 | 375 | 3/1/2025 |
| 3.2.4.6 | 519 | 2/18/2025 |
This is a stable bugfix release, with the following changes:
- Fixed a crash at startup on some installations of macOS
- Fixed the reported fullscreen window position on MacBooks with a camera notch
- Fixed Android applications losing vsync when being resumed
- Fixed SDL_RunOnMainThread() on Android when using SDL_WaitEvent()
- Fixed a crash when enumerating Steam Controllers
- Fixed rumble strength on DualSense Edge and Bluetooth connected controllers
- Fixed the HP Deluxe Webcam KQ246AA being detected as joystick
- Disable Windows.Gaming.Input by default, this functionality is already covered by other APIs
- Use the correct controller name on iOS
- Enabled high refresh rates on iOS when using main callbacks
- Fixed VMware not capturing the mouse when relative mode is enabled
- Increased the maximum color target bindings from 4 to 8 in the GPU API
- When using SDL_SetRenderLogicalPresentation(), letterboxing now uses the clear color instead of black
- Fixed crash at startup when redirecting X11 output over ssh
- Fixed a memory leak when using detached threads