Struct ash::Entry

source ·
pub struct Entry { /* private fields */ }
Expand description

Holds the Vulkan functions independent of a particular instance

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 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 vk::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 fp_v1_0(&self) -> &EntryFnV1_0

source

pub fn static_fn(&self) -> &StaticFn

source

pub fn try_enumerate_instance_version(&self) -> VkResult<Option<u32>>

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

§Example
let entry = Entry::linked();
match 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://www.khronos.org/registry/vulkan/specs/1.3-extensions/man/html/vkCreateInstance.html

§Safety

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

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

source

pub fn enumerate_instance_layer_properties( &self ) -> VkResult<Vec<LayerProperties>>

source

pub fn enumerate_instance_extension_properties( &self, layer_name: Option<&CStr> ) -> VkResult<Vec<ExtensionProperties>>

source

pub unsafe fn get_instance_proc_addr( &self, instance: Instance, p_name: *const c_char ) -> PFN_vkVoidFunction

source§

impl Entry

Vulkan core 1.1

source

pub fn fp_v1_1(&self) -> &EntryFnV1_1

source

pub fn enumerate_instance_version(&self) -> VkResult<u32>

👎Deprecated: This function is unavailable and therefore panics on Vulkan 1.0, please use try_enumerate_instance_version() instead
source§

impl Entry

Vulkan core 1.2

source

pub fn fp_v1_2(&self) -> &EntryFnV1_2

source§

impl Entry

Vulkan core 1.3

source

pub fn fp_v1_3(&self) -> &EntryFnV1_3

Trait Implementations§

source§

impl Clone for Entry

source§

fn clone(&self) -> Entry

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

Auto Trait Implementations§

§

impl Freeze for Entry

§

impl RefUnwindSafe for Entry

§

impl Send for Entry

§

impl Sync for Entry

§

impl Unpin for Entry

§

impl UnwindSafe for Entry

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.