Guide for using gfx-rs's wgpu library.
Go to file
2022-04-14 16:17:21 -06:00
.cargo more-testing 2022-02-19 12:43:56 -07:00
.github/workflows trying to fix wasm deploy 2021-12-03 12:44:16 -07:00
code fixes #306 2022-04-14 16:17:21 -06:00
docs fixes #337 2022-04-14 14:50:57 -06:00
run-wasm more-testing 2022-02-19 12:43:56 -07:00
.gitignore finally migrated tutorial9 code 2022-02-13 20:19:55 -07:00
build-wasm.sh modified build-wasm.sh to not run wasm-pack in "parallel" 2022-03-26 10:52:34 -06:00
Cargo.lock updated intermediate tutorial docs and removing tutorial13 for maintenance 2022-03-25 17:26:42 -06:00
Cargo.toml more-testing 2022-02-19 12:43:56 -07:00
FEATURES.md some fixes to web 2021-12-03 14:18:06 -07:00
index.template.html wasm is building 2021-10-22 15:55:39 -06:00
LICENSE.md license 2020-09-02 12:59:22 -06:00
package-lock.json Bump url-parse from 1.5.3 to 1.5.10 2022-02-26 19:10:26 +00:00
package.json working on tutorial9 2022-01-25 19:54:21 -07:00
run-all.sh tutorials 1-9 now work with wasm 2022-02-18 13:36:21 -07:00
rustfmt.toml rustfmt 2020-09-27 23:24:43 -06:00
yarn.lock web examples working with vuepress 2022-03-13 17:42:28 -06:00

Introduction

What is wgpu?

Wgpu is a Rust implementation of the WebGPU API spec. WebGPU is a specification published by the GPU for the Web Community Group. It aims to allow web code access to GPU functions in a safe and reliable manner. It does this by mimicking the Vulkan API, and translating that down to whatever API the host hardware is using (ie. DirectX, Metal, Vulkan).

Wgpu is still in development, so some of this doc is subject to change.

Why Rust?

Wgpu actually has C bindings to allow you to write C/C++ code with it, as well as use other languages that interface with C. That being said, wgpu is written in Rust, and it has some convenient Rust bindings that don't have to jump through any hoops. On top of that, I've been enjoying writing in Rust.

You should be fairly familiar with Rust before using this tutorial as I won't go into much detail on Rust syntax. If you're not super comfortable with Rust you can review the Rust tutorial. You should also be familiar with Cargo.

I'm using this project to learn wgpu myself, so I might miss some important details, or explain things badly. I'm always open to constructive feedback.

Contribution and Support

  • I accept pull requests (GitHub repo) for fixing issues with this tutorial such as typos, incorrect information, and other inconsistencies.
  • Due to wgpu's rapidly changing api, I'm not accepting any new pull requests for showcase demos.
  • If you want to support me directly, check out my patreon!

Special thanks to these patrons!

In no particular order

  • Zeh Fernando
  • The toddling chaos
  • Jan Šipr
  • Bernard Llanos
  • Aron Granberg
  • Ian Gowen
  • Paul E Hansen
  • Lennart
  • Gunstein Vatnar
  • David Laban