Expand description
Vulkan API bindings
Take a look at the erupt
user guide.
Features
- Full Vulkan API coverage
- First-class support for all extensions
- High quality auto-generated function wrappers
- A utility module aiding your use of this crate
VulkanResult
: Idiomatic wrapper around a Vulkan Resultsurface
: Create aSurfaceKHR
using aRawWindowHandle
(adapted fromash-window
)
- Generated code distributed into multiple modules
- Function loading (
EntryLoader
,InstanceLoader
,DeviceLoader
) - Seperate
Flags
andFlagBits
types - A high level
Builder
for every struct - Type-safe pointer chain support
Default
andDebug
implementation for every type- Confirmed support for Linux, Windows, macOS and Android
- Complete auto-generation of everything except
utils
Example: Instance Creation
use erupt::{vk, EntryLoader, InstanceLoader};
let entry = EntryLoader::new()?;
let app_info = vk::ApplicationInfoBuilder::new()
.api_version(vk::API_VERSION_1_1);
let instance_info = vk::InstanceCreateInfoBuilder::new()
.application_info(&app_info);
let instance = InstanceLoader::new(&entry, &instance_info)?;
// ...
instance.destroy_instance(None);
Additional examples
Cargo Features
surface
(enabled by default): Enables thesurface
module, addsraw-window-handle
dependencyloading
(enabled by default): Enables theEntryLoader::new
function, addslibloading
dependencybytemuck
: ImplementsPod
for some hand-picked structs (*IndirectCommand
, etc.), addsbytemuck
dependency
FAQ
Q: What’s the difference between this, ash and vulkano?
A: Vulkano is special because it provides hand-written Vulkan wrappers, which means that for example
it has a special hand-written wrapper around a Vulkan PhysicalDevice
. On the other hand ash and
erupt both provide Vulkan API bindings too, but not exposing such fancy wrappers and instead
focusing on having good bindings to the raw Vulkan API.
The big selling points of erupt is that it has better documentation, high level function support for all extensions (which is only really relevant if you use those extensions), being fully generated and some more smaller improvements. On the other hand ash has a bigger existing community.
Q: What does the number at the end of the version mean?
A: It represents the Vulkan Header version this version of erupt was generated against and is purely informational.
Ecosystem
Initialization
erupt-bootstrap
: Vulkan Bootstrapping library, inspired by vk-bootstrap
Memory Allocation
gpu-alloc
: Rust-native, used interally bywgpu
vk-alloc
: Rust-nativevk-mem-erupt
: Bindings to the C++ Vulkan Memory Allocator (VMA) library
Minimum Supported Rust Version (MSRV)
Rust 1.48 or higher.
Thank you
ash
for helping inspiring and making this cratelibloading
for providing symbol loadingash-window
for providing a base for thesurface
modulebitflags
for providing a perfect bitflag macro- The Vulkan Community ❤️
- The Rust Community ❤️
Licensing
The logo is the Volcano Emoji of Twemoji (License). The name “erupt” was added on top of it.
This project is licensed under the zlib License.
Re-exports
pub use utils::loading::EntryLoader;
Modules
Provides Vulkan extension items.
Provides external library items.
Utilities to aid your usage of this crate.
Re-exports every Vulkan item.
Provides Vulkan feature items.
Provides Vulkan feature items.
Provides Vulkan feature items.
Provides Vulkan feature items.
Macros
Construct a *const std::os::raw::c_char
from a string.
Like try!
, but for utils::VulkanResult
.
Structs
Loader for entry commands.
A list of requirements enabled in the device loader.
Loader for device commands.
Builder for an device loader.
A list of requirements enabled in the entry loader.
A list of requirements enabled in the instance loader.
Loader for instance commands.
Builder for an instance loader.
Enums
An error which can occur while initializing a loader.
Traits
Provides type-safe pointer chain support.
Type Definitions
Allows returning small amounts of data (specifically with a length <= 8) without needlessly allocating heap memory.