Modern Tui TuiRenderOnce

Home › Terminal TUI Library › Application Loop › TuiRenderOnce

TuiRenderOnce

Runs Init and View once with no terminal and returns the bytes it would write.

Syntax

TuiRenderOnce( byref app as TuiApp, byref scr as TuiScreen ) as string

Description

One Init/View cycle against a screen with NO TERMINAL AT ALL, returning the bytes the renderer would have written. This is how the module tests applications and how the benchmark measures frame cost -- and it is how you should test yours.

Example

#import "std/tui"
using tui

dim as CounterApp app             '' see TuiApp for its definition
dim as TuiScreen scr
scr.Resize( 40, 10 )
app.Init( )

print len( TuiRenderOnce( app, scr ) ) > 0   '' true  -- the first frame
print len( TuiRenderOnce( app, scr ) )       '' 0     -- nothing changed

app.n = 1
print len( TuiRenderOnce( app, scr ) ) > 0   '' true  -- one change, one frame

See also

TuiApp	TuiApp.Update	TuiApp.Shutdown	TuiNone	TuiQuit	TuiInvalidate
TuiApp.Init	TuiApp.View	TuiCmd	TuiRedraw	TuiTick	TuiSuspend

---

Library: Terminal TUI Library
Category: Terminal TUI Library
Documented under: Application Loop
Working examples: hello.tiko · form.tiko · dashboard.tiko

---

Home · Keyword Index