Struct vulkano::sync::Semaphore

pub struct Semaphore { /* private fields */ }

Used to provide synchronization between command buffers during their execution.

It is similar to a fence, except that it is purely on the GPU side. The CPU can’t query a semaphore’s status or wait for it to be signaled.

Implementations

impl Semaphore

pub fn new(
    device: Arc<Device>,
    create_info: SemaphoreCreateInfo
) -> Result<Semaphore, SemaphoreError>

Creates a new Semaphore.

pub fn from_pool(device: Arc<Device>) -> Result<Semaphore, SemaphoreError>

Takes a semaphore from the vulkano-provided semaphore pool. If the pool is empty, a new semaphore will be allocated. Upon drop, the semaphore is put back into the pool.

For most applications, using the pool should be preferred, in order to avoid creating new semaphores every frame.

pub unsafe fn from_handle(
    device: Arc<Device>,
    handle: Semaphore,
    create_info: SemaphoreCreateInfo
) -> Semaphore

Creates a new Semaphore from a raw object handle.

Safety

• handle must be a valid Vulkan object handle created from device.
• create_info must match the info used to create the object.

pub fn export_fd(
    &self,
    handle_type: ExternalSemaphoreHandleType
) -> Result<File, SemaphoreError>

Exports the semaphore into a POSIX file descriptor. The caller owns the returned File.

pub unsafe fn import_fd(
    &self,
    import_semaphore_fd_info: ImportSemaphoreFdInfo
) -> Result<(), SemaphoreError>

Imports a semaphore from a POSIX file descriptor.

The khr_external_semaphore_fd extension must be enabled on the device.

Safety

• If in import_semaphore_fd_info, handle_type is ExternalHandleType::OpaqueFd, then file must represent a binary semaphore that was exported from Vulkan or a compatible API, with a driver and device UUID equal to those of the device that owns self.

Trait Implementations

impl Debug for Semaphore

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl DeviceOwned for Semaphore

fn device(&self) -> &Arc<Device>

Returns the device that owns Self.

impl Drop for Semaphore

fn drop(&mut self)

Executes the destructor for this type.

impl Hash for Semaphore

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
    H: Hasher,
    Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq<Semaphore> for Semaphore

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl VulkanObject for Semaphore

type Handle = Semaphore

The type of the object.

fn handle(&self) -> Self::Handle

Returns the raw Vulkan handle of the object.

impl Eq for Semaphore