///|
/// Accumulates the terminal commands that repaint changed cells, tracking where
/// the terminal cursor is and which style is active so it only moves or
/// restyles when needed.
priv struct Painter {
commands : Array[@tty.Command]
run : StringBuilder
mut pen : Style
mut row : Int32
mut col : Int32
}
///|
fn Painter::Painter() -> Painter {
{ commands: [], run: StringBuilder(), pen: Style(), row: -1, col: -1, }
}
///|
/// Emit the text collected so far as one `Print`.
fn Painter::flush(self : Painter) -> Unit {
if !self.run.is_empty() {
self.commands.push(Print(self.run.to_string()))
self.run.reset()
}
}
///|
/// Switch the terminal to `style`, sending only the attributes that differ
/// from the style it is in. A screen of colored text changes style every few
/// cells, and most of those changes are one color.
fn Painter::set_style(self : Painter, style : Style) -> Unit {
let pen = self.pen
if style == pen {
return
}
self.flush()
if style == Style() {
// One command clears everything, however much was set.
self.commands.push(ResetStyle)
} else {
// Setting a color to `Default` is how it is turned off.
if style.fg != pen.fg {
self.commands.push(SetForeground(style.fg))
}
if style.bg != pen.bg {
self.commands.push(SetBackground(style.bg))
}
if style.bold != pen.bold {
self.commands.push(if style.bold { SetBold } else { ResetBold })
}
if style.italic != pen.italic {
self.commands.push(if style.italic { SetItalic } else { ResetItalic })
}
if style.underline != pen.underline {
self.commands.push(
if style.underline {
SetUnderline
} else {
ResetUnderline
},
)
}
if style.reverse != pen.reverse {
self.commands.push(if style.reverse { SetReverse } else { ResetReverse })
}
}
self.pen = style
}
///|
/// Paint `cell` at the 0-based (`row`, `col`).
fn Painter::paint(
self : Painter,
row : Int32,
col : Int32,
cell : Cell,
) -> Unit {
if self.row != row || self.col != col {
self.flush()
self.commands.push(CursorPosition(row + 1, col + 1))
}
self.set_style(cell.style)
self.run.write_string(cell.text)
self.row = row
self.col = col + cell.width
}
///|
/// Finish painting and return the commands. The terminal is left in the
/// default style.
fn Painter::finish(self : Painter) -> Array[@tty.Command] {
self.set_style(Style())
self.flush()
self.commands
}
///|
/// The terminal commands that turn a screen showing `shown` into one showing
/// `next`. `shown` is `None` when the screen content is unknown, which repaints
/// everything; so does a change of frame size.
///
/// The commands assume the terminal is in the default style and leave it there.
/// An empty result means the two frames look the same.
fn diff(shown : Frame?, next : Frame) -> Array[@tty.Command] {
let old : Frame? = if shown is Some(frame) &&
frame.width == next.width &&
frame.height == next.height {
shown
} else {
None
}
let painter = Painter()
for row in 0..