jexer.backend

Class MultiScreen

java.lang.Object

jexer.backend.MultiScreen

All Implemented Interfaces:

Screen

public class MultiScreen
extends java.lang.Object
implements Screen

MultiScreen mirrors its I/O to several screens.

Constructor Summary

Constructors

Constructor and Description
MultiScreen(Screen screen) Public constructor requires one screen.

Method Summary

Modifier and Type	Method and Description
void	addScreen(Screen screen) Add a screen to the list.
void	clear() Clear the logical screen.
void	clearPhysical() Clear the physical screen.
void	drawBox(int left, int top, int right, int bottom, CellAttributes border, CellAttributes background) Draw a box with a border and empty background.
void	drawBox(int left, int top, int right, int bottom, CellAttributes border, CellAttributes background, int borderType, boolean shadow) Draw a box with a border and empty background.
void	drawBoxShadow(int left, int top, int right, int bottom) Draw a box shadow.
void	flushPhysical() Classes must provide an implementation to push the logical screen to the physical device.
CellAttributes	getAttrXY(int x, int y) Get the attributes at one location.
Cell	getCharXY(int x, int y) Get the cell at one location.
int	getClipBottom() Get bottom drawing clipping boundary.
int	getClipLeft() Get left drawing clipping boundary.
int	getClipRight() Get right drawing clipping boundary.
int	getClipTop() Get top drawing clipping boundary.
int	getCursorX() Get the cursor X position.
int	getCursorY() Get the cursor Y position.
int	getHeight() Get the height.
int	getTextHeight() Get the height of a character cell in pixels.
int	getTextWidth() Get the width of a character cell in pixels.
int	getWidth() Get the width.
void	hideCursor() Hide the cursor.
void	hLineXY(int x, int y, int n, int ch, CellAttributes attr) Draw a horizontal line from (x, y) to (x + n, y).
boolean	isCursorVisible() Get the cursor visibility.
boolean	isDirty() Get dirty flag.
void	putAll(int ch, CellAttributes attr) Fill the entire screen with one character with attributes.
void	putAttrXY(int x, int y, CellAttributes attr) Set the attributes at one location.
void	putAttrXY(int x, int y, CellAttributes attr, boolean clip) Set the attributes at one location.
void	putCharXY(int x, int y, Cell ch) Render one character with attributes.
void	putCharXY(int x, int y, int ch) Render one character without changing the underlying attributes.
void	putCharXY(int x, int y, int ch, CellAttributes attr) Render one character with attributes.
void	putCursor(boolean visible, int x, int y) Put the cursor at (x,y).
void	putStringXY(int x, int y, java.lang.String str) Render a string without changing the underlying attribute.
void	putStringXY(int x, int y, java.lang.String str, CellAttributes attr) Render a string.
void	removeScreen(Screen screen) Remove a screen from the list.
void	reset() Reset screen to not-bold, white-on-black.
void	resetClipping() Flush the offset and clip variables.
void	setClipBottom(int clipBottom) Set bottom drawing clipping boundary.
void	setClipLeft(int clipLeft) Set left drawing clipping boundary.
void	setClipRight(int clipRight) Set right drawing clipping boundary.
void	setClipTop(int clipTop) Set top drawing clipping boundary.
void	setDimensions(int width, int height) Change the width and height.
void	setHeight(int height) Change the height.
void	setOffsetX(int offsetX) Set drawing offset for x.
void	setOffsetY(int offsetY) Set drawing offset for y.
void	setTitle(java.lang.String title) Set the window title.
void	setWidth(int width) Change the width.
void	unsetImageRow(int y) Unset every image cell on one row of the physical screen, forcing images on that row to be redrawn.
void	vLineXY(int x, int y, int n, int ch, CellAttributes attr) Draw a vertical line from (x, y) to (x, y + n).

Methods inherited from class java.lang.Object

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

Constructor Detail

MultiScreen

public MultiScreen(Screen screen)

Public constructor requires one screen.

Parameters:

screen - the screen to add

Method Detail

setOffsetX

public void setOffsetX(int offsetX)

Set drawing offset for x.

Specified by:

setOffsetX in interface Screen

Parameters:

offsetX - new drawing offset

setOffsetY

public void setOffsetY(int offsetY)

Set drawing offset for y.

Specified by:

setOffsetY in interface Screen

Parameters:

offsetY - new drawing offset

getClipRight

public int getClipRight()

Get right drawing clipping boundary.

Specified by:

getClipRight in interface Screen

Returns:

drawing boundary

setClipRight

public void setClipRight(int clipRight)

Set right drawing clipping boundary.

Specified by:

setClipRight in interface Screen

Parameters:

clipRight - new boundary

getClipBottom

public int getClipBottom()

Get bottom drawing clipping boundary.

Specified by:

getClipBottom in interface Screen

Returns:

drawing boundary

setClipBottom

public void setClipBottom(int clipBottom)

Set bottom drawing clipping boundary.

Specified by:

setClipBottom in interface Screen

Parameters:

clipBottom - new boundary

getClipLeft

public int getClipLeft()

Get left drawing clipping boundary.

Specified by:

getClipLeft in interface Screen

Returns:

drawing boundary

setClipLeft

public void setClipLeft(int clipLeft)

Set left drawing clipping boundary.

Specified by:

setClipLeft in interface Screen

Parameters:

clipLeft - new boundary

getClipTop

public int getClipTop()

Get top drawing clipping boundary.

Specified by:

getClipTop in interface Screen

Returns:

drawing boundary

setClipTop

public void setClipTop(int clipTop)

Set top drawing clipping boundary.

Specified by:

setClipTop in interface Screen

Parameters:

clipTop - new boundary

isDirty

public boolean isDirty()

Get dirty flag.

Specified by:

isDirty in interface Screen

Returns:

if true, the logical screen is not in sync with the physical screen

getAttrXY

public CellAttributes getAttrXY(int x,
                                int y)

Get the attributes at one location.

Specified by:

getAttrXY in interface Screen

Parameters:

x - column coordinate. 0 is the left-most column.

y - row coordinate. 0 is the top-most row.

Returns:

attributes at (x, y)

getCharXY

public Cell getCharXY(int x,
                      int y)

Get the cell at one location.

Specified by:

getCharXY in interface Screen

Parameters:

x - column coordinate. 0 is the left-most column.

y - row coordinate. 0 is the top-most row.

Returns:

the character + attributes

putAttrXY

public void putAttrXY(int x,
                      int y,
                      CellAttributes attr)

Set the attributes at one location.

Specified by:

putAttrXY in interface Screen

Parameters:

x - column coordinate. 0 is the left-most column.

y - row coordinate. 0 is the top-most row.

attr - attributes to use (bold, foreColor, backColor)

putAttrXY

public void putAttrXY(int x,
                      int y,
                      CellAttributes attr,
                      boolean clip)

Set the attributes at one location.

Specified by:

putAttrXY in interface Screen

Parameters:

x - column coordinate. 0 is the left-most column.

y - row coordinate. 0 is the top-most row.

attr - attributes to use (bold, foreColor, backColor)

clip - if true, honor clipping/offset

putAll

public void putAll(int ch,
                   CellAttributes attr)

Fill the entire screen with one character with attributes.

Specified by:

putAll in interface Screen

Parameters:

ch - character to draw

attr - attributes to use (bold, foreColor, backColor)

putCharXY

public void putCharXY(int x,
                      int y,
                      Cell ch)

Render one character with attributes.

Specified by:

putCharXY in interface Screen

Parameters:

x - column coordinate. 0 is the left-most column.

y - row coordinate. 0 is the top-most row.

ch - character + attributes to draw

putCharXY

public void putCharXY(int x,
                      int y,
                      int ch,
                      CellAttributes attr)

Render one character with attributes.

Specified by:

putCharXY in interface Screen

Parameters:

x - column coordinate. 0 is the left-most column.

y - row coordinate. 0 is the top-most row.

ch - character to draw

attr - attributes to use (bold, foreColor, backColor)

putCharXY

public void putCharXY(int x,
                      int y,
                      int ch)

Render one character without changing the underlying attributes.

Specified by:

putCharXY in interface Screen

Parameters:

x - column coordinate. 0 is the left-most column.

y - row coordinate. 0 is the top-most row.

ch - character to draw

putStringXY

public void putStringXY(int x,
                        int y,
                        java.lang.String str,
                        CellAttributes attr)

Render a string. Does not wrap if the string exceeds the line.

Specified by:

putStringXY in interface Screen

Parameters:

x - column coordinate. 0 is the left-most column.

y - row coordinate. 0 is the top-most row.

str - string to draw

attr - attributes to use (bold, foreColor, backColor)

putStringXY

public void putStringXY(int x,
                        int y,
                        java.lang.String str)

Render a string without changing the underlying attribute. Does not wrap if the string exceeds the line.

Specified by:

putStringXY in interface Screen

Parameters:

x - column coordinate. 0 is the left-most column.

y - row coordinate. 0 is the top-most row.

str - string to draw

vLineXY

public void vLineXY(int x,
                    int y,
                    int n,
                    int ch,
                    CellAttributes attr)

Draw a vertical line from (x, y) to (x, y + n).

Specified by:

vLineXY in interface Screen

Parameters:

x - column coordinate. 0 is the left-most column.

y - row coordinate. 0 is the top-most row.

n - number of characters to draw

ch - character to draw

attr - attributes to use (bold, foreColor, backColor)

hLineXY

public void hLineXY(int x,
                    int y,
                    int n,
                    int ch,
                    CellAttributes attr)

Draw a horizontal line from (x, y) to (x + n, y).

Specified by:

hLineXY in interface Screen

Parameters:

x - column coordinate. 0 is the left-most column.

y - row coordinate. 0 is the top-most row.

n - number of characters to draw

ch - character to draw

attr - attributes to use (bold, foreColor, backColor)

setWidth

public void setWidth(int width)

Change the width. Everything on-screen will be destroyed and must be redrawn.

Specified by:

setWidth in interface Screen

Parameters:

width - new screen width

setHeight

public void setHeight(int height)

Change the height. Everything on-screen will be destroyed and must be redrawn.

Specified by:

setHeight in interface Screen

Parameters:

height - new screen height

setDimensions

public void setDimensions(int width,
                          int height)

Change the width and height. Everything on-screen will be destroyed and must be redrawn.

Specified by:

setDimensions in interface Screen

Parameters:

width - new screen width

height - new screen height

getHeight

public int getHeight()

Get the height.

Specified by:

getHeight in interface Screen

Returns:

current screen height

getWidth

public int getWidth()

Get the width.

Specified by:

getWidth in interface Screen

Returns:

current screen width

reset

public void reset()

Reset screen to not-bold, white-on-black. Also flushes the offset and clip variables.

Specified by:

reset in interface Screen

resetClipping

public void resetClipping()

Flush the offset and clip variables.

Specified by:

resetClipping in interface Screen

clear

public void clear()

Clear the logical screen.

Specified by:

clear in interface Screen

drawBox

public void drawBox(int left,
                    int top,
                    int right,
                    int bottom,
                    CellAttributes border,
                    CellAttributes background)

Draw a box with a border and empty background.

Specified by:

drawBox in interface Screen

Parameters:

left - left column of box. 0 is the left-most row.

top - top row of the box. 0 is the top-most row.

right - right column of box

bottom - bottom row of the box

border - attributes to use for the border

background - attributes to use for the background

drawBox

public void drawBox(int left,
                    int top,
                    int right,
                    int bottom,
                    CellAttributes border,
                    CellAttributes background,
                    int borderType,
                    boolean shadow)

Draw a box with a border and empty background.

Specified by:

drawBox in interface Screen

Parameters:

left - left column of box. 0 is the left-most row.

top - top row of the box. 0 is the top-most row.

right - right column of box

bottom - bottom row of the box

border - attributes to use for the border

background - attributes to use for the background

borderType - if 1, draw a single-line border; if 2, draw a double-line border; if 3, draw double-line top/bottom edges and single-line left/right edges (like Qmodem)

shadow - if true, draw a "shadow" on the box

drawBoxShadow

public void drawBoxShadow(int left,
                          int top,
                          int right,
                          int bottom)

Draw a box shadow.

Specified by:

drawBoxShadow in interface Screen

Parameters:

left - left column of box. 0 is the left-most row.

top - top row of the box. 0 is the top-most row.

right - right column of box

bottom - bottom row of the box

clearPhysical

public void clearPhysical()

Clear the physical screen.

Specified by:

clearPhysical in interface Screen

unsetImageRow

public final void unsetImageRow(int y)

Unset every image cell on one row of the physical screen, forcing images on that row to be redrawn.

Specified by:

unsetImageRow in interface Screen

Parameters:

y - row coordinate. 0 is the top-most row.

flushPhysical

public void flushPhysical()

Classes must provide an implementation to push the logical screen to the physical device.

Specified by:

flushPhysical in interface Screen

putCursor

public void putCursor(boolean visible,
                      int x,
                      int y)

Put the cursor at (x,y).

Specified by:

putCursor in interface Screen

Parameters:

visible - if true, the cursor should be visible

x - column coordinate to put the cursor on

y - row coordinate to put the cursor on

hideCursor

public void hideCursor()

Hide the cursor.

Specified by:

hideCursor in interface Screen

isCursorVisible

public boolean isCursorVisible()

Get the cursor visibility.

Specified by:

isCursorVisible in interface Screen

Returns:

true if the cursor is visible

getCursorX

public int getCursorX()

Get the cursor X position.

Specified by:

getCursorX in interface Screen

Returns:

the cursor x column position

getCursorY

public int getCursorY()

Get the cursor Y position.

Specified by:

getCursorY in interface Screen

Returns:

the cursor y row position

setTitle

public void setTitle(java.lang.String title)

Set the window title.

Specified by:

setTitle in interface Screen

Parameters:

title - the new title

addScreen

public void addScreen(Screen screen)

Add a screen to the list.

Parameters:

screen - the screen to add

removeScreen

public void removeScreen(Screen screen)

Remove a screen from the list.

Parameters:

screen - the screen to remove

getTextWidth

public int getTextWidth()

Get the width of a character cell in pixels.

Specified by:

getTextWidth in interface Screen

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

Returns:

the height in pixels of a character cell