Cross-platform, safe, pure-rust graphics api.
Go to file
bors[bot] ac9587e9ce
Merge #696
696: Rustification of Extensions and SamplerDescriptor r=kvark a=cwfitzgerald

**Connections**

This begins the rustificaiton of `wgpu-types` as discussed in #689, starting with `Extensions` and `SamplerDescriptor`.

#691 and the resulting discussion was used to advise the shape of the extension struct.

**Description**

The PR should be fairly straight forward. As discussed, I have left extensions as a bitflag until the webgpu-native issue can be opened and discussed regarding allocation of extensions.

The most controversial part of this will be the `AnisotropyLevel` enum. I created it for two reasons, one that matters, one that doesn't:
 - It means that, with the exception of enabling the aniso extension (and lod_bias), the sampler is correct by construction, which is helpful to both beginners and experts. It also better exposes the range of valid values and means less panics in user code.
 - It saves a byte in the `Option<u8>` 😄 

I definitely think that, if at all possible, we should have explicitly typed enums for "numbers" which have a limited amount of valid values (so _not_ lod bias, though that may be better expressed, idk) to make it very explicit which values can be accepted. This also feels more "rusty" and reduces the amount of "magicness" in the interface.

Ofc, I'm not married to the idea.

**Testing**

Follow up PR into wgpu-rs will include conversion of the examples.

**TODO**

- [x] wgpu-native pr rolling up this PR and #690 (https://github.com/gfx-rs/wgpu-native/pull/34)
- [x] wgpu-rs pr updating examples with the new structures (https://github.com/gfx-rs/wgpu-rs/pull/345)

Co-authored-by: Connor Fitzgerald <connorwadefitzgerald@gmail.com>
2020-06-03 01:34:22 +00:00
.github Switch CI to an older nightly for now, fix templates a bit 2020-05-26 10:01:11 -04:00
player player: enable x11 on Unix/Vulkan 2020-06-01 16:54:40 -04:00
wgpu-core Rustification of Extensions and SamplerDescriptor 2020-06-02 21:04:25 -04:00
wgpu-types Rustification of Extensions and SamplerDescriptor 2020-06-02 21:04:25 -04:00
.gitignore trace: replaying all the commands 2020-04-30 09:55:52 -04:00
bors.toml Android support (#625) 2020-05-01 00:22:00 -04:00
Cargo.lock player: enable x11 on Unix/Vulkan 2020-06-01 16:54:40 -04:00
Cargo.toml trace: player skeleton 2020-04-30 09:55:52 -04:00
CHANGELOG.md use unambigous ISO8601 format for dates 2020-05-12 16:06:19 -07:00
LICENSE Initial commit 2018-09-13 15:18:51 -04:00
logo.png Update logo and move bindings section 2020-03-03 00:10:04 -03:30
README.md Small readme refactor 2020-05-15 10:41:28 -04:00
rustfmt.toml Rustfmt stable pass 2020-04-06 08:55:39 -04:00

This is an active GitHub mirror of the WebGPU implementation in Rust, which now lives in "gfx/wgpu" of Mozilla-central. Issues and pull requests are accepted, but some bidirectional synchronization may be involved.

WebGPU

Matrix Build Status

This is the core logic of an experimental WebGPU implementation. It's written in Rust and is based on gfx-hal with help of gfx-extras. See the upstream WebGPU specification (work in progress).

The implementation consists of the following parts:

  • Crates.io docs.rs - internal Rust API for WebGPU implementations to use
  • Crates.io docs.rs - Rust types shared between wgpu-core, wgpu-native, and wgpu-rs
  • player - standalone application for replaying the API traces, uses winit

This repository contains the core of wgpu, and is not usable directly by applications. If you are looking for the user-facing Rust API, you need wgpu-rs. If you are looking for the native implementation or bindings to the API in other languages, you need wgpu-native.

Supported Platforms

API Windows 7/10 Linux & Android macOS & iOS
DX11
DX12 ✔️
Vulkan ✔️ ✔️
Metal ✔️
OpenGL 🚧 🚧 🚧

✔️ = Primary support — = Secondary support — 🚧 = Unsupported, but support in progress