From db86678809c646e4d8a3900408f6adbae21c267e Mon Sep 17 00:00:00 2001 From: Stephen Gutekanst Date: Fri, 11 Feb 2022 15:06:45 -0700 Subject: [PATCH] gpu-dawn: clarify README Signed-off-by: Stephen Gutekanst --- gpu-dawn/README.md | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/gpu-dawn/README.md b/gpu-dawn/README.md index 9e91c1a2..0909c30b 100644 --- a/gpu-dawn/README.md +++ b/gpu-dawn/README.md @@ -1,6 +1,13 @@ -# mach/gpu-dawn, the easiest way to build Dawn Hexops logo +# mach/gpu-dawn, WebGPU/Dawn built with Zig Hexops logo -`mach/gpu-dawn` is the easiest way to build [Dawn](https://dawn.googlesource.com/dawn/) (Google's WebGPU implementation), requiring nothing more than `zig` and `git` to build and cross-compile static Dawn libraries for every OS. +`mach/gpu-dawn` builds [Dawn](https://dawn.googlesource.com/dawn/) (Google's WebGPU implementation), requiring nothing more than `zig` and `git` to build and cross-compile static Dawn libraries for every OS. + +* No cmake +* No ninja +* No `gn` +* No system dependencies (xcode, etc.) +* Cross compilation supported out of the box +* Builds a single static `libdawn.a` with everything you need. This repository is a separate copy of the same library in the [main Mach repository](https://github.com/hexops/mach), and is automatically kept in sync, so that anyone can use this library in their own project / engine if they like! @@ -8,10 +15,6 @@ This repository is a separate copy of the same library in the [main Mach reposit This package is still under heavy development, Linux and macOS are working but Windows is not yet. -## Zero fuss installation, cross compilation, and more - -[Just as with Mach](https://github.com/hexops/mach#zero-fuss-installation--cross-compilation), you get zero fuss installation & cross compilation using these GLFW bindings. **only `zig` and `git` are needed to build from any OS and produce binaries for every OS.** No system dependencies at all. - ## Zig Dawn/WebGPU interface This package implements the [the `mach/gpu` Zig interface](https://github.com/hexops/mach/tree/main/gpu) which, for Zig developers, allows swapping between WebGPU implementations seamlessly similar to the `std.mem.Allocator` interface.