Struct alacritty::term::Term

pub struct Term {
    pub font_size: Size,
    pub dirty: bool,
    pub visual_bell: VisualBell,
    pub next_is_urgent: Option<bool>,
    // some fields omitted
}

Fields

font_size: Size

Font size

dirty: bool

visual_bell: VisualBell

next_is_urgent: Option<bool>

Methods

impl Term

pub fn selection(&self) -> &Option<Selection>

pub fn selection_mut(&mut self) -> &mut Option<Selection>

pub fn get_next_title(&mut self) -> Option<String>

pub fn scroll_display(&mut self, scroll: Scroll)

pub fn get_next_mouse_cursor(&mut self) -> Option<MouseCursor>

pub fn new(
    config: &Config,
    size: SizeInfo,
    message_buffer: MessageBuffer
) -> Term

pub fn change_font_size(&mut self, delta: f32)

pub fn reset_font_size(&mut self)

pub fn update_config(&mut self, config: &Config)

pub fn needs_draw(&self) -> bool

pub fn selection_to_string(&self) -> Option<String>

pub fn pixels_to_coords(&self, x: usize, y: usize) -> Option<Point>

Convert the given pixel values to a grid coordinate

The mouse coordinates are expected to be relative to the top left. The line and column returned are also relative to the top left.

Returns None if the coordinates are outside the window, padding pixels are considered inside the window

pub fn grid(&self) -> &Grid<Cell>

Access to the raw grid data structure

This is a bit of a hack; when the window is closed, the event processor serializes the grid state to a file.

Important traits for RenderableCellsIter<'a>

impl<'a> Iterator for RenderableCellsIter<'a> type Item = RenderableCell;

pub fn renderable_cells<'b>(
    &'b self,
    config: &'b Config,
    window_focused: bool,
    metrics: Metrics
) -> RenderableCellsIter

Iterate over the renderable cells in the terminal

A renderable cell is any cell which has content other than the default background color. Cells with an alternate background color are considered renderable as are cells with any text content.

pub fn resize(&mut self, size: &SizeInfo)

Resize terminal to new dimensions

pub fn size_info(&self) -> &SizeInfo

pub fn mode(&self) -> &TermMode

pub fn cursor(&self) -> &Cursor

pub fn swap_alt(&mut self)

pub fn background_color(&self) -> Rgb

pub fn message_buffer_mut(&mut self) -> &mut MessageBuffer

pub fn message_buffer(&self) -> &MessageBuffer

pub fn exit(&mut self)

pub fn should_exit(&self) -> bool

pub fn set_url_highlight(&mut self, hl: RangeInclusive<Linear>)

pub fn reset_url_highlight(&mut self)

Trait Implementations

impl TermInfo for Term

fn lines(&self) -> Line

fn cols(&self) -> Column

impl Handler for Term

fn set_title(&mut self, title: &str)

Set the window title

fn set_mouse_cursor(&mut self, cursor: MouseCursor)

Set the mouse cursor

fn input(&mut self, c: char)

A character to be displayed

fn dectest(&mut self)

Run the dectest routine

fn goto(&mut self, line: Line, col: Column)

Set cursor to position

fn goto_line(&mut self, line: Line)

Set cursor to specific row

fn goto_col(&mut self, col: Column)

Set cursor to specific column

fn insert_blank(&mut self, count: Column)

Insert blank characters in current line starting from cursor

fn move_up(&mut self, lines: Line)

Move cursor up rows

fn move_down(&mut self, lines: Line)

Move cursor down rows

fn move_forward(&mut self, cols: Column)

Move cursor forward cols

fn move_backward(&mut self, cols: Column)

Move cursor backward cols

fn identify_terminal<W: Write>(&mut self, writer: &mut W)

Identify the terminal (should write back to the pty stream)

fn device_status<W: Write>(&mut self, writer: &mut W, arg: usize)

fn move_down_and_cr(&mut self, lines: Line)

Move cursor down rows and set to column 1

fn move_up_and_cr(&mut self, lines: Line)

Move cursor up rows and set to column 1

fn put_tab(&mut self, count: i64)

Put count tabs

fn backspace(&mut self)

Backspace count characters

fn carriage_return(&mut self)

Carriage return

fn linefeed(&mut self)

Linefeed

fn bell(&mut self)

Set current position as a tabstop

fn substitute(&mut self)

Substitute char under cursor

fn newline(&mut self)

Run LF/NL

LF/NL mode has some interesting history. According to ECMA-48 4th edition, in LINE FEED mode,

The execution of the formatter functions LINE FEED (LF), FORM FEED (FF), LINE TABULATION (VT) cause only movement of the active position in the direction of the line progression.

In NEW LINE mode,

The execution of the formatter functions LINE FEED (LF), FORM FEED (FF), LINE TABULATION (VT) cause movement to the line home position on the following line, the following form, etc. In the case of LF this is referred to as the New Line (NL) option.

Additionally, ECMA-48 4th edition says that this option is deprecated. ECMA-48 5th edition only mentions this option (without explanation) saying that it's been removed.

As an emulator, we need to support it since applications may still rely on it.

fn set_horizontal_tabstop(&mut self)

Set current position as a tabstop

fn scroll_up(&mut self, lines: Line)

Scroll up rows rows

fn scroll_down(&mut self, lines: Line)

Scroll down rows rows

fn insert_blank_lines(&mut self, lines: Line)

Insert count blank lines

fn delete_lines(&mut self, lines: Line)

Delete count lines

fn erase_chars(&mut self, count: Column)

Erase count chars in current line following cursor

fn delete_chars(&mut self, count: Column)

Delete count chars

fn move_backward_tabs(&mut self, count: i64)

Move backward count tabs

fn move_forward_tabs(&mut self, count: i64)

Move forward count tabs

fn save_cursor_position(&mut self)

Save current cursor position

fn restore_cursor_position(&mut self)

Restore cursor position

fn clear_line(&mut self, mode: LineClearMode)

Clear current line

fn set_color(&mut self, index: usize, color: Rgb)

Set the indexed color value

fn reset_color(&mut self, index: usize)

Reset the indexed color to original value

fn set_clipboard(&mut self, string: &str)

Set the clipboard

fn clear_screen(&mut self, mode: ClearMode)

Clear screen

fn clear_tabs(&mut self, mode: TabulationClearMode)

Clear tab stops

fn reset_state(&mut self)

Reset terminal state

fn reverse_index(&mut self)

Reverse Index

fn terminal_attribute(&mut self, attr: Attr)

set a terminal attribute

fn set_mode(&mut self, mode: Mode)

Set mode

fn unset_mode(&mut self, mode: Mode)

Unset mode

fn set_scrolling_region(&mut self, region: Range<Line>)

DECSTBM - Set the terminal scrolling region

fn set_keypad_application_mode(&mut self)

DECKPAM - Set keypad to applications mode (ESCape instead of digits)

fn unset_keypad_application_mode(&mut self)

DECKPNM - Set keypad to numeric mode (digits instead of ESCape seq)

fn configure_charset(&mut self, index: CharsetIndex, charset: StandardCharset)

Assign a graphic character set to G0, G1, G2 or G3

fn set_active_charset(&mut self, index: CharsetIndex)

Set one of the graphic character sets, G0 to G3, as the active charset.

fn set_cursor_style(&mut self, style: Option<CursorStyle>)

Set the cursor style

impl Dimensions for Term

fn dimensions(&self) -> Point

Get the size of the area

impl Search for Term

fn semantic_search_left(&self, point: Point<usize>) -> Point<usize>

Find the nearest semantic boundary to the left of provided point.

fn semantic_search_right(&self, point: Point<usize>) -> Point<usize>

Find the nearest semantic boundary to the point of provided point.

fn url_search(&self, point: Point<usize>) -> Option<Url>

Find the nearest URL boundary in both directions.