Safe and rich Rust wrapper around the Vulkan API
Go to file
2017-01-04 15:43:40 +01:00
examples Examples now use min_image_count-buffering 2017-01-03 22:47:33 +01:00
glsl-to-spirv Update dependency versions 2016-12-07 23:29:15 +02:00
vk-sys Update dependency versions 2016-12-07 23:29:15 +02:00
vulkano Fix off-by-one error when creating queues 2016-12-25 18:08:15 +01:00
vulkano-shaders Disabled broken Clone impl for unsized buffers 2016-12-08 16:17:51 +01:00
vulkano-win Update dependency versions 2016-12-07 23:29:15 +02:00
www Some random work on the tutorial 2016-07-20 12:08:56 +02:00
.gitignore Removed '.intellij' from .gitignore 2016-12-06 21:33:38 +02:00
.gitlab-ci.yml Fix examples so that cargo test works 2016-04-15 18:05:58 +02:00
.gitmodules Make glslang work on Linux 2016-02-19 16:44:35 +01:00
.travis.yml Run doctests on travis 2016-09-20 11:46:00 +02:00
apispec.pdf vkspec.pdf update->1.0.26; added Vulkan apispec.pdf 2016-12-06 23:39:16 +02:00
Cargo.toml Add Cargo workspace file 2016-08-07 14:31:07 +02:00
LICENSE-APACHE Add license everywhere 2016-03-26 10:17:37 +01:00
LICENSE-MIT Add license everywhere 2016-03-26 10:17:37 +01:00
README.md Nvidia problem fixed 2017-01-04 15:43:40 +01:00
TROUBLES.md Add buffer_slice_field! macro 2016-05-02 11:18:26 +02:00
vkspec.pdf vkspec.pdf update->1.0.26; added Vulkan apispec.pdf 2016-12-06 23:39:16 +02:00

Vulkano

Note: requires Rust 1.9. This library would highly benefit from multiple upcoming features in Rust. Therefore it is likely that in the future you will need to update your version of Rust to continue using vulkano.

Vulkano is a Rust wrapper around the Vulkan graphics API. It follows the Rust philosophy, which is that as long as you don't use unsafe code you shouldn't be able to trigger any undefined behavior. In the case of Vulkan, this means that non-unsafe code should always conform to valid API usage.

What does vulkano do?

  • Provides a low-levelish API around Vulkan. It doesn't hide what it does, but provides some comfort types.
  • Plans to prevents all invalid API usages, even the most obscure ones. The purpose of vulkano is not to draw a teapot, but to cover all possible usages of Vulkan and detect all the possible problems. Invalid API usage is prevented thanks to both compile-time checks and runtime checks.
  • Handles synchronization on the GPU side for you, as this aspect of Vulkan is both annoying to handle and error-prone. Dependencies between submissions are automatically detected, and semaphores are managed automatically. The behavior of the library can be customized thanks to unsafe trait implementations.
  • Tries to be convenient to use. Nobody is going to use a library that requires you to browse the documentation for hours for every single operation.

Warning: this library breaks every five minutes for the moment.

Documentation

To get started you are encouraged to read the examples in examples/src/bin, starting with the triangle example.

Structure

This repository contains four libraries:

  • vulkano is the main one.
  • vulkano-shaders can analyse SPIR-V shaders at compile-time.
  • vulkano-win provides a safe link between vulkano and the winit library which can create a window where to render to.
  • glsl-to-spirv can compile GLSL to SPIR-V by wrapping around glslang. glsl-to-spirv is an implementation detail that you don't need to use manually if you use vulkano.

Once procedural macros are stabilized in Rust, the vulkano-shaders crate will be merged with the vulkano crate. The glsl-to-spirv crate is an implementation detail of vulkano and is not supposed to be used directly if you use vulkano. You are, however, free to use it if you want to write an alternative to vulkano.

This crate uses the Cargo workspaces feature that is available only in nightly, and whose purpose is to make several crates share the same target/ directory. It is normal to get an error if you try to run cargo build at the root of the directory.

In order to run tests, go to the vulkano subdirectory and run cargo test. Make sure your Vulkan driver is up to date before doing so.

License

Licensed under either of

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be dual licensed as above, without any additional terms or conditions.