4 releases (breaking)

new 0.4.0 Mar 22, 2024
0.3.0 Nov 18, 2023
0.2.0 May 31, 2023
0.1.1 Jan 26, 2023
0.1.0 Jan 26, 2023

#483 in Graphics APIs

Download history 14/week @ 2024-02-19 18/week @ 2024-02-26 6/week @ 2024-03-04 16/week @ 2024-03-11 115/week @ 2024-03-18

156 downloads per month
Used in 4 crates

MIT license

2.5MB
9K SLoC

Blade Graphics

Docs Crates.io

Blade-graphics is a lean and mean GPU abstraction aimed at ergonomics and fun. See motivation, FAQ, and performance for details.

Examples

ray-query example particles example

Platforms

The backend is selected automatically based on the host platform:

  • Vulkan on desktop Linux, Windows, and Android
  • Metal on desktop macOS, and iOS
  • OpenGL ES3 on the Web
Feature Vulkan Metal GLES
compute
ray tracing

OpenGL ES

GLES is also supported at a basic level. It's enabled for wasm32-unknown-unknown target, and can also be force-enabled on native:

RUSTFLAGS="--cfg gles" CARGO_TARGET_DIR=./target-gl cargo test

This path can be activated on all platforms via Angle library. For example, on macOS it's sufficient to place libEGL.dylib and libGLESv2.dylib in the working directory.

WebGL2

Following command will start a web server offering the bunnymark example:

cargo run-wasm --example bunnymark

Vulkan Portability

First, ensure to load the environment from the Vulkan SDK:

cd /opt/VulkanSDK && source setup-env.sh

Vulkan backend can be forced on using "vulkan" config flag. Example invocation that produces a vulkan (portability) build into another target folder:

RUSTFLAGS="--cfg vulkan" CARGO_TARGET_DIR=./target-vk cargo test

Dependencies

~5–17MB
~205K SLoC