Trait DescriptorPool

pub trait DescriptorPool<B>:
    Send
    + Sync
    + Debug
where
    B: Backend,
{
    // Required methods
    unsafe fn free_sets<I>(&mut self, descriptor_sets: I)
       where I: IntoIterator<Item = <B as Backend>::DescriptorSet>;
    unsafe fn reset(&mut self);

    // Provided methods
    unsafe fn allocate_set(
        &mut self,
        layout: &<B as Backend>::DescriptorSetLayout,
    ) -> Result<<B as Backend>::DescriptorSet, AllocationError> { ... }
    unsafe fn allocate_sets<I>(
        &mut self,
        layouts: I,
        sets: &mut SmallVec<[<B as Backend>::DescriptorSet; 1]>,
    ) -> Result<(), AllocationError>
       where I: IntoIterator,
             <I as IntoIterator>::Item: Borrow<<B as Backend>::DescriptorSetLayout> { ... }
}

A descriptor pool is a collection of memory from which descriptor sets are allocated.

Required Methods

unsafe fn free_sets<I>(&mut self, descriptor_sets: I)

where I: IntoIterator<Item = <B as Backend>::DescriptorSet>,

Free the given descriptor sets provided as an iterator.

unsafe fn reset(&mut self)

Resets a descriptor pool, releasing all resources from all the descriptor sets allocated from it and freeing the descriptor sets. Invalidates all descriptor sets allocated from the pool; trying to use one after the pool has been reset is undefined behavior.

Provided Methods

unsafe fn allocate_set( &mut self, layout: &<B as Backend>::DescriptorSetLayout, ) -> Result<<B as Backend>::DescriptorSet, AllocationError>

Allocate a descriptor set from the pool.

The descriptor set will be allocated from the pool according to the corresponding set layout. However, specific descriptors must still be written to the set before use using a DescriptorSetWrite or DescriptorSetCopy.

Descriptors will become invalid once the pool is reset. Usage of invalidated descriptor sets results in undefined behavior.

unsafe fn allocate_sets<I>( &mut self, layouts: I, sets: &mut SmallVec<[<B as Backend>::DescriptorSet; 1]>, ) -> Result<(), AllocationError>

where I: IntoIterator, <I as IntoIterator>::Item: Borrow<<B as Backend>::DescriptorSetLayout>,

Allocate one or multiple descriptor sets from the pool.

The descriptor set will be allocated from the pool according to the corresponding set layout. However, specific descriptors must still be written to the set before use using a DescriptorSetWrite or DescriptorSetCopy.

Each descriptor set will be allocated from the pool according to the corresponding set layout. Descriptors will become invalid once the pool is reset. Usage of invalidated descriptor sets results in undefined behavior.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors