Term::VTerm::Screen - provides access to the screen layer of libvterm
Term::VTerm::Screen
$screen->enable_altscreen( $enabled )
Controls whether the altscreen buffer is enabled. Doing so allows the DEC altscreen mode to switch between regular and alternate screen buffers, but consumes more memory.
$screen->flush_damage
Flushes all pending damage through the screen to the damage callback.
$screen->set_damage_merge( $size )
Sets the damage merge size, as one of the DAMAGE_* constants.
DAMAGE_*
$screen->reset( $hard )
Resets the terminal state; performing either a soft or hard reset depending on the (optional) boolean value given.
$cell = $screen->get_cell( $pos )
Returns a VTermScreenCell object representing the current state of the cell at the given location. Note that this is an instantaneous snapshot - the returned object will not update to reflect later changes in the screen's state.
VTermScreenCell
$str = $screen->get_text( $rect )
Returns a UTF-8 string containing the text in the screen buffer within the given VTermRect.
VTermRect
$screen->set_callbacks( %cbs )
Sets the screen-layer callbacks. Takes the following named arguments:
$on_damage->( $rect )
$rect is a VTermRect structure.
$rect
$on_moverect->( $dest, $src )
$dest and $src are VTermRect structures.
$dest
$src
$on_movecursor->( $pos, $oldpos, $is_visible )
$pos and $oldpos are a VTermPos. $is_visible is a boolean.
$pos
$oldpos
VTermPos
$is_visible
$on_settermprop->( $prop, $value )
$prop is one of the PROP_* constants. The type of $value depends on the property type - see similar to get_penattr.
$prop
PROP_*
$value
get_penattr
$on_bell->()
$on_resize->( $rows, $cols )
$col = $screen->convert_color_to_rgb( $col )
Converts a VTermColor structure from indexed to RGB form.
VTermColor
A VTermScreenCell instance has the following field accessors:
A list of Unicode character numbers. This list does not include the terminating 0.
A UTF-8 string containing the characters (normally just one but it may be followed by zero-width combining marks).
The width of the cell in columns. Normally 1, but 2 for a Unicode double-width character, or the special value of -1 on the "second" cell of such a character.
Simple rendering attributes. All are boolean values, except underline which is an integer between 0 and 2 (to support double-underline).
underline
Font selection; an integer between 0 and 10.
The foreground and background colours, as VTermColor instances.
Paul Evans <leonerd@leonerd.org.uk>
To install Term::VTerm, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Term::VTerm
CPAN shell
perl -MCPAN -e shell install Term::VTerm
For more information on module installation, please visit the detailed CPAN module installation guide.