/wgpu-rs

Rust bindings to wgpu native library

Primary LanguageRustMozilla Public License 2.0MPL-2.0

wgpu-rs

Build Status Crates.io Gitter

This is an idiomatic Rust wrapper over wgpu-native. It's designed to be suitable for general purpose graphics and computation needs of Rust community. It currently only works for the native platform, in the future aims to support WASM/Emscripten platforms as well.

Gallery

Cube Shadow MipMap vange-rs Brawl GLX map

Usage

The library requires one of the following features enabled in order to run any of the examples:

  • Vulkan
  • Metal
  • DirectX 12 (Dx12)
  • DirectX 11 (Dx11)
  • OpenGL (Gl)

These examples assume that necessary dependencies for the graphics backend are already installed.

Running an example

All examples are located under the examples directory. We are using the default syntax for running examples, as found in the Cargo documentation.

Cube

cargo run --example cube --features metal
cargo run --example cube --features vulkan
cargo run --example cube --features dx12
cargo run --example cube --features dx11
cargo run --example cube --features gl

Hello Compute

The "1", "2", "3", and "4" are arguments passed into the program. These arguments are used for the compute pipeline.

cargo run --example hello-compute --features metal 1 2 3 4
cargo run --example hello-compute --features vulkan 1 2 3 4
cargo run --example hello-compute --features dx12 1 2 3 4
cargo run --example hello-compute --features dx11 1 2 3 4
cargo run --example hello-compute --features gl 1 2 3 4

More examples can be found under the examples directory.

Friends

Shout out to the following projects that work best with wgpu-rs: