Struct tty_interface::Interface

pub struct Interface<'a> { /* private fields */ }

A TTY-based user-interface providing optimized update rendering.

Implementations

impl Interface<'_>

pub fn new<'a>(device: &'a mut dyn Device) -> Result<Interface<'a>>

Create a new interface for the specified device.

Examples

use tty_interface::Interface;

let interface = Interface::new(&mut device)?;

pub fn exit(self) -> Result<()>

When finished using this interface, uninitialize its terminal configuration.

Examples

use tty_interface::Interface;

let interface = Interface::new(&mut device)?;
interface.exit()?;

pub fn set(&mut self, position: Position, text: &str)

Update the interface’s text at the specified position. Changes are staged until applied.

Examples

use tty_interface::{Interface, Position, pos};

let mut interface = Interface::new(&mut device)?;
interface.set(pos!(1, 1), "Hello, world!");

pub fn set_styled(&mut self, position: Position, text: &str, style: Style)

Update the interface’s text at the specified position. Changes are staged until applied.

Examples

use tty_interface::{Interface, Style, Position, pos};

let mut interface = Interface::new(&mut device)?;
interface.set_styled(pos!(1, 1), "Hello, world!", Style::default().set_bold(true));

pub fn clear_line(&mut self, line: u16)

Clear all text on the specified line. Changes are staged until applied.

Examples

use tty_interface::{Interface, Style, Position, pos};

let mut interface = Interface::new(&mut device)?;

// Write "Hello," and "world!" on two different lines
interface.set(pos!(0, 0), "Hello,");
interface.set(pos!(0, 1), "world!");
interface.apply()?;

// Clear the second line, "world!"
interface.clear_line(1);
interface.apply()?;

pub fn set_cursor(&mut self, position: Option<Position>)

Update the interface’s cursor to the specified position, or hide it if unspecified.

Examples

use tty_interface::{Interface, Position, pos};

let mut interface = Interface::new(&mut device)?;
interface.set_cursor(Some(pos!(1, 2)));

pub fn apply(&mut self) -> Result<()>

Applies staged changes to the terminal.

Examples

use tty_interface::{Interface, Position, pos};

let mut interface = Interface::new(&mut device)?;
interface.set(pos!(1, 1), "Hello, world!");
interface.apply()?;