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
.
Trait Implementations§
source§impl Pool<AccelerationStructureInfo, AccelerationStructure> for LazyPool
impl Pool<AccelerationStructureInfo, AccelerationStructure> for LazyPool
source§fn lease(
&mut self,
info: AccelerationStructureInfo
) -> Result<Lease<AccelerationStructure>, DriverError>
fn lease( &mut self, info: AccelerationStructureInfo ) -> Result<Lease<AccelerationStructure>, DriverError>
source§impl Pool<BufferInfo, Buffer> for LazyPool
impl Pool<BufferInfo, Buffer> for LazyPool
source§fn lease(&mut self, info: BufferInfo) -> Result<Lease<Buffer>, DriverError>
fn lease(&mut self, info: BufferInfo) -> Result<Lease<Buffer>, DriverError>
Auto Trait Implementations§
impl RefUnwindSafe for LazyPool
impl Send for LazyPool
impl Sync for LazyPool
impl Unpin for LazyPool
impl UnwindSafe for LazyPool
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
.§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
.§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s.§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s.