Files
wgpu/wgpu
Jim Blandy 498842f993 Expect shader_primitive_index tests to fail on AMD RADV. (#2754)
On Fedora, mesa-vulkan-drivers 22.0.3 AMD RADV POLARIS12 just colors
both the NE and SW corners red. There's no blue. (NW and SE are white,
as expected.) I suspect
this means that the primitive ID is always being passed as zero.

This is probably not just due to a difference in rasterization: I
tried enlarging the texture to 4x4 and shifting the triangles to
ensure that there was a pixel in each quadrant that was fully covered.

With Vulkan "llvmpipe (LLVM 14.0.0, 256 bits)", the unmodified test passes.

This is probably limited to Linux, but
`wgpu_tests::common::TestParameters` doesn't have a slot for that.

Fixes #2751.
2022-06-10 15:44:25 -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.

  • WGPU_ADAPTER_NAME

    Select a specific adapter by specifying a substring of the adapter name.

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 GLSL can be enabled by enabling the glsl feature at the cost of slightly increased build times.