mirror of
https://github.com/vulkano-rs/vulkano.git
synced 2024-11-22 14:56:42 +00:00
Safe and rich Rust wrapper around the Vulkan API
examples | ||
glsl-to-spirv | ||
vk-sys | ||
vulkano | ||
vulkano-shaders | ||
vulkano-win | ||
.gitlab-ci.yml | ||
.gitmodules | ||
.travis.yml | ||
FEATURES.md | ||
LICENSE-APACHE | ||
LICENSE-MIT | ||
README.md | ||
TROUBLES.md | ||
vkspec.pdf |
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 aroundglslang
.
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.
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.