Struct TextureAtlas 

pub struct TextureAtlas {
    pub width: u32,
    pub height: u32,
    /* private fields */
}

Dynamic shelf-based texture atlas with LRU eviction.

Allocation strategy

1. Check the free-list for a first-fit region large enough.
2. Walk existing shelves for one that can accommodate the request.
3. Open a new shelf at the current bottom of the atlas.
4. If all of the above fail, evict the LRU handle and retry once.

Eviction

Evicted regions are pushed onto the free-list; they are re-used on the next allocation attempt. The atlas never compacts its shelf layout.

Fields

width: u32

Atlas width in pixels.

height: u32

Atlas height in pixels.

Implementations

impl TextureAtlas

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

Construct a new empty atlas of the given dimensions.

pub fn insert(&mut self, w: u32, h: u32) -> Option<AtlasHandle>

Insert a rectangle of size w × h into the atlas.

Returns an AtlasHandle on success, or None if the rectangle is larger than the atlas or all eviction attempts were exhausted.

pub fn get(&self, h: AtlasHandle) -> Option<AtlasRect>

Retrieve the pixel rectangle for the given handle, if still live.

pub fn utilization(&self) -> f32

Fraction of the atlas area occupied by live allocations.

Returns a value in [0.0, 1.0].

pub fn resize(&mut self, new_width: u32, new_height: u32)

Discard all allocations and reinitialise with new dimensions.

Any existing handles become invalid. Uploading updated GPU texture data is the caller’s responsibility.