Screen Class Reference

A rectangular grid of Pixel. More...

Inheritance diagram for Screen:

Data Structures
struct	Cursor

Public Member Functions
	Screen (int dimx, int dimy)
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 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
Box	stencil

Protected Attributes
Cursor	cursor_
std::vector< std::string >	hyperlinks_ = {""}
int	dimx_
int	dimy_
std::vector< std::vector< Pixel > >	pixels_

Detailed Description

A rectangular grid of Pixel.

Definition at line 25 of file screen.hpp.

Constructor & Destructor Documentation

Screen()

Screen	(	int	dimx,
		int	dimy
	)

Definition at line 392 of file screen.cpp.

Member Function Documentation

Create() [1/2]

Screen Create ( Dimensions  dimension )

static

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  )

static

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

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

Definition at line 446 of file screen.cpp.

Clear()

void Clear

(

)

Clear all the pixel from the screen.

Definition at line 488 of file screen.cpp.

ResetPosition()

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.

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

(

)

Definition at line 500 of file screen.cpp.

cursor()

Cursor cursor ( ) const

inline

Definition at line 62 of file screen.hpp.

SetCursor()

void SetCursor ( Cursor  cursor )

inline

Definition at line 63 of file screen.hpp.

RegisterHyperlink()

std::uint8_t RegisterHyperlink

(

const std::string &

link

)

Definition at line 527 of file screen.cpp.

Hyperlink()

const std::string & Hyperlink

(

uint8_t

id

)

const

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

cursor_

Cursor cursor_

protected

Definition at line 71 of file screen.hpp.

hyperlinks_

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

protected

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/screen/screen.hpp
• src/ftxui/screen/screen.cpp