SDL3-CS
3.2.2-doc
Fixed crash when marshaling returned strings
See the version list below for details.
dotnet add package SDL3-CS --version 3.2.2-doc
NuGet\Install-Package SDL3-CS -Version 3.2.2-doc
<PackageReference Include="SDL3-CS" Version="3.2.2-doc" />
<PackageVersion Include="SDL3-CS" Version="3.2.2-doc" />
<PackageReference Include="SDL3-CS" />
paket add SDL3-CS --version 3.2.2-doc
#r "nuget: SDL3-CS, 3.2.2-doc"
#:package SDL3-CS@3.2.2-doc
#addin nuget:?package=SDL3-CS&version=3.2.2-doc&prerelease
#tool nuget:?package=SDL3-CS&version=3.2.2-doc&prerelease
<p align="center"> <img src="./logo.png?raw=true" alt="SDL3#"> </p>
<h4 align="center">This is SDL3#, a C# wrapper for SDL3.</h4>
<p align="center"> <img alt="GitHub contributors" src="https://img.shields.io/github/contributors/edwardgushchin/SDL3-CS"> <img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/edwardgushchin/SDL3-CS"> <img alt="Static Badge" src="https://img.shields.io/badge/license-zlib-blue"> </p>
<p align="center"> <img alt="Static Badge" src="https://img.shields.io/badge/.NET-7.0,_8.0,_9.0-512BD4"> <img alt="Static Badge" src="https://img.shields.io/badge/Language-C%23_12-239120"> </p>
<p align="center"> <a href="#-about">About</a> • <a href="#-documentation">Documentation</a> • <a href="#-installation">Installation</a> • <a href="#-examples">Examples</a> • <a href="#-readiness">Readiness</a> </p> <p align="center"> <a href="#-feedback-and-contributions">Feedback and Contributions</a> • <a href="#-authors">Authors</a> • <a href="#-license">License</a> </p>
<p align="center">⭐ Star us on GitHub — it motivates us a lot!</p>
🚀 About
SDL3 is still under active development, and the shell follows suit.
For more information on what is currently ready for use, see the <a href="#-readiness">Readiness</a> section.
📚 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
🎓 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 (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 |
🤝 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 | 93 | 11/8/2025 |
| 3.3.2.1 | 3,561 | 10/27/2025 |
| 3.3.2 | 324 | 10/26/2025 |
| 3.2.24.1 | 1,230 | 10/17/2025 |
| 3.2.24 | 786 | 10/5/2025 |
| 3.2.20 | 2,583 | 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 | 727 | 4/1/2025 |
| 3.2.8.3 | 334 | 3/12/2025 |
| 3.2.8.2 | 479 | 3/11/2025 |
| 3.2.8.1 | 286 | 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 mouse motion while the mouse is grabbed on Linux
- Fixed audio gain not applying in some cases
- Fixed a potential crash when applying audio gain
- Removed audio resampling frequency limit
- Fixed a crash on Windows if a tray is created without any menus
- Fixed being able to open BMP files saved with SDL_SaveBMP() on macOS
- Fixed inverted Y axis pen input on macOS
- Allow the window manager to position windows that don't specify a position on Linux