Gondwana.Blazor 2.5.2

Gondwana.Blazor

Gondwana.Blazor provides Blazor adapters for rendering and input, enabling Gondwana games to run as ASP.NET Blazor WebAssembly applications with standard cross-platform WASM support.

It mirrors the Gondwana.Avalonia package but targets the Blazor component model instead of Avalonia UI.

Features

• Bitmap rendering surface using a browser <canvas> element via the Canvas 2D API (no platform-specific SkiaSharp view package required)
• Keyboard input integration via Blazor keyboard events on the canvas element
• Mouse / pointer input integration
• Touch input integration
• BlazorKey enum mapping browser KeyboardEvent.code values to integer key codes

Installation

dotnet add package Gondwana.Blazor

Usage

Add <BlazorBitmapRenderSurfaceComponent> to your Blazor page or layout and capture a reference to it using @ref:

@using Gondwana.Blazor.Rendering

<BlazorBitmapRenderSurfaceComponent @ref="_surface" style="width: 800px; height: 600px;" />

Then initialize your game host in the component's OnAfterRenderAsync:

@code {
    private BlazorBitmapRenderSurfaceComponent _surface = null!;
    private MyGameHost? _host;

    protected override async Task OnAfterRenderAsync(bool firstRender)
    {
        if (!firstRender) return;
        _host = new MyGameHost(_surface);
        _host.Initialize();
    }
}

Key codes

BlazorKeyboardAdapter uses (int)BlazorKey values as key codes. Use BlazorKeyboardAdapter.GetKeyCodeFromString("ArrowLeft") to resolve a key name at runtime, or use the BlazorKey enum directly:

Engine.Instance.Input.KeyboardEventPoller!.StartMonitoringKey(
    (int)BlazorKey.Space, "Jump");

Touch input

Enable touch input by calling InitializeBlazorTouchAdapter:

Engine.Instance.InitializeBlazorTouchAdapter(renderSurface);

After initialization, the touch system is accessible via Engine.Instance.Input.TouchEventPoller.

Documentation

• Source Code
• Architecture & Guides
• API Reference (Doxygen)
• Release History

Related Packages

• Gondwana --- Core engine
• Gondwana.Audio.Browser --- Browser-based audio playback support
• Gondwana.Blazor.Hosting --- Blazor-specific game host that integrates rendering and input into the Gondwana lifecycle
• Gondwana.Widgets --- UI widget library for creating in-game menus, HUDs, and overlays

License

MIT