👁 Image
SDL3-CS 3.4.10.2

About

SDL3-CS is a C# wrapper for SDL3. The managed SDL3-CS package contains the C# wrapper, while native binaries are published as platform-specific package families.

Latest Release

Current stable release: SDL3-CS 3.4.10.2.

Documentation

• SDL3-CS Wiki
• SDL3-CS API Reference
• SDL3 upstream wiki
• GitHub Releases

Supported Platforms

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

Installation

Install the managed wrapper:

dotnet add package SDL3-CS

Add the native package family that matches your target platform. For a Windows desktop app:

dotnet add package SDL3-CS.Windows
dotnet add package SDL3-CS.Windows.Image
dotnet add package SDL3-CS.Windows.TTF
dotnet add package SDL3-CS.Windows.Mixer
dotnet add package SDL3-CS.Windows.Shadercross

Replace Windows with Linux, MacOS, Android, iOS, or tvOS.

Android applications use MainActivity : Org.Libsdl.App.SDLActivity, override GetLibraries(), and run SDL from the managed Main() override.

Example

using SDL3;

namespace CreateWindow;

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 renderer: {SDL.GetError()}");
 return;
 }

 SDL.SetRenderDrawColor(renderer, 100, 149, 237, 255);
 SDL.RenderClear(renderer);
 SDL.RenderPresent(renderer);

 SDL.DestroyRenderer(renderer);
 SDL.DestroyWindow(window);
 SDL.Quit();
 }
}

Feedback and Contributions

Open an issue or start a discussion for bugs, ideas, and questions.

See the repository README for the full project overview.