Crate simple_wgpu
source ·Expand description
simple-wgpu
An opinionated wrapper around wgpu-rs, that aims to improve the API ergonomics and avoid ongoing issues with rust lifetimes.
I’m a big fan of the write-once-cross-compile-anywhere promise underlying WebGPU, but I’m less of a fan of the API itself. The WebGPU API is modelled on an earlier, pipeline-centric vision of the Vulkan API, and has inherited a degree of verbosity/inflexibility as a result. This library aims to recapture some of the simplicity of writing code for OpenGL - ideally without giving up the safety and stability guarantees of wgpu-rs.
Goals
- Reduce the combinatorial pipeline explosion, along the lines of VK_EXT_extended_dynamic_state
- Workaround lifetime limitations while recording render passes in the wgpu-rs rust API
- Improve DRY (Don’t Repeat Yourself) by eliminating the duplicate specification in bind group/pipeline layout objects
Non-goals
- Performance. I don’t want this wrapper to be slow, but where necessary I will trade performance for ergonomics.
- API Stability (for now). I’m actively iterating on where the boundary between dynamic and baked state should be, as well as whether the more object-oriented wrappers make sense.
Who is it for?
Me, mostly, but if you find it useful, feel free.
License
I’ve put this under the Apache license, but if you need a more permissive license, feel free to get in touch.
Structs
- A handle to a binding group
- Builds a BindGroup
- A handle to a GPU buffer
- A sub-slice of a Buffer
- A color attachment for a RenderPass
- Sets blend modes and color masks for a render target
- Encodes a series of GPU operations
- Record a compute pass
- A compute pipeline
- Builds a ComputePipeline
- A depth/stencil attachment for a RenderPass
- All of the data needed to issue a single compute operation
- All of the data needed to issue a single draw call
- A handle to a compiled shader with a specific main function
- The set of rendering state that is convenient to vary on a per-draw basis
- Record a render pass
- A render pipeline
- Builds a RenderPipeline
- A texture that can be used as a render pass attachment
- A texture sampler
- Builds a Sampler
- A handle to a compiled shader
- A handle to a GPU texture
- Describes the layout of a vertex buffer