Cross-platform, safe, pure-rust graphics api.
Go to file
bors[bot] 64ae59072d
Merge #711
711: Implement Descriptor Array Extension r=kvark a=cwfitzgerald

## Connections

Blocked on https://github.com/gfx-rs/gfx/pull/3269 and does some funky git overrides to get CI to return meaningful results what will be removed once that PR lands and is published.

## Description

This PR implements the `TEXTURE_BINDING_ARRAY` native extension. This allows users to specify a uniform sized array of textures for use in shaders.

As a corollary, this PR rustifies the Bind Group and Bind Group Layout interface. Two main actions were taken when doing this:
 - Types that were able to be shared among wgt, wgc, and wgpu-rs were moved into wgt.
 - Types that had references to other wgpu-rs specific structures were duplicated into wgc with wgpu-rs structures replaced with the appropriate ID. Notes were added to the wgc types that they were duplicated directly from wgpu-rs.

From what I can tell, this resulted in a significant reduction in code complexity when dealing with bind groups, favoring strong types over runtime assertions.

Naga validation of arrays of textures was not implemented.

Documentation was added to extensions to help users understand what underlying tech was being relied on as well as the platforms it should be expected to work on. I think this pattern should be implemented across the board for extensions as it makes them much more user friendly to use.

## Testing

There is an example included in the wgpu-rs PR which was used for testing this feature. It worked on DX12, Vulkan, and Metal (MSL > 2.0), as was expected.

Additionally the other examples were run and are still verified to run.


Co-authored-by: Connor Fitzgerald <connorwadefitzgerald@gmail.com>
2020-06-11 03:36:36 +00:00
.github Switch CI to an older nightly for now, fix templates a bit 2020-05-26 10:01:11 -04:00
player Implement TEXTURE_BINDING_ARRAY extension 2020-06-10 22:35:25 -04:00
wgpu-core Merge #711 2020-06-11 03:36:36 +00:00
wgpu-types Implement TEXTURE_BINDING_ARRAY extension 2020-06-10 22:35: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 Implement TEXTURE_BINDING_ARRAY extension 2020-06-10 22:35:25 -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 Add development matrix 2020-06-03 16:35:03 -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 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