Graphix-CS 3.4.16.1

Graphix-CS

Graphix-CS is a packaging fork of SDL3-CS, based on upstream v3.4.16.0 (c1d1cb0da632cb51799da6989f6e48c52f2a539e). The binding and generator source, namespace SDL3, class SDL, and assembly SDL3-CS.dll are unchanged. Original authorship and the zlib license are preserved.

Install Graphix-CS 3.4.16.1 from NuGet.org. Normal restore requires no GitHub authentication, Actions artifact or local package feed. See the fork README for build verification and provenance. Do not reference both Graphix-CS and SDL3-CS in one application.

The package contains no native runtime. Cerneala supplies Graphix.Native 3.4.16-graphix.3 separately for Windows, Linux and macOS on x64 and ARM64. The other native package families and platform tables below refer to the upstream SDL3-CS project; they are not renamed by this fork. Do not combine Graphix.Native with another provider of the same SDL3 native libraries.

Package Versions

This package uses managed package version Graphix-CS 3.4.16.1. The package revision updates public distribution documentation; it does not change the upstream binding/generator source or managed assembly version.

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.

The included callback generator requires a Roslyn 5.9-compatible compiler, such as .NET SDK 10.0.400, even when the application targets an older .NET runtime. Roslyn 5.6 compiler hosts reject this generator with CS9057.

Installation

Install the managed wrapper and the Graphix desktop runtime from NuGet.org:

dotnet add package Graphix-CS --version 3.4.16.1
dotnet add package Graphix.Native --version 3.4.16-graphix.3

Alternatively, choose the upstream native package family that matches your target platform instead of Graphix.Native. For a Windows desktop app using that alternative:

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.

Managed Main Callbacks

For SDL's callback-based application lifecycle, implement SDL.IMainCallbacks<TSelf> and apply [SDL.GenerateMain] to the partial application class:

using SDL3;

[SDL.GenerateMain]
internal sealed partial class Game : SDL.IMainCallbacks<Game>
{
    public static SDL.AppResult AppInit(out Game? appState, string[] args)
    {
        appState = new Game();
        return SDL.AppResult.Continue;
    }

    public SDL.AppResult AppIterate() => SDL.AppResult.Continue;

    public SDL.AppResult AppEvent(ref SDL.Event @event) =>
        (SDL.EventType)@event.Type == SDL.EventType.Quit
            ? SDL.AppResult.Success
            : SDL.AppResult.Continue;

    public void AppQuit(SDL.AppResult result)
    {
    }
}

Graphix-CS supplies the unchanged SDL3-CS source generator through the package's analyzer assets. It creates the entry point and delegates to SDL.RunMainCallbacks<TApp>, which owns the managed/native state lifetime and contains managed exceptions until SDL returns control to the caller.

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.