Struct Terminal 

pub struct Terminal {
    pub id: WidgetId,
    pub cells: Vec<Vec<TerminalCell>>,
    pub scrollbar: Option<TerminalScrollbar>,
}

Declarative description of a terminal cell grid.

cells[row][col] — outer Vec is rows top-to-bottom, inner Vec is columns left-to-right. Rows may be ragged (different lengths) but backends should treat missing trailing cells as blank.

Stays a plain, non-#[non_exhaustive] struct: a published consumer builds it with an exhaustive struct literal today, so marking it #[non_exhaustive] would break that consumer’s build. Default is still provided for consumers that want the Default::default()-plus-field-assignment pattern.

Examples

use quadraui::{Color, Terminal, TerminalCell, TerminalHit, WidgetId};

let cell = TerminalCell {
    text: "$".to_string(),
    fg: Color::rgb(200, 200, 200),
    bg: Color::rgb(0, 0, 0),
    bold: false,
    italic: false,
    underline: false,
    dim: false,
    selected: false,
    is_cursor: true,
    cursor_shape: Default::default(),
    cursor_blinking: false,
    is_find_match: false,
    is_find_active: false,
};

let mut terminal = Terminal::default();
terminal.id = WidgetId::new("terminal:shell");
terminal.cells = vec![vec![cell]];

let layout = terminal.layout(80.0, 24.0, 1.0, 1.0);
assert_eq!(layout.hit_test(0.0, 0.0), TerminalHit::Cell { row: 0, col: 0 });

Fields

id: WidgetId

cells: Vec<Vec<TerminalCell>>

scrollbar: Option<TerminalScrollbar>

When present, the rasteriser draws a themed scrollbar using the same style as editor scrollbars (Backend::draw_scrollbar).

Implementations

impl Terminal

pub fn dirty_rows(&self, prev: &Terminal) -> Option<Vec<usize>>

Compare self against the previously-painted prev snapshot and return the indices of rows whose cell content differs.

Returns None when a full repaint is required rather than a row-by-row diff: the two grids have different row counts, so prev’s row i doesn’t necessarily correspond to self’s row i (a resize/reflow shifted everything). Returns Some(rows) otherwise — sorted ascending, deduplicated, and possibly empty (e.g. a cursor-blink tick that produced an identical grid).

TerminalCell compares by value, so any change to a cell’s glyph, colour, or overlay flag (selected / is_cursor / is_find_match / is_find_active) — i.e. scroll, selection, cursor move, and find-highlight updates — registers the owning row as dirty; there is nothing overlay-specific for a caller to special-case.

pub fn layout( &self, viewport_width: f32, viewport_height: f32, cell_width: f32, cell_height: f32, ) -> TerminalLayout

Compute viewport → grid conversion. The layout is uniform-cell, so this is just division; there’s no per-cell work.

Arguments

• viewport_width, viewport_height — pane dimensions.
• cell_width, cell_height — cell dimensions. TUI passes (1.0, 1.0); native backends pass the font’s advance width and line height.

Trait Implementations

impl Clone for Terminal

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Terminal

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

Formats the value using the given formatter.

impl Default for Terminal

fn default() -> Self

An empty-id terminal with no cells and no scrollbar.

impl<'de> Deserialize<'de> for Terminal

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Terminal

impl PartialEq for Terminal

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Terminal

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Terminal