Struct Scrollback 

pub struct Scrollback { /* private fields */ }

Scrollback buffer with configurable line capacity.

Uses a VecDeque for O(1) push/pop. When over capacity, the oldest line (front of the deque) is evicted.

Implementations

impl Scrollback

pub fn new(capacity: usize) -> Self

Create a new scrollback with the given line capacity.

A capacity of 0 means scrollback is disabled (all pushes are dropped).

pub fn capacity(&self) -> usize

Maximum number of lines this scrollback can hold.

pub fn set_capacity(&mut self, capacity: usize)

Change the scrollback capacity.

If the new capacity is smaller than the current line count, the oldest lines are evicted.

pub fn len(&self) -> usize

Current number of stored lines.

pub fn is_empty(&self) -> bool

Whether the scrollback is empty.

pub fn push_row( &mut self, cells: &[Cell], wrapped: bool, ) -> Option<ScrollbackLine>

Push a row (as a cell slice) into scrollback.

wrapped indicates whether the row was a soft-wrap continuation. If over capacity, the oldest line is evicted.

pub fn pop_newest(&mut self) -> Option<ScrollbackLine>

Pop the most recent (newest) line from scrollback.

Used when scrolling down to pull lines back into the viewport, or when the viewport grows taller and lines are reclaimed.

pub fn peek_newest(&self) -> Option<&ScrollbackLine>

Peek at the most recent (newest) line without removing it.

pub fn get(&self, index: usize) -> Option<&ScrollbackLine>

Get a line by index (0 = oldest).

pub fn iter(&self) -> impl Iterator<Item = &ScrollbackLine>

Iterate over stored lines from oldest to newest.

pub fn iter_range( &self, range: Range<usize>, ) -> impl Iterator<Item = &ScrollbackLine>

Iterate over a specific line range (0 = oldest).

The range is clamped to valid bounds. This enables viewport virtualization without scanning the full history each frame.

pub fn iter_rev(&self) -> impl Iterator<Item = &ScrollbackLine>

Iterate over stored lines from newest to oldest.

pub fn clear(&mut self)

Clear all stored lines.

pub fn virtualized_window( &self, scroll_offset_from_bottom: usize, viewport_lines: usize, overscan_lines: usize, ) -> ScrollbackWindow

Compute a virtualized scrollback window for viewport rendering.

• scroll_offset_from_bottom=0 anchors viewport at the newest lines.
• Larger offsets move viewport toward older lines.
• overscan_lines expands the render range around the viewport.

Trait Implementations

impl Clone for Scrollback

fn clone(&self) -> Scrollback

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Scrollback

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

Formats the value using the given formatter.

impl Default for Scrollback

fn default() -> Self

Returns the “default value” for a type.