wgpu/deno_webgpu
Nicolas Silva 4c6318c0d2
Expose gpu allocation configuration options (#5875)
* Expose gpu allocation configuration options

This commit adds hints to control memory allocations strategies to the configuration options. These hints allow for automatic profiles such as optimizing for performance (the default, makes sense for a game), optimizing for memory usage (typically more useful for a web browser or UI library) and specifying settings manually.

The details of gpu allocation are still in flux. The goal is to switch vulkan and metal to gpu_allocator which is currently used with d3d12. gpu_allocator will also likely receive more configuration options, in particular the ability to start with smaller memory block sizes and progressively grow the block size. So the manual settings already provision for this upcoming option. Another approach could be to wait and add the manual option after the dust settles.

The reason for providing presets and defining values in the backends is that I am convinced that optimal fonigurations should take hardware capabilities into consideration. It's a deep rabbithole, though, so that will be an exercise for later.

* changelog

* Update CHANGELOG.md

Co-authored-by: Andreas Reich <r_andreas2@web.de>

* Add a comment about not entirely knowing what we are doing

---------

Co-authored-by: Andreas Reich <r_andreas2@web.de>
2024-07-08 14:49:44 +02:00
..
00_init.js chore: update deno (#5469) 2024-04-02 14:36:04 -04:00
01_webgpu.js chore: backport deno changes (#5686) 2024-05-11 09:29:09 +00:00
02_surface.js chore: update deno (#5469) 2024-04-02 14:36:04 -04:00
binding.rs chore: update deno (#5469) 2024-04-02 14:36:04 -04:00
buffer.rs chore: update deno (#5469) 2024-04-02 14:36:04 -04:00
bundle.rs chore: update deno (#5469) 2024-04-02 14:36:04 -04:00
byow.rs chore: backport deno changes (#5686) 2024-05-11 09:29:09 +00:00
Cargo.toml Remove unnecessary Cargo.toml dependencies via cargo machete (#5692) 2024-05-12 19:05:00 -04:00
command_encoder.rs Renderpass take resource ownership (#5884) 2024-07-01 18:36:24 +02:00
compute_pass.rs Make compute pass end consume the pass (#5575) 2024-05-25 18:54:48 +02:00
error.rs introduce MultiError and use it for BGL incompatibility errors 2024-07-02 18:06:19 +02:00
lib.rs Expose gpu allocation configuration options (#5875) 2024-07-08 14:49:44 +02:00
LICENSE.md chore: update deno (#5469) 2024-04-02 14:36:04 -04:00
pipeline.rs remove label getters from Global 2024-07-02 18:06:19 +02:00
queue.rs chore: update deno (#5469) 2024-04-02 14:36:04 -04:00
README.md chore: update deno (#5469) 2024-04-02 14:36:04 -04:00
render_pass.rs Renderpass take resource ownership (#5884) 2024-07-01 18:36:24 +02:00
sampler.rs chore: update deno (#5469) 2024-04-02 14:36:04 -04:00
shader.rs chore: update deno (#5469) 2024-04-02 14:36:04 -04:00
surface.rs chore: update deno (#5469) 2024-04-02 14:36:04 -04:00
texture.rs chore: update deno (#5469) 2024-04-02 14:36:04 -04:00
webgpu.idl Implement Unorm10_10_10_2 VertexFormat (#5477) 2024-04-03 19:43:54 +00:00

deno_webgpu

This op crate implements the WebGPU API as defined in https://gpuweb.github.io/gpuweb/ in Deno. The implementation targets the spec draft as of March 31, 2024. The spec is still very much in flux. This extension tries to stay up to date with the spec, but is constrained by the features implemented in our GPU backend library wgpu.

The spec is still very bare bones, and is still missing many details. As the spec becomes more concrete, we will implement to follow the spec more closely.

In addition, setting the DENO_WEBGPU_TRACE environmental variable will output a wgpu trace to the specified directory.

For testing this op crate will make use of the WebGPU conformance tests suite, running through our WPT runner. This will be used to validate implementation conformance.

GitHub CI doesn't run with GPUs, so testing relies on software like DX WARP & Vulkan lavapipe. Currently, only using DX WARP works, so tests are only run on Windows.

Specification: https://gpuweb.github.io/gpuweb/

Design documents: https://github.com/gpuweb/gpuweb/tree/main/design

Conformance tests suite: https://github.com/gpuweb/cts

WebGPU examples for Deno: https://github.com/crowlKats/webgpu-examples

wgpu-users matrix channel: https://matrix.to/#/#wgpu-users:matrix.org