A series of small gfx-hal tutorials.
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets
ci/gfx-master
source_assets/shaders
src
.gitignore
.travis.yml
Cargo.lock
Cargo.toml
DEV.md
README.md
build.rs
run_all.sh

README.md

gfx-hal tutorials

Build Status

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.

Each tutorial is covered by a blog post:

Running tutorials

The following parts are finished:

  • cargo run --bin part00-triangle
  • cargo run --bin part01-resizing
  • cargo run --bin part02-vertex-buffer [teapot]

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

  • cargo run --bin part03-uniforms
  • cargo run --bin part04-push-constants
  • cargo run --bin part05-depth
    • cargo run --bin part05-no-depth
  • cargo run --bin part06-textures

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.)

Contributing

All contributions are welcome. If your change is applicable to multiple non-WIP parts (see above), please make it in all of them. If it's a very significant change, it's probably best to open an issue first so we can discuss it. Other than that, feel free to open a PR.

Thanks to:

  • icefoxen
  • human9

for their contributions!