Package org.fusesource.jansi
Class Ansi
- java.lang.Object
-
- org.fusesource.jansi.Ansi
-
- All Implemented Interfaces:
Appendable
public class Ansi extends Object implements Appendable
Provides a fluent API for generating ANSI escape sequences.- Since:
- 1.0
- Author:
- Hiram Chirino
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
Ansi.Attribute
Display attributes, also know as SGR (Select Graphic Rendition) parameters.static class
Ansi.Color
ANSI 8 colors for fluent APIstatic interface
Ansi.Consumer
static class
Ansi.Erase
ED (Erase in Display) / EL (Erase in Line) parameter (see CSI sequence J and K)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description Ansi
a(boolean value)
Ansi
a(char value)
Ansi
a(char[] value)
Ansi
a(char[] value, int offset, int len)
Ansi
a(double value)
Ansi
a(float value)
Ansi
a(int value)
Ansi
a(long value)
Ansi
a(CharSequence value)
Ansi
a(CharSequence value, int start, int end)
Ansi
a(Object value)
Ansi
a(String value)
Ansi
a(StringBuffer value)
Ansi
a(Ansi.Attribute attribute)
static Ansi
ansi()
static Ansi
ansi(int size)
static Ansi
ansi(StringBuilder builder)
Ansi
append(char c)
Ansi
append(CharSequence csq)
Ansi
append(CharSequence csq, int start, int end)
Ansi
apply(Ansi.Consumer fun)
Applies another function to this Ansi instance.Ansi
bg(int color)
Ansi
bg(Ansi.Color color)
Ansi
bgBright(Ansi.Color color)
Ansi
bgBrightCyan()
Ansi
bgBrightDefault()
Ansi
bgBrightGreen()
Ansi
bgBrightMagenta()
Ansi
bgBrightRed()
Ansi
bgBrightYellow()
Ansi
bgCyan()
Ansi
bgDefault()
Ansi
bgGreen()
Ansi
bgMagenta()
Ansi
bgRed()
Ansi
bgRgb(int color)
Ansi
bgRgb(int r, int g, int b)
Ansi
bgYellow()
Ansi
bold()
Ansi
boldOff()
Ansi
cursor(int row, int column)
Moves the cursor to row n, column m.Ansi
cursorDown(int y)
Moves the cursor down.Ansi
cursorDownLine()
Moves the cursor to the beginning of the line below.Ansi
cursorDownLine(int n)
Moves the cursor to the beginning of the n-th line below.Ansi
cursorLeft(int x)
Moves the cursor left.Ansi
cursorMove(int x, int y)
Moves the cursor relative to the current position.Ansi
cursorRight(int x)
Moves the cursor right.Ansi
cursorToColumn(int x)
Moves the cursor to column n.Ansi
cursorUp(int y)
Moves the cursor up.Ansi
cursorUpLine()
Moves the cursor to the beginning of the line above.Ansi
cursorUpLine(int n)
Moves the cursor to the beginning of the n-th line above.Ansi
eraseLine()
Ansi
eraseLine(Ansi.Erase kind)
Ansi
eraseScreen()
Ansi
eraseScreen(Ansi.Erase kind)
Ansi
fg(int color)
Ansi
fg(Ansi.Color color)
Ansi
fgBlack()
Ansi
fgBlue()
Ansi
fgBright(Ansi.Color color)
Ansi
fgBrightBlack()
Ansi
fgBrightBlue()
Ansi
fgBrightCyan()
Ansi
fgBrightDefault()
Ansi
fgBrightGreen()
Ansi
fgBrightMagenta()
Ansi
fgBrightRed()
Ansi
fgBrightYellow()
Ansi
fgCyan()
Ansi
fgDefault()
Ansi
fgGreen()
Ansi
fgMagenta()
Ansi
fgRed()
Ansi
fgRgb(int color)
Ansi
fgRgb(int r, int g, int b)
Ansi
fgYellow()
Ansi
format(String pattern, Object... args)
static boolean
isDetected()
static boolean
isEnabled()
Ansi
newline()
Ansi
render(String text)
Uses theAnsiRenderer
to generate the ANSI escape sequences for the supplied text.Ansi
render(String text, Object... args)
String formats and renders the supplied arguments.Ansi
reset()
Ansi
restorCursorPosition()
Deprecated.Ansi
restoreCursorPosition()
Ansi
saveCursorPosition()
Ansi
scrollDown(int rows)
Ansi
scrollUp(int rows)
static void
setDetector(Callable<Boolean> detector)
static void
setEnabled(boolean flag)
String
toString()
-
-
-
Method Detail
-
setDetector
public static void setDetector(Callable<Boolean> detector)
-
isDetected
public static boolean isDetected()
-
setEnabled
public static void setEnabled(boolean flag)
-
isEnabled
public static boolean isEnabled()
-
ansi
public static Ansi ansi(StringBuilder builder)
-
fg
public Ansi fg(Ansi.Color color)
-
bg
public Ansi bg(Ansi.Color color)
-
fgBright
public Ansi fgBright(Ansi.Color color)
-
fgBrightBlack
public Ansi fgBrightBlack()
-
fgBrightBlue
public Ansi fgBrightBlue()
-
fgBrightCyan
public Ansi fgBrightCyan()
-
fgBrightDefault
public Ansi fgBrightDefault()
-
fgBrightGreen
public Ansi fgBrightGreen()
-
fgBrightMagenta
public Ansi fgBrightMagenta()
-
fgBrightRed
public Ansi fgBrightRed()
-
fgBrightYellow
public Ansi fgBrightYellow()
-
bgBright
public Ansi bgBright(Ansi.Color color)
-
bgBrightCyan
public Ansi bgBrightCyan()
-
bgBrightDefault
public Ansi bgBrightDefault()
-
bgBrightGreen
public Ansi bgBrightGreen()
-
bgBrightMagenta
public Ansi bgBrightMagenta()
-
bgBrightRed
public Ansi bgBrightRed()
-
bgBrightYellow
public Ansi bgBrightYellow()
-
a
public Ansi a(Ansi.Attribute attribute)
-
cursor
public Ansi cursor(int row, int column)
Moves the cursor to row n, column m. The values are 1-based. Any values less than 1 are mapped to 1.- Parameters:
row
- row (1-based) from topcolumn
- column (1 based) from left- Returns:
- this Ansi instance
-
cursorToColumn
public Ansi cursorToColumn(int x)
Moves the cursor to column n. The parameter n is 1-based. If n is less than 1 it is moved to the first column.- Parameters:
x
- the index (1-based) of the column to move to- Returns:
- this Ansi instance
-
cursorUp
public Ansi cursorUp(int y)
Moves the cursor up. If the parameter y is negative it moves the cursor down.- Parameters:
y
- the number of lines to move up- Returns:
- this Ansi instance
-
cursorDown
public Ansi cursorDown(int y)
Moves the cursor down. If the parameter y is negative it moves the cursor up.- Parameters:
y
- the number of lines to move down- Returns:
- this Ansi instance
-
cursorRight
public Ansi cursorRight(int x)
Moves the cursor right. If the parameter x is negative it moves the cursor left.- Parameters:
x
- the number of characters to move right- Returns:
- this Ansi instance
-
cursorLeft
public Ansi cursorLeft(int x)
Moves the cursor left. If the parameter x is negative it moves the cursor right.- Parameters:
x
- the number of characters to move left- Returns:
- this Ansi instance
-
cursorMove
public Ansi cursorMove(int x, int y)
Moves the cursor relative to the current position. The cursor is moved right if x is positive, left if negative and down if y is positive and up if negative.- Parameters:
x
- the number of characters to move horizontallyy
- the number of lines to move vertically- Returns:
- this Ansi instance
- Since:
- 2.2
-
cursorDownLine
public Ansi cursorDownLine()
Moves the cursor to the beginning of the line below.- Returns:
- this Ansi instance
-
cursorDownLine
public Ansi cursorDownLine(int n)
Moves the cursor to the beginning of the n-th line below. If the parameter n is negative it moves the cursor to the beginning of the n-th line above.- Parameters:
n
- the number of lines to move the cursor- Returns:
- this Ansi instance
-
cursorUpLine
public Ansi cursorUpLine()
Moves the cursor to the beginning of the line above.- Returns:
- this Ansi instance
-
cursorUpLine
public Ansi cursorUpLine(int n)
Moves the cursor to the beginning of the n-th line above. If the parameter n is negative it moves the cursor to the beginning of the n-th line below.- Parameters:
n
- the number of lines to move the cursor- Returns:
- this Ansi instance
-
eraseScreen
public Ansi eraseScreen()
-
eraseScreen
public Ansi eraseScreen(Ansi.Erase kind)
-
eraseLine
public Ansi eraseLine(Ansi.Erase kind)
-
scrollDown
public Ansi scrollDown(int rows)
-
saveCursorPosition
public Ansi saveCursorPosition()
-
restorCursorPosition
@Deprecated public Ansi restorCursorPosition()
Deprecated.
-
restoreCursorPosition
public Ansi restoreCursorPosition()
-
a
public Ansi a(CharSequence value, int start, int end)
-
a
public Ansi a(CharSequence value)
-
a
public Ansi a(StringBuffer value)
-
apply
public Ansi apply(Ansi.Consumer fun)
Applies another function to this Ansi instance.- Parameters:
fun
- the function to apply- Returns:
- this Ansi instance
- Since:
- 2.2
-
render
public Ansi render(String text)
Uses theAnsiRenderer
to generate the ANSI escape sequences for the supplied text.- Parameters:
text
- text- Returns:
- this
- Since:
- 2.2
-
render
public Ansi render(String text, Object... args)
String formats and renders the supplied arguments. Uses theAnsiRenderer
to generate the ANSI escape sequences.- Parameters:
text
- formatargs
- arguments- Returns:
- this
- Since:
- 2.2
-
append
public Ansi append(CharSequence csq)
- Specified by:
append
in interfaceAppendable
-
append
public Ansi append(CharSequence csq, int start, int end)
- Specified by:
append
in interfaceAppendable
-
append
public Ansi append(char c)
- Specified by:
append
in interfaceAppendable
-
-