pub struct LazyPool { /* private fields */ }
Expand description
A balanced resource allocator.
The information for each lease request is compared against the stored resources for compatibility. If no acceptable resources are stored for the information provided a new resource is created and returned.
§Details
- Acceleration structures may be larger than requested
- Buffers may be larger than requested or have additional usage flags
- Images may have additional usage flags
§Bucket Strategy
The information for each lease request is the key for a HashMap
of buckets. If no bucket
exists with compatible information a new bucket is created.
In practice this means that for a PoolInfo::image_capacity
of 4
, requests for a 1024x1024
image with certain attributes will store a maximum of 4
such images. Requests for any image
having a different size or incompatible attributes will store an additional maximum of 4
images.
§Memory Management
If requests for varying resources is common LazyPool::clear_images_by_info
and other memory
management functions are nessecery in order to avoid using all available device memory.
Implementations§
source§impl LazyPool
impl LazyPool
sourcepub fn with_capacity(device: &Arc<Device>, info: impl Into<PoolInfo>) -> Self
pub fn with_capacity(device: &Arc<Device>, info: impl Into<PoolInfo>) -> Self
Constructs a new LazyPool
with the given capacity information.
sourcepub fn clear_accel_structs(&mut self)
pub fn clear_accel_structs(&mut self)
Clears the pool of acceleration structure resources.
sourcepub fn clear_accel_structs_by_ty(&mut self, ty: AccelerationStructureTypeKHR)
pub fn clear_accel_structs_by_ty(&mut self, ty: AccelerationStructureTypeKHR)
Clears the pool of all acceleration structure resources matching the given type.
sourcepub fn clear_buffers(&mut self)
pub fn clear_buffers(&mut self)
Clears the pool of buffer resources.
sourcepub fn clear_images(&mut self)
pub fn clear_images(&mut self)
Clears the pool of image resources.
sourcepub fn clear_images_by_info(&mut self, info: impl Into<ImageInfo>)
pub fn clear_images_by_info(&mut self, info: impl Into<ImageInfo>)
Clears the pool of image resources matching the given information.
sourcepub fn retain_accel_structs<F>(&mut self, f: F)
pub fn retain_accel_structs<F>(&mut self, f: F)
Retains only the acceleration structure resources specified by the predicate.
In other words, remove all resources for which f(vk::AccelerationStructureTypeKHR)
returns
false
.
The elements are visited in unsorted (and unspecified) order.
§Performance
Provides the same performance guarantees as
HashMap::retain
.