Skip to content

Modern Tui TuiSgr

Paul Squires edited this page Oct 19, 2026 · 6 revisions

Home › Terminal TUI Library › Colour and Style › TuiSgr

TuiSgr

Returns the escape sequence that changes the terminal from one style to another.

Syntax

TuiSgr( byval prev as TuiStyle, byval want as TuiStyle, byval depth as TuiColorDepth ) as string

Description

The escape sequence that moves a terminal from one style to another at a given depth, and NOTHING more -- it emits only the difference. This is the encoder the diff renderer drives; you need it only if you are writing bytes yourself.

Example

#import "std/tui"
using tui

dim as TuiStyle a = TuiStyleDefault( )
dim as TuiStyle b = TuiStyleOf( TuiRgb( 235, 80, 80 ), TuiDefaultColor( ), TUIATTR_BOLD )

dim as ustring seq = TuiSgr( a, b, TUIDEPTH_TRUECOLOR )
print len( seq )                       '' 19 -- bold plus a 24-bit foreground
print len( TuiSgr( b, b, TUIDEPTH_TRUECOLOR ) )   '' 0 -- nothing changed,
                                       '' nothing emitted

See also

TuiColor TuiColor.Equals TuiDefaultColor TuiIndexed TuiBlack TuiGreen
TuiColor.IsDefault TuiColor.Index TuiAnsi TuiRgb TuiRed TuiYellow

Library: Terminal TUI Library
Category: Terminal TUI Library
Documented under: Colour and Style
Working examples: hello.tiko · form.tiko · dashboard.tiko


Home · Keyword Index

Clone this wiki locally