Struct ash::entry::Entry

source ·

pub struct Entry {
    static_fn: StaticFn,
    entry_fn_1_0: EntryFnV1_0,
    entry_fn_1_1: EntryFnV1_1,
    _lib_guard: Option<Arc<Library>>,
}

Expand description

Holds the Vulkan functions independent of a particular instance

Fields§

§static_fn: StaticFn§entry_fn_1_0: EntryFnV1_0§entry_fn_1_1: EntryFnV1_1§_lib_guard: Option<Arc<Library>>

Implementations§

source §

impl Entry

Vulkan core 1.0

source

pub unsafe fn load() -> Result<Self, LoadingError>

Load default Vulkan library for the current platform

Prefer this over [linked()][Self::linked()] when your application can gracefully handle environments that lack Vulkan support, and when the build environment might not have Vulkan development packages installed (e.g. the Vulkan SDK, or Ubuntu’s libvulkan-dev).

§Safety

dlopening native libraries is inherently unsafe. The safety guidelines for Library::new() and Library::get() apply here.

No Vulkan functions loaded directly or indirectly from this Entry may be called after it is dropped.

§Example

use ash::{vk, Entry};
let entry = unsafe { Entry::load()? };
let app_info = vk::ApplicationInfo {
    api_version: vk::make_api_version(0, 1, 0, 0),
    ..Default::default()
};
let create_info = vk::InstanceCreateInfo {
    p_application_info: &app_info,
    ..Default::default()
};
let instance = unsafe { entry.create_instance(&create_info, None)? };

source

pub unsafe fn load_from(path: impl AsRef<OsStr>) -> Result<Self, LoadingError>

Load Vulkan library at path

§Safety

dlopening native libraries is inherently unsafe. The safety guidelines for Library::new() and Library::get() apply here.

No Vulkan functions loaded directly or indirectly from this Entry may be called after it is dropped.

source

pub unsafe fn from_static_fn(static_fn: StaticFn) -> Self

Load entry points based on an already-loaded crate::StaticFn

§Safety

static_fn must contain valid function pointers that comply with the semantics specified by Vulkan 1.0, which must remain valid for at least the lifetime of the returned Entry.

source

pub fn from_parts_1_1( static_fn: StaticFn, entry_fn_1_0: EntryFnV1_0, entry_fn_1_1: EntryFnV1_1, ) -> Self

source

§Example

let entry = Entry::linked();
match unsafe { entry.try_enumerate_instance_version() }? {
    // Vulkan 1.1+
    Some(version) => {
        let major = vk::version_major(version);
        let minor = vk::version_minor(version);
        let patch = vk::version_patch(version);
    },
    // Vulkan 1.0
    None => {},
}

source

pub unsafe fn create_instance( &self, create_info: &InstanceCreateInfo<'_>, allocation_callbacks: Option<&AllocationCallbacks<'_>>, ) -> VkResult<Instance>

https://registry.khronos.org/vulkan/specs/1.3-extensions/man/html/vkCreateInstance.html

§Safety

The resulting Instance and any function-pointer objects (e.g. Device and extensions like khr::swapchain::Device) loaded from it may not be used after this Entry object is dropped, unless it was crated using [Entry::linked()] or Entry::from_parts_1_1().

Instance does not implement drop semantics and can only be destroyed via destroy_instance().

source