Files
wgpu/wgpu
Alex S 2828100143 Reduce feature flag surface for descriptor arrays.
DYNAMIC_INDEXING is checked by default, since WGPU doesn't allow
for any kind of specialization constants and constant indexing is
nigh useless.

STORAGE_RESOURCE_BINDING_ARRAY is enabled iff the device supports:
- both or neither of uniform and buffer arrays with dynamic indexing;
- both or neither of sampled and storage images with dynamic indexing.

NONUNIFORM_INDEXING is enabled iff for ALL types of descriptor arrays
*that are supported for dynamic indexing*, nonuniform indexing is
also allowed.

These flags have a limitation in that some platforms
(eg.
https://vulkan.gpuinfo.org/displayreport.php?id=11692#features_core_12)
may support a strange subset of those features (example device
supporting non-uniform indexing for textures and storage buffers,
but NOT for storage textures or uniform buffers). In that case feature
will be reported as missing, even though it is partially present.

In the author's opinion, this flag set is convenient for the
users to query; however, due to aforementioned limitations, it would be
desirable to obtain statistics about "edge-case" platforms and what
percentage of reports they comprise.
2021-06-28 14:44:00 +03:00
..
2021-06-23 20:51:24 -04:00
2021-06-27 01:44:49 -04:00

wgpu-rs is an idiomatic Rust wrapper over wgpu-core. It's designed to be suitable for general purpose graphics and computation needs of Rust community.

wgpu-rs can target both the natively supported backends and WASM directly.

See our gallery and the wiki page for the list of libraries and applications using wgpu-rs.

Usage

How to Run Examples

All examples are located under the examples directory.

These examples use the default syntax for running examples, as found in the Cargo documentation. For example, to run the cube example:

cargo run --example cube

The hello* examples show bare-bones setup without any helper code. For hello-compute, pass 4 numbers separated by spaces as arguments:

cargo run --example hello-compute 1 2 3 4

The following environment variables can be used to configure how the framework examples run:

  • WGPU_BACKEND

    Options: vulkan, metal, dx11, dx12, gl, webgpu

    If unset a default backend is chosen based on what is supported by your system.

  • WGPU_POWER_PREF

    Options: low, high

    If unset a low power adapter is preferred.

Run Examples on the Web (wasm32-unknown-unknown)

See wiki article.

Shaders

WGSL is the main shading language of WebGPU.

Users can run the naga binary in the following way to convert their SPIR-V shaders to WGSL:

cargo run -- <input.spv> <output.wgsl>

In addition, SPIR-V can be used by enabling the spirv feature, and the cost of slightly increased build times.