1.163.3 Get methods

terminal_image <-pty_name: -> name*

Path of the pseudo-terminal device, or @nil when not connected to one.

terminal_image <-foreground_process: -> int

Process group of another session that owns the pty, i.e. of the process running in the terminal. Fails if there is none, which is the case while the terminal is driven by a thread of this process. While it succeeds the control keys are passed to that process rather than looked up in terminal_image<-bindings. Unix only.

terminal_image <-displayed_cursor: -> cursor

Cursor reflecting whether the pointer is on text or over a link.

terminal_image <-selected: -> string

New string with the contents of the selection.

terminal_image <-cursor_position: -> point

Logical cursor position as point(col, row).

terminal_image <-row: int -> string

Text contents of a visible row, 0-based from the top.

terminal_image <-link: point|event -> name

Hyperlink URL at the given position or under an event.

terminal_image <-cwidth: code=int -> int

Number of columns the code point code occupies when drawn in terminal_image<-font: 0 for combining marks, 2 for wide characters and 1 for the rest. This is the classification the renderer itself uses, so clients that must predict our layout can share it rather than keep a second copy that drifts. In particular it accounts for symbol and emoji code points that the static Unicode tables call width 1 while an emoji-presenting font draws them twice as wide. Fails while the terminal has no cell metrics yet.