Struct vulkano::sync::Fence

pub struct Fence<D = Arc<Device>> where
    D: SafeDeref<Target = Device>,  { /* fields omitted */ }

A fence is used to know when a command buffer submission has finished its execution.

When a command buffer accesses a resource, you have to ensure that the CPU doesn’t access the same resource simultaneously (except for concurrent reads). Therefore in order to know when the CPU can access a resource again, a fence has to be used.

Implementations

impl<D> Fence<D> where
    D: SafeDeref<Target = Device>, 

pub fn from_pool(device: D) -> Result<Fence<D>, OomError>

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

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

pub fn alloc(device: D) -> Result<Fence<D>, OomError>

Builds a new fence.

pub fn alloc_signaled(device: D) -> Result<Fence<D>, OomError>

Builds a new fence in signaled state.

pub fn ready(&self) -> Result<bool, OomError>

Returns true if the fence is signaled.

pub fn wait(&self, timeout: Option<Duration>) -> Result<(), FenceWaitError>

Waits until the fence is signaled, or at least until the timeout duration has elapsed.

Returns Ok if the fence is now signaled. Returns Err if the timeout was reached instead.

If you pass a duration of 0, then the function will return without blocking.

pub fn multi_wait<'a, I>(
    iter: I,
    timeout: Option<Duration>
) -> Result<(), FenceWaitError> where
    I: IntoIterator<Item = &'a Fence<D>>,
    D: 'a, 

Waits for multiple fences at once.

Panic

Panics if not all fences belong to the same device.

pub fn reset(&mut self) -> Result<(), OomError>

Resets the fence.

pub fn multi_reset<'a, I>(iter: I) -> Result<(), OomError> where
    I: IntoIterator<Item = &'a mut Fence<D>>,
    D: 'a, 

Resets multiple fences at once.

Panic

• Panics if not all fences belong to the same device.

Trait Implementations

impl<D: Debug> Debug for Fence<D> where
    D: SafeDeref<Target = Device>, 

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

Formats the value using the given formatter.

impl DeviceOwned for Fence

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

Returns the device that owns Self.

impl<D> Drop for Fence<D> where
    D: SafeDeref<Target = Device>, 

fn drop(&mut self)

Executes the destructor for this type.

impl<D> VulkanObject for Fence<D> where
    D: SafeDeref<Target = Device>, 

type Object = Fence

The type of the object.

const TYPE: ObjectType

The ObjectType of the internal Vulkan handle.

fn internal_object(&self) -> Fence

Returns a reference to the object.