Struct ScreenStack 

pub struct ScreenStack { /* private fields */ }

Manages a stack of overlay layers with auto z-indexing.

Overlays are rendered in insertion order. Each overlay receives a unique z-index spaced 10 apart from the base. Dim layers are inserted one z-level below overlays that request background dimming.

Implementations

impl ScreenStack

pub fn new() -> Self

Creates an empty screen stack with base z-index 1000.

pub fn push( &mut self, config: OverlayConfig, lines: Vec<Vec<Segment>>, ) -> OverlayId

Pushes an overlay onto the stack.

Returns a unique OverlayId for later removal.

pub fn pop(&mut self) -> Option<OverlayId>

Removes the topmost overlay from the stack.

pub fn remove(&mut self, id: OverlayId) -> bool

Removes a specific overlay by ID.

Returns true if the overlay was found and removed.

pub fn clear(&mut self)

Removes all overlays.

pub fn len(&self) -> usize

Returns the number of overlays in the stack.

pub fn is_empty(&self) -> bool

Returns true if the stack has no overlays.

pub fn resolve_position( position: &OverlayPosition, size: Size, screen: Size, ) -> Position

Resolves an overlay position to absolute screen coordinates.

pub fn apply_to_compositor(&self, compositor: &mut Compositor, screen: Size)

Applies all overlays as layers to a compositor.

Each overlay is added with its resolved position and z-index. Overlays with dim_background get a full-screen dim layer inserted one z-level below them.

Trait Implementations

impl Default for ScreenStack

fn default() -> Self

Returns the “default value” for a type.