A simple screen buffer component
A ScreenBuffer represents a visible portion of a terminal in a screen. A ScreenBuffer contains a lot of cells. Each cell contains a character and attributes, such as color and boldness. It also keeps track of cursor position.
var ScreenBuffer = require'screen-buffer'
<!-- if you need .diff --><!-- if you need .patch -->
Currently the attributes is a 21-bit integer. From MSB:
- 1 bit - inverse video flag
- 1 bit - underline flag
- 1 bit - bold flag
- 9 bits - foreground color (according to xterm-256)
- 9 bits - background color (according to xterm-256)
There are two special values for colors:
- 257 - default foreground color
- 256 - default background color
An empty cell: default background and foreground with space character.
Override this function to be notified when changes are made to the buffer.
The X position of the cursor (0 = leftmost)
The Y position of the cursor (0 = topmost)
Set one line of data in the ScreenBuffer. y is the row in the screen and data array looks like this: [ [attribute, character], ... ]
Returns the string in the display buffer.
Sets the cursor position.
The X position of the cursor.
The Y position of the cursor.
Returns the number of rows in the buffer.
Returns the number of characters in this row.
Resizes the number of rows.
Resizes the number of columns in the specified row.
Returns the cell at (row, col). Returned value is in form of [ attributes, ch ].
Sets the cell at (row, col). A cell is in form of [ attributes, ch ].
Resizes the screen buffer.
Returns a clone of the screen buffer.
Returns a row data array. Don't modify it!
Sometimes, you may want to stream the content of a screen buffer over the network.
You can use
ScreenBuffer.patch for this.
Suppose that you have two ScreenBuffer objects,
var operations = ScreenBufferdiffb a
This will compute the operations that needs to be done on
to make its contents equal to
The returned result is an array of operations,
which can be sent over the wire to another user.
At the other side, when they received the operations, they can apply it to their own buffer like this:
Computes the list of operation to be applied on the source to make it match the target.
A returned result will have this structure:
An OPERATION represents an operation:
ROWS(resize number of rows)
[X, Y](set cursor position)
[row, 0, COLUMNS](resize column)
[row, 1, SOURCE ROW INDEX](copy)
[row, column, "TEXT", "COMPRESSED ATTRIBUTE,..."](draw text)
A COMPRESSED ATTRIBUTE has the form:
Applies the operations from the diff array onto the screenbuffer.