human9 / gfx-hal-tutorials

A series of small gfx-hal tutorials.

gfx-hal tutorials

This repo will contain a series of self-contained gfx-hal tutorials, hopefully to make it easier to grok how each feature of the API works individually. I'm still learning myself, so they won't be perfect, but hopefully they'll be useful to somebody.

These tutorials all currently use the Metal backend, and so will only run on macOS devices. However, you should be able to quite easily swap out the backend on other platforms. In future, I'll make some modifications to allow them to be cross-platform.

Running tutorials

The following parts are finished:

• cargo run --bin part00-triangle

The following parts should be considered WIP and are likely to change:

• cargo run --bin part01-resizing
• cargo run --bin part02-vertex-buffer
• cargo run --bin part03-uniforms
• cargo run --bin part04-push-constants

Shaders

Shaders are written in GLSL and can be found under source_assets/shaders. The build.rs file in the root compiles them to SPIR-V at build time. (See this post for details.)