wgpu/README.md

This is an active GitHub mirror of the WebGPU native implementation in Rust, which now lives in Mozilla-central. Issues and pull requests are accepted, but we merge them in m-c manually and then sync to GitHub instead of landing directly here.

---

WebGPU

This is an experimental WebGPU implementation as a native static library. It's written in Rust and is based on gfx-hal and Rendy libraries. The corresponding WebIDL specification can be found at gpuweb project.

The implementation consists of the following parts:

1. wgpu-native - the native implementation of WebGPU as a C API library
2. wgpu-remote - remoting layer to work with WebGPU across the process boundary
3. ffi - the C headers generated by cbindgen for both of the libraries

Supported platforms:

• Vulkan on Windows and Linux
• D3D12 and D3D11 on Windows
• Metal on macOS and iOS

Usage

This repository contains C-language examples that link to the native library targets and perform basic rendering and computation. The prerequisites are a C compiler and GLFW 3 for running the examples.

Running an example

The examples are located under the examples directory. We are using a Makefile for running the examples.

Triangle

make example-triangle

Compute

make example-compute

Remote

make example-remote

The idiomatic Rust wrapper lives in https://github.com/gfx-rs/wgpu-rs and provides a number of more complex examples to get a feel of the API.