agpu is an abstraction library to the wgpu library, with the goal of providing a GPU framework for both small applications and large engines alike, with minimal boilerplate and maximum readability.
Quick Start
To get started with a program that renders to the screen:
fn main() -> Result<(), agpu::BoxError> {
let program = agpu::GpuProgram::builder().build()?;
let example_pipeline = program.gpu.create_pipeline().build();
program.run_draw(move |mut frame| {
frame
.render_pass("Example render pass")
.with_pipeline(&example_pipeline)
.begin()
.draw_triangle();
})
}
More examples are available in the examples folder.
Goals
- The easiest GPU library
- No loss of API functionality for underlying libraries
- Zero (ideal) runtime cost
Non-goals
- Managed rendering engine
- Adhering strictly to WebGPU standard
State
agpu is in a very early stage of development. It strives to be as stable as the underlying wgpu library, but some features will be incomplete or missing.
The current goal is to replicate all wgpu examples using minimal code.
Style
Builder-style API is used:
- Avoids boilerplate and struct hell
- Allows user to opt-in to functionality
- Using sensible defaults, default constructors are one-liners
Deref is abused(?) to add redundant/convenience functions to wgpu types. This is currently preferred to utility traits that add functions to the underlying types to avoid needing to include various traits that are not used directly.
Integrations
Some integrations are provided as default features to this crate:
You can (not yet!) disable them by opting out of default features, as well as create your own integration using this library.
4 Oct 3, 2022
10 Jun 18, 2023
56 Dec 15, 2022
5 Dec 20, 2021
0 Mar 29, 2022
303 Jan 4, 2023
202 Jan 6, 2023
27 Oct 24, 2022
3 May 10, 2023
1 Oct 13, 2021
1 Nov 13, 2021
2k Jan 6, 2023
2 Jan 26, 2022
8 Dec 16, 2022
4 Feb 11, 2023
22 Nov 2, 2022
10 Nov 30, 2022
40 Oct 2, 2022
7 Nov 2, 2022