Struct demo_vk::graphics::vulkan::DescriptorBumpAllocator

pub struct DescriptorBumpAllocator { /* private fields */ }

A grow-only descriptor pool that can be reset.

Internally, there can actually be many DescriptorPools. When a pool is out of space for allocations, then a new pool will be created, and so on…

Implementations

impl DescriptorBumpAllocator

pub fn new<I>( ctx: Arc<VulkanContext>, max_sets_per_pool: u32, pool_ratios: I, ) -> Result<Self>

where I: IntoIterator<Item = PoolRatio>,

Creates a new bump allocator instance.

Params

• max_sets_per_pool - controls the size of each DescriptorPool. Larger values mean fewer calls to vkCreateDescriptorPool, but may be wasteful in memory usage.
• pool_ratios - controls the relative ratios of how many descriptor types can be allocated from each pool. This doesn’t need to be perfect (when in doubt, overestimate), but inaccuraces can result in wasted pools.

pub fn allocate_descriptor_set( &mut self, descriptor_set_layout: &DescriptorSetLayout, ) -> Result<DescriptorSet>

Allocates a new descriptor set with the provided layout.

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

Reset all descriptor pools and descriptor sets.

Safety

This method is unsafe because:

• the caller must synchronize access to the descriptor sets. e.g. the caller must ensure that no descriptor set is in-use when this method is called.

Trait Implementations

impl Debug for DescriptorBumpAllocator

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

Formats the value using the given formatter.