1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80
mod allocation;
mod allocator;
mod atlas_set;
use crate::AIndexSet;
pub use allocation::Allocation;
pub use allocator::Allocator;
pub use atlas_set::AtlasSet;
/// Atlas Layer within an [`AtlasSet`].
///
pub struct Atlas {
/// handles the space allocation of the layer.
pub allocator: Allocator,
/// Stores each Index the allocations exist at for this layer.
pub allocated: AIndexSet<usize>,
/// use to avoid placing newly loaded images into
/// if we are migrating images out of it.
pub migrating: bool,
}
impl Atlas {
/// Creates a new Atlas with Allocator texture size.
///
pub fn new(size: u32) -> Self {
Self {
allocator: Allocator::new(size),
allocated: AIndexSet::default(),
migrating: false,
}
}
/// Allocates a Spot within the Texture for uploading too.
///
pub fn allocate(
&mut self,
width: u32,
height: u32,
) -> Option<guillotiere::Allocation> {
self.allocator.allocate(width, height)
}
/// Inserts [Allocation] Aquired Index for Back Mapping.
///
pub fn insert_index(&mut self, index: usize) {
self.allocated.insert(index);
}
/// Clears the internal Allocator and Allocated stores.
///
pub fn clear(&mut self) {
self.allocator.clear();
self.allocated.clear();
self.migrating = false;
}
/// Deallocates a [`Allocation`] returning it to the Allocator for reuse.
///
pub fn deallocate(
&mut self,
index: usize,
allocation: guillotiere::Allocation,
) {
self.allocated.swap_remove(&index);
self.allocator.deallocate(allocation);
}
/// Returns how many alloctions have been removed since the
/// creation of the layer. this gets reset when the layer is purged.
///
pub fn deallocations(&self) -> usize {
self.allocator.deallocations()
}
/// Enables Migration of the Allocations inside the Texture.
///
pub fn start_migration(&mut self) {
self.migrating = true;
}
}