SDL3-CS 3.4.10.1

SDL3-CS

Modern C# bindings for SDL3 and its companion libraries.

SDL3-CS gives .NET applications direct access to SDL3 APIs and pairs the managed wrapper with platform-specific native runtime packages for Windows, Linux, macOS, Android, iOS, and tvOS.

🚀 About

The project provides:

• managed C# bindings for SDL3, SDL_image, SDL_ttf, SDL_mixer, and SDL_shadercross;
• platform-specific native NuGet packages named SDL3-CS.{Platform} and SDL3-CS.{Platform}.{Addon};
• Android SDLActivity bridge bindings for managed Android applications;
• examples and release checks that validate package layout and wrapper metadata.

Use SDL3-CS when you want low-level SDL3 access from modern .NET while keeping native runtime deployment predictable across supported platforms.

🔢 Versioning and Native Compatibility

SDL3-CS 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-CS package revision.

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

Published NuGet packages can lag behind a release branch while native packages are being assembled. The NuGet package page is authoritative for what is currently published.

📚 Documentation

Project documentation is intended to live in the SDL3-CS Wiki. If the wiki link redirects to the repository home page, use VERSIONS.md, the examples, and the release documentation in the repository until the wiki content is published.

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:

Other platforms can use the managed bindings if the application supplies compatible SDL native libraries manually.

📝 Installation

Install the managed bindings:

dotnet add package SDL3-CS

Add the native package for your target platform:

dotnet add package SDL3-CS.Windows

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

Optional SDL companion libraries use the same platform suffix:

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

Android applications should reference SDL3-CS.Android and use MainActivity : Org.Libsdl.App.SDLActivity with a managed Main() override. The Android package includes the SDL Java bridge bindings and ABI-specific libSDL3.so files.

🎓 Example

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, 255);

        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 in SDL3-CS.Examples.

🤝 Feedback and Contributions

Found a bug or have an idea? Open an issue or start a discussion.

Please follow the Code of Conduct in all project interactions.

You can contact the maintainer at eduardgushchin@yandex.ru or join the Telegram chat for questions and feedback.

📃 License

SDL3 and SDL3# are released under the zlib license. See LICENSE for details.