Startup Settings

DrawnUI exposes a simple configuration object, DrawnUiStartupSettings, that you pass to UseDrawnUi during app startup. It controls optional behaviors like logging, desktop window sizing, keyboard handling, and a post-initialization callback.

Quick start

using DrawnUi.Draw;

var builder = MauiApp.CreateBuilder();

builder
    .UseMauiApp<App>()
    .UseDrawnUi(new DrawnUiStartupSettings
    {
        // Desktop window sizing (desktop platforms)
        DesktopWindow = new()
        {
            Width = 375,
            Height = 800,
            IsFixedSize = false
        },

        // Provide an ILogger used by Super.Log
        Logger = LoggerFactory.Create(b =>
        {
            b.AddConsole();
            b.SetMinimumLevel(LogLevel.Information);
        }).CreateLogger("DrawnUi"),

        // Optional features
        UseDesktopKeyboard = true,
        MobileIsFullscreen = false,

        // Optional post-initialization hook
        Startup = services =>
        {
            // Run custom code once DrawnUI is initialized
        }
    });

See also: Getting Started → Installation and Setup.

Blazor

Blazor WebAssembly uses a fluent builder returned by Super.UseDrawnUi(builder):

using DrawnUi.Draw;

var builder = WebAssemblyHostBuilder.CreateDefault(args);

await Super.UseDrawnUi(builder)
    .WithBaseUrl(builder.HostEnvironment.BaseAddress) // resolve relative font/asset paths
    .WithOptions(o =>
    {
        o.UseDesktopKeyboard = true;
    })
    .ConfigureFonts(fonts =>
    {
        fonts.AddFont("fonts/OpenSans-Regular.ttf", "FontText", FontWeight.Regular);
        fonts.AddFont("fonts/NotoColorEmoji-Regular.ttf", "FontEmoji");
    })
    .PreloadAssets(assets =>
    {
        assets.AddImage("dotnetbot.png", "images/dotnetbot.png");
    })
    .BuildAndRunAsync();

WithBaseUrl sets the base for resolving relative font and asset paths. Pass builder.HostEnvironment.BaseAddress to resolve paths relative to the Blazor app's deployment root.

WithOptions provides the same DrawnUiStartupSettings properties shown in the MAUI quick start above.

In Blazor, UseDesktopKeyboard attaches browser keydown and keyup listeners and forwards them to KeyboardManager.

.NET / OpenTK

Plain .NET apps and OpenTK window apps use the non-async fluent builder returned by Super.UseDrawnUi() (no host builder argument):

using DrawnUi.Draw;

Super.UseDrawnUi()
    .ConfigureFonts(fonts =>
    {
        fonts.AddFont("fonts/OpenSans-Regular.ttf", "FontText", FontWeight.Regular);
        fonts.AddFont("fonts/NotoColorEmoji-Regular.ttf", "FontEmoji");
    })
    .Build();

// Then open your window (OpenTK) or run headless rendering:
using var window = new MyGameWindow(gameSettings, nativeSettings, canvas);
window.Run();

Call Build() once before creating any DrawnUI canvases or windows. BuildAsync() is also available when async font loading is needed.

Properties

DesktopWindow (WindowParameters?)
- On desktop platforms, sets the window size and optionally locks resizing.
- Typical phone-like layout:
  - Width: 375, Height: 800, IsFixedSize: false
MobileIsFullscreen (bool?)
- If supported by the platform, avoids safe insets and removes some system UI (e.g., status bar) for a more immersive layout.
UseDesktopKeyboard (bool)
- Enables keyboard handling via KeyboardManager.
- MAUI: desktop support on Windows and Mac Catalyst.
- Blazor: browser keyboard events are forwarded to the same API.
Startup (Action)
- Called after DrawnUI is initialized and the MAUI App is created, useful for one-time setup that needs DI services.
- Logger implementing Microsoft.Extensions.Logging.ILogger interface

Logger

The Super helper provide following logging methods:

public static void Log(Exception e, [CallerMemberName] string caller = null)
public static void Log(string message, LogLevel logLevel = LogLevel.Warning, [CallerMemberName] string caller = null)
public static void Log(LogLevel level, string message, [CallerMemberName] string caller = null)

Conventions:

Super.Log(Exception e) logs as Error level
Super.Log(string message) defaults to Warning level
Super.Log(LogLevel level, string message) logs at the specified level