jexer.backend

Class ECMA48Terminal

java.lang.Object

jexer.backend.LogicalScreen

jexer.backend.ECMA48Terminal

All Implemented Interfaces:

java.lang.Runnable, Screen, TerminalReader

public class ECMA48Terminal
extends LogicalScreen
implements TerminalReader, java.lang.Runnable

This class reads keystrokes and mouse events and emits output to ANSI X3.64 / ECMA-48 type terminals e.g. xterm, linux, vt100, ansi.sys, etc.

Field Summary

Fields inherited from class jexer.backend.LogicalScreen

cursorVisible, cursorX, cursorY, height, logical, physical, reallyCleared, width

Constructor Summary

Constructors

Constructor and Description
ECMA48Terminal(java.lang.Object listener, java.io.InputStream input, java.io.OutputStream output) Constructor sets up state for getEvent().
ECMA48Terminal(java.lang.Object listener, java.io.InputStream input, java.io.OutputStream output, int windowWidth, int windowHeight) Constructor sets up state for getEvent().
ECMA48Terminal(java.lang.Object listener, java.io.InputStream input, java.io.Reader reader, java.io.PrintWriter writer) Constructor sets up state for getEvent().
ECMA48Terminal(java.lang.Object listener, java.io.InputStream input, java.io.Reader reader, java.io.PrintWriter writer, boolean setRawMode) Constructor sets up state for getEvent().

Method Summary

Modifier and Type	Method and Description
void	closeTerminal() Restore terminal to normal state.
void	flush() Flush output.
void	flushPhysical() Push the logical screen to the physical device.
void	getEvents(java.util.List<TInputEvent> queue) Return any events in the IO queue.
java.io.PrintWriter	getOutput() Get the output writer.
SessionInfo	getSessionInfo() Getter for sessionInfo.
int	getSixelPaletteSize() Get the number of colors in the sixel palette.
int	getTextHeight() Get the height of a character cell in pixels.
int	getTextWidth() Get the width of a character cell in pixels.
boolean	hasEvents() Check if there are events in the queue.
boolean	hasSixel() Get the sixel support flag.
void	reloadOptions() Reload options from System properties.
void	resizeToScreen() Resize the physical screen to match the logical screen dimensions.
void	run() Read function runs on a separate thread.
void	setListener(java.lang.Object listener) Set listener to a different Object.
void	setSixelPaletteSize(int paletteSize) Set the number of colors in the sixel palette.
void	setTitle(java.lang.String title) Set the window title.

Methods inherited from class jexer.backend.LogicalScreen

clear, clearPhysical, drawBox, drawBox, drawBoxShadow, getAttrXY, getCharXY, getClipBottom, getClipLeft, getClipRight, getClipTop, getCursorX, getCursorY, getHeight, getWidth, hideCursor, hLineXY, isCursorVisible, isDirty, putAll, putAttrXY, putAttrXY, putCharXY, putCharXY, putCharXY, putCursor, putFullwidthCharXY, putFullwidthCharXY, putFullwidthCharXY, putStringXY, putStringXY, reset, resetClipping, setClipBottom, setClipLeft, setClipRight, setClipTop, setDimensions, setHeight, setOffsetX, setOffsetY, setWidth, unsetImageRow, vLineXY

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ECMA48Terminal

public ECMA48Terminal(java.lang.Object listener,
                      java.io.InputStream input,
                      java.io.OutputStream output,
                      int windowWidth,
                      int windowHeight)
               throws java.io.UnsupportedEncodingException

Constructor sets up state for getEvent(). If either windowWidth or windowHeight are less than 1, the terminal is not resized.

Parameters:

listener - the object this backend needs to wake up when new input comes in

input - an InputStream connected to the remote user, or null for System.in. If System.in is used, then on non-Windows systems it will be put in raw mode; closeTerminal() will (blindly!) put System.in in cooked mode. input is always converted to a Reader with UTF-8 encoding.

output - an OutputStream connected to the remote user, or null for System.out. output is always converted to a Writer with UTF-8 encoding.

windowWidth - the number of text columns to start with

windowHeight - the number of text rows to start with

Throws:

java.io.UnsupportedEncodingException - if an exception is thrown when creating the InputStreamReader

ECMA48Terminal

public ECMA48Terminal(java.lang.Object listener,
                      java.io.InputStream input,
                      java.io.OutputStream output)
               throws java.io.UnsupportedEncodingException

Constructor sets up state for getEvent().

Parameters:

listener - the object this backend needs to wake up when new input comes in

input - an InputStream connected to the remote user, or null for System.in. If System.in is used, then on non-Windows systems it will be put in raw mode; closeTerminal() will (blindly!) put System.in in cooked mode. input is always converted to a Reader with UTF-8 encoding.

output - an OutputStream connected to the remote user, or null for System.out. output is always converted to a Writer with UTF-8 encoding.

Throws:

java.io.UnsupportedEncodingException - if an exception is thrown when creating the InputStreamReader

ECMA48Terminal

public ECMA48Terminal(java.lang.Object listener,
                      java.io.InputStream input,
                      java.io.Reader reader,
                      java.io.PrintWriter writer,
                      boolean setRawMode)

Constructor sets up state for getEvent().

Parameters:

listener - the object this backend needs to wake up when new input comes in

input - the InputStream underlying 'reader'. Its available() method is used to determine if reader.read() will block or not.

reader - a Reader connected to the remote user.

writer - a PrintWriter connected to the remote user.

setRawMode - if true, set System.in into raw mode with stty. This should in general not be used. It is here solely for Demo3, which uses System.in.

Throws:

java.lang.IllegalArgumentException - if input, reader, or writer are null.

ECMA48Terminal

public ECMA48Terminal(java.lang.Object listener,
                      java.io.InputStream input,
                      java.io.Reader reader,
                      java.io.PrintWriter writer)

Constructor sets up state for getEvent().

Parameters:

listener - the object this backend needs to wake up when new input comes in

input - the InputStream underlying 'reader'. Its available() method is used to determine if reader.read() will block or not.

reader - a Reader connected to the remote user.

writer - a PrintWriter connected to the remote user.

Throws:

java.lang.IllegalArgumentException - if input, reader, or writer are null.

Method Detail

setTitle

public void setTitle(java.lang.String title)

Set the window title.

Specified by:

setTitle in interface Screen

Overrides:

setTitle in class LogicalScreen

Parameters:

title - the new title

flushPhysical

public void flushPhysical()

Push the logical screen to the physical device.

Specified by:

flushPhysical in interface Screen

Overrides:

flushPhysical in class LogicalScreen

resizeToScreen

public void resizeToScreen()

Resize the physical screen to match the logical screen dimensions.

Overrides:

resizeToScreen in class LogicalScreen

hasEvents

public boolean hasEvents()

Check if there are events in the queue.

Specified by:

hasEvents in interface TerminalReader

Returns:

if true, getEvents() has something to return to the backend

getEvents

public void getEvents(java.util.List<TInputEvent> queue)

Return any events in the IO queue.

Specified by:

getEvents in interface TerminalReader

Parameters:

queue - list to append new events to

closeTerminal

public void closeTerminal()

Restore terminal to normal state.

Specified by:

closeTerminal in interface TerminalReader

setListener

public void setListener(java.lang.Object listener)

Set listener to a different Object.

Specified by:

setListener in interface TerminalReader

Parameters:

listener - the new listening object that run() wakes up on new input

reloadOptions

public void reloadOptions()

Reload options from System properties.

Specified by:

reloadOptions in interface TerminalReader

run

public void run()

Read function runs on a separate thread.

Specified by:

run in interface java.lang.Runnable

getTextWidth

public int getTextWidth()

Get the width of a character cell in pixels.

Specified by:

getTextWidth in interface Screen

Overrides:

getTextWidth in class LogicalScreen

Returns:

the width in pixels of a character cell

getTextHeight

public int getTextHeight()

Get the height of a character cell in pixels.

Specified by:

getTextHeight in interface Screen

Overrides:

getTextHeight in class LogicalScreen

Returns:

the height in pixels of a character cell

getSessionInfo

public SessionInfo getSessionInfo()

Getter for sessionInfo.

Returns:

the SessionInfo

getOutput

public java.io.PrintWriter getOutput()

Get the output writer.

Returns:

the Writer

flush

public void flush()

Flush output.

getSixelPaletteSize

public int getSixelPaletteSize()

Get the number of colors in the sixel palette.

Returns:

the palette size

setSixelPaletteSize

public void setSixelPaletteSize(int paletteSize)

Set the number of colors in the sixel palette.

Parameters:

paletteSize - the new palette size

hasSixel

public boolean hasSixel()

Get the sixel support flag.

Returns:

true if this terminal is emitting sixel