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 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()?;