wgpu/README.md
2019-07-27 14:26:06 +02:00

2.1 KiB

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

Build Status Crates.io Gitter

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.