Trait gfx_hal::DescriptorPool

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

    unsafe fn allocate_set(
        &mut self, 
        layout: &B::DescriptorSetLayout
    ) -> Result<B::DescriptorSet, AllocationError> { ... }
    unsafe fn allocate_sets<I>(
        &mut self, 
        layouts: I, 
        sets: &mut Vec<B::DescriptorSet>
    ) -> Result<(), AllocationError>
    where
        I: IntoIterator,
        I::Item: Borrow<B::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::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.

Loading content...

Provided methods

unsafe fn allocate_set(
    &mut self,
    layout: &B::DescriptorSetLayout
) -> Result<B::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 Vec<B::DescriptorSet>
) -> Result<(), AllocationError> where
    I: IntoIterator,
    I::Item: Borrow<B::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.

Loading content...

Implementors

Loading content...