Files
wgpu/wgpu/examples
Jim Blandy fd22c7f269 Increase max_outliers on wgpu water example reftest. (#2767)
The example says:

    Using AMD RADV POLARIS12 (Vulkan)

The test says:

    thread 'water' panicked at 'Image data mismatch! Outlier count 464 over limit 460. Max difference 213', wgpu/examples/water/../../tests/common/image.rs:134:13

I checked the `water-difference.png` file, and it's just a few dots
here and there. The example seems to run fine.
2022-06-14 00:45:23 -04:00
..
2021-10-07 16:18:09 -04:00
2022-04-15 22:22:48 +03:00

Structure

For the simplest examples without using any helping code (see framework.rs here), check out:

  • hello for printing adapter information
  • hello-triangle for graphics and presentation
  • hello-compute for pure computing

Notably, capture example shows rendering without a surface/window. It reads back the contents and saves them to a file.

All the examples use WGSL shaders unless specified otherwise.

All framework-based examples render to the window and are reftested against the screenshot in the directory.

Feature matrix

Feature boids bunnymark cube mipmap msaa-line shadow skybox texture-arrays water conservative-raster
vertex attributes ⭐ ⭐ ⭐ ⭐ ⭐ ⭐ ⭐
instancing ⭐
lines and points ⭐ ⭐
dynamic buffer offsets ⭐ ⭐
implicit layout ⭐
sampled color textures ⭐ ⭐ ⭐ ⭐ ⭐ ⭐ ⭐ ⭐
storage textures ⭐
comparison samplers ⭐
subresource views ⭐ ⭐
cubemaps ⭐
multisampling ⭐
off-screen rendering ⭐ ⭐ ⭐
stencil testing
depth testing ⭐ ⭐ ⭐
depth biasing ⭐
read-only depth ⭐
blending ⭐ ⭐ ⭐
render bundles ⭐ ⭐
compute passes ⭐
error scopes ⭐
optional extensions ⭐
- SPIR-V shaders
- binding array ⭐
- push constants
- depth clamping ⭐
- compressed textures ⭐
- polygon mode ⭐
- queries ⭐
- conservative rasterization ⭐
integrations
- staging belt ⭐
- typed arena
- obj loading ⭐

Hacking

You can record an API trace any of the framework-based examples by starting them as:

mkdir -p trace && WGPU_TRACE=trace cargo run --features trace --example <example-name>