Ahjo.Wgpu 0.6.0

Ahjo.Wgpu

Idiomatic C# wrapper over wgpu-native, the Rust implementation of WebGPU. Built for games: ref struct encoders, readonly struct resource handles, polled futures instead of Task<T>, zero heap allocations on per-frame paths.

Status: pre-1.0. The public surface may shift between 0.x releases as the wrapper fills in remaining wgpu-native coverage. Tag your PackageReference to an exact version.

Install

dotnet add package Ahjo.Wgpu

The native binaries (wgpu_native.dll / libwgpu_native.so / libwgpu_native.dylib) ship inside the Ahjo.Wgpu.Native dependency and land in your bin/ automatically — no native-resolver setup required.

Hello triangle

using WgpuSharp;
using WgpuSharp.Native;

using var instance = Instance.Create();
using var adapter  = instance.RequestAdapterBlocking();
using var device   = adapter.RequestDeviceBlocking();
var queue = device.Queue;

using var encoder = device.CreateCommandEncoder();
// ... create pipeline, begin render pass, draw, submit.
using var cmd = encoder.Finish();
queue.Submit(cmd);

End-to-end examples live in the repo (samples/HelloTriangle, samples/HeadlessTriangle).

Platforms

Runs everywhere wgpu-native does: Windows, Linux, macOS on x64 and arm64. TFM: net10.0.

Design principles

Games-first. Low allocation, raw-pointer friendly, minimal ceremony.

This is an opinionated wrapper over wgpu-native — not a SafeHandle-shaped .NET port. Three load-bearing idioms worth reading about before you build on it:

• Struct handles. Buffer, Texture, Pipeline, etc. are readonly structs holding one raw pointer. Copy-by-value, no finalizer, default(T) is a legal null handle, double-dispose is UB.
• Polled futures. Per-frame async (Buffer.BeginMap, work-done) returns a struct you drive via Instance.ProcessEvents() — no Task<T>, no allocations.
• ref struct encoders + span-parameter descriptors. CommandEncoder, RenderPassEncoder, ComputePassEncoder don't escape methods; spans live on method parameters, not descriptor fields, to keep escape-analysis happy.

Full user guide: docs/using-the-wrapper.md. Contributor-side design rationale: CLAUDE.md.

Repository

Source, issues, samples: https://github.com/pekkah/wgpu-sharp

License

MIT. © Pekka Heikura.