Inheritance diagram for ScreenInteractive:

Data Structures
class	Private

Public Member Functions
void	TrackMouse (bool enable=true)
	Set whether mouse is tracked and events reported. called outside of the main loop. E.g `ScreenInteractive::Loop(...)`. More...

void	Loop (Component)
	Execute the main loop. More...

void	Exit ()
	Exit the main loop. More...

Closure	ExitLoopClosure ()
	Return a function to exit the main loop. More...

void	Post (Task task)
	Add a task to the main loop. It will be executed later, after every other scheduled tasks. More...

void	PostEvent (Event event)
	Add an event to the main loop. It will be executed later, after every other scheduled events. More...

void	RequestAnimationFrame ()
	Add a task to draw the screen one more time, until all the animations are done. More...

CapturedMouse	CaptureMouse ()
	Try to get the unique lock about behing able to capture the mouse. More...

Closure	WithRestoredIO (Closure)
	Decorate a function. It executes the same way, but with the currently active screen terminal hooks temporarilly uninstalled during its execution. More...

void	ForceHandleCtrlC (bool force)
	Force FTXUI to handle or not handle Ctrl-C, even if the component catches the Event::CtrlC. More...

void	ForceHandleCtrlZ (bool force)
	Force FTXUI to handle or not handle Ctrl-Z, even if the component catches the Event::CtrlZ. More...

std::string	ToString () const

void	Print () const

void	Clear ()
	Clear all the pixel from the screen. More...

std::string	ResetPosition (bool clear=false) const
	Return a string to be printed in order to reset the cursor position to the beginning of the screen. More...

void	ApplyShader ()

Cursor	cursor () const

void	SetCursor (Cursor cursor)

uint8_t	RegisterHyperlink (const std::string &link)

const std::string &	Hyperlink (uint8_t id) const

std::string &	at (int x, int y)
	Access a character in a cell at a given position. More...

const std::string &	at (int x, int y) const
	Access a character in a cell at a given position. More...

Pixel &	PixelAt (int x, int y)
	Access a cell (Pixel) at a given position. More...

const Pixel &	PixelAt (int x, int y) const
	Access a cell (Pixel) at a given position. More...

int	dimx () const

int	dimy () const

Static Public Member Functions
static ScreenInteractive	FixedSize (int dimx, int dimy)

static ScreenInteractive	Fullscreen ()

static ScreenInteractive	FullscreenPrimaryScreen ()

static ScreenInteractive	FullscreenAlternateScreen ()

static ScreenInteractive	FitComponent ()

static ScreenInteractive	TerminalOutput ()

static ScreenInteractive *	Active ()
	Return the currently active screen, or null if none. More...

static Screen	Create (Dimensions dimension)
	Create a screen with the given dimension. More...

static Screen	Create (Dimensions width, Dimensions height)
	Create a screen with the given dimension along the x-axis and y-axis. More...

Data Fields
friend	Private

Box	stencil

Protected Attributes
Cursor	cursor_

std::vector< std::string >	hyperlinks_ = {""}

int	dimx_

int	dimy_

std::vector< std::vector< Pixel > >	pixels_

Detailed Description

Definition at line 29 of file screen_interactive.hpp.

Member Function Documentation

◆ FixedSize()

ScreenInteractive FixedSize	(	int	dimx,
		int	dimy
	)

static

Definition at line 359 of file screen_interactive.cpp.

◆ Fullscreen()

ScreenInteractive Fullscreen ( )

static

Create a ScreenInteractive taking the full terminal size. This is using the alternate screen buffer to avoid messing with the terminal content.

Note: This is the same as ScreenInteractive::FullscreenAlternateScreen()

Examples: examples/component/flexbox_gallery.cpp, examples/component/focus.cpp, examples/component/focus_cursor.cpp, examples/component/homescreen.cpp, examples/component/linear_gradient_gallery.cpp, examples/component/resizable_split.cpp, examples/component/scrollbar.cpp, examples/component/textarea.cpp, examples/component/window.cpp, and examples/component/with_restored_io.cpp.

Definition at line 373 of file screen_interactive.cpp.

◆ FullscreenPrimaryScreen()

ScreenInteractive FullscreenPrimaryScreen ( )

static

Create a ScreenInteractive taking the full terminal size. The primary screen buffer is being used. It means if the terminal is resized, the previous content might mess up with the terminal content.

Definition at line 382 of file screen_interactive.cpp.

◆ FullscreenAlternateScreen()

ScreenInteractive FullscreenAlternateScreen ( )

static

Create a ScreenInteractive taking the full terminal size. This is using the alternate screen buffer to avoid messing with the terminal content.

Definition at line 395 of file screen_interactive.cpp.

◆ FitComponent()

ScreenInteractive FitComponent ( )

static

Examples: examples/component/button.cpp, examples/component/button_animated.cpp, examples/component/button_in_frame.cpp, examples/component/button_style.cpp, examples/component/canvas_animated.cpp, examples/component/checkbox_in_frame.cpp, examples/component/collapsible.cpp, examples/component/composition.cpp, examples/component/custom_loop.cpp, examples/component/dropdown.cpp, examples/component/dropdown_custom.cpp, examples/component/gallery.cpp, examples/component/menu_in_frame.cpp, examples/component/menu_in_frame_horizontal.cpp, examples/component/nested_screen.cpp, examples/component/radiobox_in_frame.cpp, and examples/component/renderer.cpp.

Definition at line 415 of file screen_interactive.cpp.

◆ TerminalOutput()

ScreenInteractive TerminalOutput ( )

static

◆ TrackMouse()

void TrackMouse ( bool enable = true )

Set whether mouse is tracked and events reported. called outside of the main loop. E.g ScreenInteractive::Loop(...).

Parameters

enable Whether to enable mouse event tracking.

Note: This muse be called outside of the main loop. E.g. before calling ScreenInteractive::Loop.; Mouse tracking is enabled by default.; Mouse tracking is only supported on terminals that supports it.

Example

auto screen = ScreenInteractive::TerminalOutput();
screen.TrackMouse(false);
screen.Loop(component);

Definition at line 440 of file screen_interactive.cpp.

◆ Active()

ScreenInteractive * Active ( )

static

Return the currently active screen, or null if none.

Definition at line 581 of file screen_interactive.cpp.

◆ Loop()

void Loop ( Component component )

Execute the main loop.

Parameters

component The component to draw.

Examples: examples/component/collapsible.cpp.

Definition at line 494 of file screen_interactive.cpp.

◆ Exit()

void Exit ( )

Exit the main loop.

Definition at line 944 of file screen_interactive.cpp.

◆ ExitLoopClosure()

Closure ExitLoopClosure ( )

Return a function to exit the main loop.

Definition at line 938 of file screen_interactive.cpp.

◆ Post()

void Post ( Task task )

Add a task to the main loop. It will be executed later, after every other scheduled tasks.

Definition at line 447 of file screen_interactive.cpp.

◆ PostEvent()

void PostEvent ( Event event )

Add an event to the main loop. It will be executed later, after every other scheduled events.

Definition at line 460 of file screen_interactive.cpp.

◆ RequestAnimationFrame()

void RequestAnimationFrame ( )

Add a task to draw the screen one more time, until all the animations are done.

Definition at line 466 of file screen_interactive.cpp.

◆ CaptureMouse()

CapturedMouse CaptureMouse ( )

Try to get the unique lock about behing able to capture the mouse.

Returns: A unique lock if the mouse is not already captured, otherwise a null.

Definition at line 482 of file screen_interactive.cpp.

◆ WithRestoredIO()

Closure WithRestoredIO ( Closure fn )

Decorate a function. It executes the same way, but with the currently active screen terminal hooks temporarilly uninstalled during its execution.

Parameters

fn	The function to decorate.

Definition at line 559 of file screen_interactive.cpp.

◆ ForceHandleCtrlC()

void ForceHandleCtrlC ( bool force )

Force FTXUI to handle or not handle Ctrl-C, even if the component catches the Event::CtrlC.

Definition at line 569 of file screen_interactive.cpp.

◆ ForceHandleCtrlZ()

void ForceHandleCtrlZ ( bool force )

Force FTXUI to handle or not handle Ctrl-Z, even if the component catches the Event::CtrlZ.

Definition at line 575 of file screen_interactive.cpp.

◆ Create() [1/2]

Screen Create ( Dimensions dimension )

staticinherited

Create a screen with the given dimension.

Examples: examples/dom/border.cpp, examples/dom/border_colored.cpp, examples/dom/border_style.cpp, examples/dom/canvas.cpp, examples/dom/color_gallery.cpp, examples/dom/color_info_palette256.cpp, examples/dom/color_truecolor_HSV.cpp, examples/dom/color_truecolor_RGB.cpp, examples/dom/dbox.cpp, examples/dom/graph.cpp, examples/dom/gridbox.cpp, examples/dom/hflow.cpp, examples/dom/html_like.cpp, examples/dom/linear_gradient.cpp, examples/dom/package_manager.cpp, examples/dom/separator.cpp, examples/dom/separator_style.cpp, examples/dom/size.cpp, examples/dom/spinner.cpp, examples/dom/style_blink.cpp, examples/dom/style_bold.cpp, examples/dom/style_color.cpp, examples/dom/style_dim.cpp, examples/dom/style_gallery.cpp, examples/dom/style_hyperlink.cpp, examples/dom/style_inverted.cpp, examples/dom/style_strikethrough.cpp, examples/dom/style_underlined.cpp, examples/dom/style_underlined_double.cpp, examples/dom/table.cpp, examples/dom/vbox_hbox.cpp, and examples/dom/vflow.cpp.

Definition at line 388 of file screen.cpp.

◆ Create() [2/2]

Screen Create	(	Dimensions	width,
		Dimensions	height
	)

staticinherited

Create a screen with the given dimension along the x-axis and y-axis.

Definition at line 382 of file screen.cpp.

◆ ToString()

std::string ToString ( ) const

inherited

Produce a std::string that can be used to print the Screen on the terminal.

Note: Don't forget to flush stdout. Alternatively, you can use Screen::Print();

Definition at line 409 of file screen.cpp.

◆ Print()

void Print ( ) const

inherited

Definition at line 446 of file screen.cpp.

◆ Clear()

void Clear ( )

inherited

Clear all the pixel from the screen.

Definition at line 488 of file screen.cpp.

◆ ResetPosition()

std::string ResetPosition ( bool clear = false ) const

inherited

Return a string to be printed in order to reset the cursor position to the beginning of the screen.

std::string reset_position;
while(true) {
  auto document = render();
  auto screen = Screen::Create(Dimension::Full(), Dimension::Fit(document));
  Render(screen, document);
  std::cout << reset_position << screen.ToString() << std::flush;
  reset_position = screen.ResetPosition();
 
  using namespace std::chrono_literals;
  std::this_thread::sleep_for(0.01s);
}

Returns: The string to print in order to reset the cursor position to the beginning.

Definition at line 469 of file screen.cpp.

◆ ApplyShader()

void ApplyShader ( )

inherited

Definition at line 500 of file screen.cpp.

◆ cursor()

Cursor cursor ( ) const

inlineinherited

Definition at line 62 of file screen.hpp.

◆ SetCursor()

void SetCursor ( Cursor cursor )

inlineinherited

Definition at line 63 of file screen.hpp.

◆ RegisterHyperlink()

std::uint8_t RegisterHyperlink ( const std::string & link )

inherited

Definition at line 527 of file screen.cpp.

◆ Hyperlink()

const std::string & Hyperlink ( uint8_t id ) const

inherited

Definition at line 540 of file screen.cpp.

◆ at() [1/2]

std::string & at	(	int	x,
		int	y
	)

inherited

Access a character in a cell at a given position.

Parameters

x	The cell position along the x-axis.
y	The cell position along the y-axis.

Definition at line 29 of file image.cpp.

◆ at() [2/2]

const std::string & at	(	int	x,
		int	y
	)		const

inherited

Access a character in a cell at a given position.

Parameters

x	The cell position along the x-axis.
y	The cell position along the y-axis.

Definition at line 36 of file image.cpp.

◆ PixelAt() [1/2]

Pixel & PixelAt	(	int	x,
		int	y
	)

inherited

Access a cell (Pixel) at a given position.

Parameters

x	The cell position along the x-axis.
y	The cell position along the y-axis.

Definition at line 43 of file image.cpp.

◆ PixelAt() [2/2]

const Pixel & PixelAt	(	int	x,
		int	y
	)		const

inherited

Access a cell (Pixel) at a given position.

Parameters

x	The cell position along the x-axis.
y	The cell position along the y-axis.

Definition at line 50 of file image.cpp.

◆ dimx()

int dimx ( ) const

inlineinherited

Definition at line 32 of file image.hpp.

◆ dimy()

int dimy ( ) const

inlineinherited

Definition at line 33 of file image.hpp.

Field Documentation

◆ Private

friend Private

Definition at line 139 of file screen_interactive.hpp.

◆ cursor_

Cursor cursor_

protectedinherited

Definition at line 71 of file screen.hpp.

◆ hyperlinks_

std::vector<std::string> hyperlinks_ = {""}

protectedinherited

Definition at line 72 of file screen.hpp.

◆ stencil

Box stencil

inherited

Definition at line 38 of file image.hpp.

◆ dimx_

int dimx_

protectedinherited

Definition at line 41 of file image.hpp.

◆ dimy_

int dimy_

protectedinherited

Definition at line 42 of file image.hpp.

◆ pixels_

std::vector<std::vector<Pixel> > pixels_

protectedinherited

Definition at line 43 of file image.hpp.

The documentation for this class was generated from the following files:

include/ftxui/component/screen_interactive.hpp
src/ftxui/component/screen_interactive.cpp

Data Structures

Public Member Functions

Static Public Member Functions

Data Fields

Protected Attributes

Detailed Description

Member Function Documentation

◆ FixedSize()

◆ Fullscreen()

◆ FullscreenPrimaryScreen()

◆ FullscreenAlternateScreen()

◆ FitComponent()

◆ TerminalOutput()

◆ TrackMouse()

Example

◆ Active()

◆ Loop()

◆ Exit()

◆ ExitLoopClosure()

◆ Post()

◆ PostEvent()

◆ RequestAnimationFrame()

◆ CaptureMouse()

◆ WithRestoredIO()

◆ ForceHandleCtrlC()

◆ ForceHandleCtrlZ()

◆ Create() [1/2]

◆ Create() [2/2]

◆ ToString()

◆ Print()

◆ Clear()

◆ ResetPosition()

◆ ApplyShader()

◆ cursor()

◆ SetCursor()

◆ RegisterHyperlink()

◆ Hyperlink()

◆ at() [1/2]

◆ at() [2/2]

◆ PixelAt() [1/2]

◆ PixelAt() [2/2]

◆ dimx()

◆ dimy()

Field Documentation

◆ Private

◆ cursor_

◆ hyperlinks_

◆ stencil

◆ dimx_

◆ dimy_

◆ pixels_