Struct VramAllocator 

pub struct VramAllocator<const ROOM_PAGES: usize, const CLUT_ROWS: usize> { /* private fields */ }

One owner for all of VRAM: texture pages, room-material windows, model strips and CLUT rows, with free. A coarse 64×16-pixel occupancy grid keeps page/strip/framebuffer reservations from overlapping; a composed TextureWindowAtlas sub-allocates room-material windows inside a reserved band; a ClutRowAllocator hands out CLUT rows.

Implementations

impl<const ROOM_PAGES: usize, const CLUT_ROWS: usize> VramAllocator<ROOM_PAGES, CLUT_ROWS>

pub const fn new(clut_base_y: u16) -> Self

Build an empty allocator. clut_base_y is the first CLUT-band row.

pub fn reserve_rect(&mut self, rect: VramRect) -> VramHandle

Reserve a fixed rectangle (e.g. the double-buffered framebuffer, or a region still owned by legacy hardcoded uploads). Returns a handle that can be freed but is normally permanent.

pub fn reserve_room_band(&mut self, base_x: u16, base_y: u16)

Select the preferred room-material page band. Physical pages are reserved lazily as the logical atlas first touches them, so a six-page capacity no longer pins six pages for a scene that uses only one.

pub fn alloc_window( &mut self, width_texels: u16, height_texels: u16, ) -> Option<(TexturePage, TextureWindowPlacement, VramHandle)>

Allocate a room-material window (delegates to the composed TextureWindowAtlas; the band must be reserved first).

pub fn alloc_room_page(&mut self) -> Option<(TexturePage, VramHandle)>

Reserve a whole room-material page (large UI / background textures use a full page without a GP0(E2) window). The room band must be reserved first via reserve_room_band.

pub fn alloc_model_slot( &mut self, halfwords_per_row: u16, depth: TextureDepth, ) -> Option<(TexturePage, VramHandle)>

Allocate an indexed model-atlas strip halfwords_per_row wide (rounded up to whole 64-halfword tpage bases) at page row 256.

Placement is measured in physical VRAM halfwords, so the same allocator works for 4bpp and 8bpp atlases. depth controls how the GPU interprets those halfwords when the returned tpage word is emitted.

pub fn free(&mut self, handle: VramHandle)

Release a reservation.

Trait Implementations

impl<const ROOM_PAGES: usize, const CLUT_ROWS: usize> Clone for VramAllocator<ROOM_PAGES, CLUT_ROWS>

fn clone(&self) -> VramAllocator<ROOM_PAGES, CLUT_ROWS>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<const ROOM_PAGES: usize, const CLUT_ROWS: usize> Debug for VramAllocator<ROOM_PAGES, CLUT_ROWS>

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

Formats the value using the given formatter.

impl<const ROOM_PAGES: usize, const CLUT_ROWS: usize> VramRegionSource for VramAllocator<ROOM_PAGES, CLUT_ROWS>

fn alloc_page_run( &mut self, count: u16, depth: TextureDepth, page_y: u16, ) -> Option<(TexturePage, VramHandle)>

Reserve count contiguous texture pages at page row page_y (0 or 256), returning the base TexturePage and a free handle.

fn alloc_clut(&mut self, entries: u16) -> Option<(Clut, VramHandle)>

Reserve a CLUT of entries palette slots (16 for 4bpp, 256 for 8bpp).

impl<const ROOM_PAGES: usize, const CLUT_ROWS: usize> Copy for VramAllocator<ROOM_PAGES, CLUT_ROWS>