mirror of
https://github.com/storytold/wgpu.git
synced 2026-11-20 06:21:13 +01:00
This PR removes all of the `futures` dependencies. `std::future` does not contain a lot of useful helpers available in futures. The obvious ones are `join_all`, `FutureExt::map`, and `block_on`. * `join_all` is replaced with a `Vec<T>` and async blocks. * `FuturesExt::map` in the web backend is replaced by rolling the `map` function into the `MakeSendFuture` type. * `block_on` is provided by `pollster`. The original code using `join_all` ignored the result type yielded by the Future from `map_async`. This code does the same, but makes dropping the result a little more obvious. These should not be troublesome. Figured I would call them out anyway. The last big change is replacing `futures-executor` in the examples with `async-executor`. A new concrete `Spawner` type is used in the example framework instead of an implementation of `futures_task::LocalSpawn`.
Structure
For the simplest examples without using any helping code (see framework.rs here), check out:
hellofor printing adapter informationhello-trianglefor graphics and presentationhello-computefor pure computing
Notably, capture example shows rendering without a surface/window. It reads back the contents and saves them to a file.
All framework-based examples render to the window.
Feature matrix
| Feature | boids | cube | mipmap | msaa-line | shadow | skybox | texture-arrays | water |
|---|---|---|---|---|---|---|---|---|
| vertex attributes | ⭐ | ⭐ | ⭐ | ⭐ | ⭐ | ⭐ | ⭐ | |
| instancing | ⭐ | |||||||
| lines and points | ⭐ | |||||||
| dynamic buffer offsets | ⭐ | |||||||
| implicit layout | ⭐ | |||||||
| sampled color textures | ⭐ | ⭐ | ⭐ | ⭐ | ⭐ | ⭐ | ||
| storage textures | ⭐ | |||||||
| binding array | ⭐ | |||||||
| comparison samplers | ⭐ | |||||||
| subresource views | ⭐ | ⭐ | ||||||
| cubemaps | ⭐ | |||||||
| multisampling | ⭐ | |||||||
| off-screen rendering | ⭐ | ⭐ | ||||||
| stencil testing | ||||||||
| depth testing | ⭐ | ⭐ | ||||||
| depth biasing | ⭐ | |||||||
| read-only depth | ⭐ | |||||||
| blending | ⭐ | ⭐ | ||||||
| render bundles | ⭐ | ⭐ | ||||||
| compute passes | ⭐ | |||||||
| optional extensions | ⭐ | |||||||
| - binding indexing | ⭐ | |||||||
| - push constants | ⭐ | |||||||
| - depth clamping | ⭐ | |||||||
| - BCn compressed textures | ⭐ | |||||||
| - polygon mode | ⭐ | |||||||
| WGSL shaders |
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>