SDL3-CS
3.3.7
See the version list below for details.
dotnet add package SDL3-CS --version 3.3.7
NuGet\Install-Package SDL3-CS -Version 3.3.7
<PackageReference Include="SDL3-CS" Version="3.3.7" />
<PackageVersion Include="SDL3-CS" Version="3.3.7" />
<PackageReference Include="SDL3-CS" />
paket add SDL3-CS --version 3.3.7
#r "nuget: SDL3-CS, 3.3.7"
#:package SDL3-CS@3.3.7
#addin nuget:?package=SDL3-CS&version=3.3.7
#tool nuget:?package=SDL3-CS&version=3.3.7
🚀 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 is compatible. 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. |
-
net10.0
- No dependencies.
-
net7.0
- No dependencies.
-
net8.0
- No dependencies.
-
net9.0
- No dependencies.
NuGet packages (7)
Showing the top 5 NuGet packages that depend on SDL3-CS:
| Package | Downloads |
|---|---|
|
3DEngine
3D Game Engine - Vulkan - SDL3 - .NET 10 - C# 14 |
|
|
StreamLayout
Package Description |
|
|
3DEngine.Window
3D Game Engine - Vulkan - SDL3 - .NET 10 - C# 14 |
|
|
Brine2D.Rendering.SDL
SDL3 rendering implementation for Brine2D. Includes GPU renderer (alpha) and legacy renderer with texture loading, shader support, and TTF text rendering. |
|
|
Brine2D.Audio.SDL
SDL3_mixer audio implementation for Brine2D. Provides sound effects and music playback via SDL3_mixer. |
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.5.0-preview.20260112-122507 | 57 | 1/12/2026 |
| 3.3.7 | 361 | 1/12/2026 |
| 3.3.7-preview.20251222-111333 | 164 | 12/22/2025 |
| 3.3.6 | 1,830 | 12/22/2025 |
| 3.3.5-preview.20251213-114652 | 197 | 12/13/2025 |
| 3.3.5-preview.20251212-135925 | 79 | 12/12/2025 |
| 3.3.5-preview.20251212-134941 | 76 | 12/12/2025 |
| 3.3.3 | 720 | 12/12/2025 |
| 3.3.3-preview.20251204-144801 | 169 | 12/4/2025 |
| 3.3.3-preview.20251108-095121 | 149 | 11/8/2025 |
| 3.3.2.1 | 6,730 | 10/27/2025 |
| 3.3.2 | 361 | 10/26/2025 |
| 3.2.24.1 | 1,254 | 10/17/2025 |
| 3.2.24 | 829 | 10/5/2025 |
| 3.2.20 | 3,197 | 8/5/2025 |
| 3.2.18 | 669 | 7/15/2025 |
| 3.2.16.7 | 270 | 7/10/2025 |
| 3.2.16.6 | 218 | 7/8/2025 |
| 3.2.16.5 | 191 | 7/8/2025 |
| 3.2.16.4 | 279 | 7/1/2025 |
| 3.2.16.3 | 306 | 6/20/2025 |
| 3.2.16.1 | 545 | 6/8/2025 |
| 3.2.16 | 233 | 6/7/2025 |
| 3.2.14.2 | 830 | 5/21/2025 |
| 3.2.14.1 | 231 | 5/19/2025 |
| 3.2.14 | 271 | 5/16/2025 |
| 3.2.12.4 | 294 | 5/14/2025 |
| 3.2.12.3 | 214 | 5/11/2025 |
| 3.2.12.2 | 175 | 5/9/2025 |
| 3.2.12.1 | 608 | 5/8/2025 |
| 3.2.12 | 213 | 5/8/2025 |
| 3.2.10 | 750 | 4/1/2025 |
| 3.2.8.3 | 352 | 3/12/2025 |
| 3.2.8.2 | 588 | 3/11/2025 |
| 3.2.8.1 | 304 | 3/7/2025 |
| 3.2.4.7 | 392 | 3/1/2025 |
| 3.2.4.6 | 548 | 2/18/2025 |