package matrix
Module Matrix_test.TerminalSource
Terminals, emulators playing a profile.
The type for terminals.
create ~cols ~rows () is a terminal at power-up playing profile (default Profile.vte), cols wide and rows high.
The user's side
Each of these is the bytes the terminal sends for what its user does, in the encoding the program has set, and "" for a report the program has not asked for. color_scheme also changes the terminal's scheme. A session (input) or a child (Child.send) delivers them.
key t k is the bytes of k pressed with mods (default none). A Char types its character unless the modifiers make a chord.
Raises Invalid_argument as Matrix.Input.Keystroke.encode does.
keystroke t k is the bytes of the keystroke k, with its text, keypad, base layout key and repeat.
Raises Invalid_argument as Matrix.Input.Keystroke.encode does.
release t r is the bytes of the key release r, "" unless the program asked the kitty keyboard protocol for event types.
Raises Invalid_argument as Matrix.Input.Keystroke.encode does.
text t s is the bytes of typing each character of s as a key.
Raises Invalid_argument if s is not UTF-8 or holds a control character.
paste t s is the bytes of pasting s, between the paste markers when the program has set bracketed paste.
mouse t m is the report of m, when the program's mouse tracking reports it.
Raises Invalid_argument as Matrix.Input.Mouse_report.encode does.
focus t focused is the report of the window gaining focus (true) or losing it, when the program has set focus reports.
color_scheme t c changes t's color scheme to c, and is its report when the scheme changed and the program has set color scheme reports.
set_palette t p changes the palette t's user configured to p, as when they pick another theme (Vte.set_palette), and is the report of the change, the color scheme's, when the program has set color scheme reports.
Reading
scrollback t is the text of the lines scrolled off the primary screen's top, oldest first.
requests t is what the program has asked of t's host, oldest first (Vte.requests).