Struct ShelfAllocator 

pub struct ShelfAllocator { /* private fields */ }

Bin-packing shelf allocator for a texture atlas.

Allocates rectangular regions from a fixed-size atlas using the shelf (skyline) algorithm. Shelves are created lazily as needed.

Implementations

impl ShelfAllocator

pub fn new(width: u32, height: u32) -> Self

Create a new shelf allocator for an atlas of the given dimensions.

pub fn width(&self) -> u32

Atlas width.

pub fn height(&self) -> u32

Atlas height.

pub fn allocation_count(&self) -> u32

Number of live allocations.

pub fn allocate(&mut self, width: u32, height: u32) -> Option<AtlasRegion>

Allocate a region of width x height pixels.

Returns None if the atlas is full.

pub fn deallocate(&mut self, region: &AtlasRegion)

Deallocate a previously allocated region.

The region is returned to its shelf for reuse.

pub fn shelf_count(&self) -> usize

Total number of shelves created.

pub fn utilisation_percent(&self) -> u32

Fraction of atlas height used, as a percentage (0-100).

pub fn reset(&mut self)

Reset the allocator, freeing all regions.

Trait Implementations

impl Debug for ShelfAllocator

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

Formats the value using the given formatter.