Renderer class

Manages frame buffers, terminal rendering, and output flushing.

Available extensions

Constructors

Renderer.create(int width, int height, {bool testing = false})
Opens guarded bindings and allocates a native renderer.
factory

Properties

autoFlush → bool
Gets the current auto-flush setting.
no setter
hashCode → int
The hash code for this object.
no setterinherited
nextBuffer → Buffer
The buffer for the next frame, created lazily and invalidated after each render call.
no setter
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

addToHitGrid(int x, int y, int width, int height, int id) → void
Registers a low-level native/debug hit-grid region.
checkHit(int x, int y) → int
Queries the low-level native/debug hit grid.
clearClipboard({TerminalClipboardTarget target = TerminalClipboardTarget.clipboard}) → bool

Available on Renderer, provided by the ClipboardSupport extension

Requests that target be cleared, reporting whether OpenTUI wrote it.
clearTerminal() → void
Clears the terminal screen.
copyToClipboard(String text, {TerminalClipboardTarget target = TerminalClipboardTarget.clipboard}) → bool

Available on Renderer, provided by the ClipboardSupport extension

Requests an explicit copy of text, reporting whether OpenTUI wrote it.
disableKittyKeyboard() → void

Available on Renderer, provided by the KeyboardSupport extension

Disables the Kitty keyboard protocol and reverts to standard terminal key reporting.
disableMouse() → void

Available on Renderer, provided by the MouseSupport extension

Disables mouse reporting.
dispose() → void
Releases all native renderer resources and detaches the finalizer.
enableKittyKeyboard({int flags = KittyFlags.disambiguateEscapeCodes}) → void

Available on Renderer, provided by the KeyboardSupport extension

Enables the Kitty keyboard protocol with the given flags.
enableMouse({bool enableMovement = false}) → void

Available on Renderer, provided by the MouseSupport extension

Enables mouse reporting; pass enableMovement to also track pointer moves.
hideCursor() → void

Available on Renderer, provided by the CursorManagement extension

Hides the cursor by setting it invisible at position (0, 0).
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
queryPixelResolution() → void
Requests a CSI 4;height;width t terminal pixel-resolution report.
render({bool force = false, bool? autoFlush}) → void
Renders the current buffer to the terminal.
resize(int width, int height) → void
Resize the renderer (and its underlying buffer) to new dimensions. Invalidates any cached nextBuffer reference.
setAutoFlush(bool enabled) → void
Sets the default auto-flush behavior for this renderer.
setBackgroundColor(Color color) → void
Sets the terminal background color to color.
setCursorColor(Color color) → void

Available on Renderer, provided by the CursorManagement extension

Sets the terminal cursor color.
setCursorPosition(int x, int y, {bool visible = true}) → void

Available on Renderer, provided by the CursorManagement extension

Set cursor position and visibility.
setCursorStyle(CursorStyle style, {bool blinking = false}) → void

Available on Renderer, provided by the CursorManagement extension

Sets the cursor style and whether it blinks.
setupTerminal({bool useAlternateScreen = true}) → void
Initialize terminal session (enter alt screen, set modes)
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited