Safe and rich Rust wrapper around the Vulkan API
Go to file
tomaka a504af40a1 Merge pull request #64 from tomaka/loader
Rework the library loading system
2016-04-28 14:24:05 +02:00
examples Slight fix in examples 2016-04-23 13:33:58 +02:00
glsl-to-spirv Update glslang 2016-04-07 11:40:19 +02:00
vk-sys Rework the library loading system 2016-04-28 13:49:41 +02:00
vulkano Merge pull request #64 from tomaka/loader 2016-04-28 14:24:05 +02:00
vulkano-shaders Correctly set the readonly attribute of descriptor layouts descriptions 2016-04-22 15:15:07 +02:00
vulkano-win Fix vulkano-win for Linux 2016-04-23 13:40:10 +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 Add vulkano-win crate and move out examples 2016-04-23 13:24:56 +02:00
FEATURES.md Fix mistake when deleting submissions 2016-03-28 19:42:26 +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 Some work on README 2016-04-12 18:38:21 +02:00
TROUBLES.md Update troubles list 2016-04-13 11:45:40 +02:00
vkspec.pdf Add the vulkan specs 2016-02-16 15:06:52 +01:00

Vulkano

Note: requires Rust 1.8

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 confort 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

Differences between Vulkan and vulkano

This repository contains three libraries:

  • vulkano is the main one.
  • vulkano-shaders can analyse SPIR-V shaders at compile-time.
  • glsl-to-spirv can compile GLSL to SPIR-V by wrapping around glslang.

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.