AnsiOutputStream (jansi API Reference (1.17.1))

java.lang.Object
- java.io.OutputStream
- - java.io.FilterOutputStream
  - - org.fusesource.jansi.AnsiOutputStream

All Implemented Interfaces:

java.io.Closeable, java.io.Flushable, java.lang.AutoCloseable

Direct Known Subclasses:

HtmlAnsiOutputStream, WindowsAnsiOutputStream
```
public class AnsiOutputStream
extends java.io.FilterOutputStream
```
A ANSI output stream extracts ANSI escape codes written to an output stream and calls corresponding process* methods.
For more information about ANSI escape codes, see Wikipedia article
This class just filters out the escape codes so that they are not sent out to the underlying OutputStream: process* methods are empty. Subclasses should actually perform the ANSI escape behaviors by implementing active code in process* methods.

Since:

1.0

Author:

Hiram Chirino, Joris Kuipers

See Also:

AnsiPrintStream

Field Summary

Fields
Modifier and Type	Field	Description
`protected static int`	`ATTRIBUTE_BLINK_FAST`
`protected static int`	`ATTRIBUTE_BLINK_OFF`
`protected static int`	`ATTRIBUTE_BLINK_SLOW`
`protected static int`	`ATTRIBUTE_CONCEAL_OFF`
`protected static int`	`ATTRIBUTE_CONCEAL_ON`
`protected static int`	`ATTRIBUTE_INTENSITY_BOLD`
`protected static int`	`ATTRIBUTE_INTENSITY_FAINT`
`protected static int`	`ATTRIBUTE_INTENSITY_NORMAL`
`protected static int`	`ATTRIBUTE_ITALIC`
`protected static int`	`ATTRIBUTE_NEGATIVE_Off`	Deprecated.
`protected static int`	`ATTRIBUTE_NEGATIVE_OFF`
`protected static int`	`ATTRIBUTE_NEGATIVE_ON`
`protected static int`	`ATTRIBUTE_UNDERLINE`
`protected static int`	`ATTRIBUTE_UNDERLINE_DOUBLE`
`protected static int`	`ATTRIBUTE_UNDERLINE_OFF`
`protected static int`	`BLACK`
`protected static int`	`BLUE`
`protected static int`	`CYAN`
`protected static int`	`ERASE_LINE`
`protected static int`	`ERASE_LINE_TO_BEGINING`
`protected static int`	`ERASE_LINE_TO_END`
`protected static int`	`ERASE_SCREEN`
`protected static int`	`ERASE_SCREEN_TO_BEGINING`
`protected static int`	`ERASE_SCREEN_TO_END`
`protected static int`	`GREEN`
`protected static int`	`MAGENTA`
`protected static int`	`RED`
`static byte[]`	`RESET_CODE`
`static byte[]`	`REST_CODE`	Deprecated.
`protected static int`	`WHITE`
`protected static int`	`YELLOW`

Fields inherited from class java.io.FilterOutputStream
out

Constructor Summary

Constructors
Constructor Description

AnsiOutputStream(java.io.OutputStream os)

Constructors
Constructor	Description
`AnsiOutputStream(java.io.OutputStream os)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`void`	`close()`
`protected void`	`processAttributeRest()`	process `SGR 0` corresponding to `Reset / Normal`
`protected void`	`processChangeIconName(java.lang.String label)`	process `OSC 1;text BEL` corresponding to `Change Icon label`
`protected void`	`processChangeIconNameAndWindowTitle(java.lang.String label)`	process `OSC 0;text BEL` corresponding to `Change Window and Icon label`
`protected void`	`processChangeWindowTitle(java.lang.String label)`	process `OSC 2;text BEL` corresponding to `Change Window title`
`protected void`	`processCharsetSelect(int set, char seq)`
`protected void`	`processCursorDown(int count)`	process `CSI n B` corresponding to `CUD – Cursor Down`
`protected void`	`processCursorDownLine(int count)`	process `CSI n E` corresponding to `CNL – Cursor Next Line`
`protected void`	`processCursorLeft(int count)`	process `CSI n D` corresponding to `CUB – Cursor Back`
`protected void`	`processCursorRight(int count)`	process `CSI n C` corresponding to `CUF – Cursor Forward`
`protected void`	`processCursorTo(int row, int col)`	process `CSI n ; m H` corresponding to `CUP – Cursor Position` or `CSI n ; m f` corresponding to `HVP – Horizontal and Vertical Position`
`protected void`	`processCursorToColumn(int x)`	process `CSI n G` corresponding to `CHA – Cursor Horizontal Absolute`
`protected void`	`processCursorUp(int count)`	process `CSI n A` corresponding to `CUU – Cursor Up`
`protected void`	`processCursorUpLine(int count)`	process `CSI n F` corresponding to `CPL – Cursor Previous Line`
`protected void`	`processDefaultBackgroundColor()`	process `SGR 49` corresponding to `Default background color`
`protected void`	`processDefaultTextColor()`	process `SGR 39` corresponding to `Default text color (foreground)`
`protected void`	`processDeleteLine(int optionInt)`	Process `CSI M` ANSI code, corresponding to `DL – Delete Line`
`protected void`	`processEraseLine(int eraseOption)`	Process `CSI n K` ANSI code, corresponding to `ED – Erase in Line`
`protected void`	`processEraseScreen(int eraseOption)`	Process `CSI n J` ANSI code, corresponding to `ED – Erase in Display`
`protected void`	`processInsertLine(int optionInt)`	Process `CSI L` ANSI code, corresponding to `IL – Insert Line`
`protected void`	`processRestoreCursorPosition()`	Process `CSI u` ANSI code, corresponding to `RCP – Restore Cursor Position`
`protected void`	`processSaveCursorPosition()`	Process `CSI s` ANSI code, corresponding to `SCP – Save Cursor Position`
`protected void`	`processScrollDown(int optionInt)`	Process `CSI n T` ANSI code, corresponding to `SD – Scroll Down`
`protected void`	`processScrollUp(int optionInt)`	Process `CSI n U` ANSI code, corresponding to `SU – Scroll Up`
`protected void`	`processSetAttribute(int attribute)`	process `SGR` other than `0` (reset), `30-39` (foreground), `40-49` (background), `90-97` (foreground high intensity) or `100-107` (background high intensity)
`protected void`	`processSetBackgroundColor(int color)`	process `SGR 40-47` corresponding to `Set background color`.
`protected void`	`processSetBackgroundColor(int color, boolean bright)`	process `SGR 40-47` or `SGR 100-107` corresponding to `Set background color` either in normal mode or high intensity.
`protected void`	`processSetBackgroundColorExt(int paletteIndex)`	process `SGR 48` corresponding to `extended set background color` with a palette of 255 colors.
`protected void`	`processSetBackgroundColorExt(int r, int g, int b)`	process `SGR 48` corresponding to `extended set background color` with a 24 bits RGB definition of the color.
`protected void`	`processSetForegroundColor(int color)`	process `SGR 30-37` corresponding to `Set text color (foreground)`.
`protected void`	`processSetForegroundColor(int color, boolean bright)`	process `SGR 30-37` or `SGR 90-97` corresponding to `Set text color (foreground)` either in normal mode or high intensity.
`protected void`	`processSetForegroundColorExt(int paletteIndex)`	process `SGR 38` corresponding to `extended set text color (foreground)` with a palette of 255 colors.
`protected void`	`processSetForegroundColorExt(int r, int g, int b)`	process `SGR 38` corresponding to `extended set text color (foreground)` with a 24 bits RGB definition of the color.
`protected void`	`processUnknownExtension(java.util.ArrayList<java.lang.Object> options, int command)`
`protected void`	`processUnknownOperatingSystemCommand(int command, java.lang.String param)`	Process unknown `OSC` command.
`void`	`write(int data)`

Methods inherited from class java.io.FilterOutputStream
flush, write, write

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - RESET_CODE
```
public static final byte[] RESET_CODE
```
  - REST_CODE
```
@Deprecated
public static final byte[] REST_CODE
```
    Deprecated.
  - ERASE_SCREEN_TO_END
```
protected static final int ERASE_SCREEN_TO_END
```
    See Also:
    
    Constant Field Values
  - ERASE_SCREEN_TO_BEGINING
```
protected static final int ERASE_SCREEN_TO_BEGINING
```
    See Also:
    
    Constant Field Values
  - ERASE_SCREEN
```
protected static final int ERASE_SCREEN
```
    See Also:
    
    Constant Field Values
  - ERASE_LINE_TO_END
```
protected static final int ERASE_LINE_TO_END
```
    See Also:
    
    Constant Field Values
  - ERASE_LINE_TO_BEGINING
```
protected static final int ERASE_LINE_TO_BEGINING
```
    See Also:
    
    Constant Field Values
  - ERASE_LINE
```
protected static final int ERASE_LINE
```
    See Also:
    
    Constant Field Values
  - ATTRIBUTE_INTENSITY_BOLD
```
protected static final int ATTRIBUTE_INTENSITY_BOLD
```
    See Also:
    
    Constant Field Values
  - ATTRIBUTE_INTENSITY_FAINT
```
protected static final int ATTRIBUTE_INTENSITY_FAINT
```
    See Also:
    
    Constant Field Values
  - ATTRIBUTE_ITALIC
```
protected static final int ATTRIBUTE_ITALIC
```
    See Also:
    
    Constant Field Values
  - ATTRIBUTE_UNDERLINE
```
protected static final int ATTRIBUTE_UNDERLINE
```
    See Also:
    
    Constant Field Values
  - ATTRIBUTE_BLINK_SLOW
```
protected static final int ATTRIBUTE_BLINK_SLOW
```
    See Also:
    
    Constant Field Values
  - ATTRIBUTE_BLINK_FAST
```
protected static final int ATTRIBUTE_BLINK_FAST
```
    See Also:
    
    Constant Field Values
  - ATTRIBUTE_NEGATIVE_ON
```
protected static final int ATTRIBUTE_NEGATIVE_ON
```
    See Also:
    
    Constant Field Values
  - ATTRIBUTE_CONCEAL_ON
```
protected static final int ATTRIBUTE_CONCEAL_ON
```
    See Also:
    
    Constant Field Values
  - ATTRIBUTE_UNDERLINE_DOUBLE
```
protected static final int ATTRIBUTE_UNDERLINE_DOUBLE
```
    See Also:
    
    Constant Field Values
  - ATTRIBUTE_INTENSITY_NORMAL
```
protected static final int ATTRIBUTE_INTENSITY_NORMAL
```
    See Also:
    
    Constant Field Values
  - ATTRIBUTE_UNDERLINE_OFF
```
protected static final int ATTRIBUTE_UNDERLINE_OFF
```
    See Also:
    
    Constant Field Values
  - ATTRIBUTE_BLINK_OFF
```
protected static final int ATTRIBUTE_BLINK_OFF
```
    See Also:
    
    Constant Field Values
  - ATTRIBUTE_NEGATIVE_Off
```
@Deprecated
protected static final int ATTRIBUTE_NEGATIVE_Off
```
    Deprecated.
    
    See Also:
    
    Constant Field Values
  - ATTRIBUTE_NEGATIVE_OFF
```
protected static final int ATTRIBUTE_NEGATIVE_OFF
```
    See Also:
    
    Constant Field Values
  - ATTRIBUTE_CONCEAL_OFF
```
protected static final int ATTRIBUTE_CONCEAL_OFF
```
    See Also:
    
    Constant Field Values
  - BLACK
```
protected static final int BLACK
```
    See Also:
    
    Constant Field Values
  - RED
```
protected static final int RED
```
    See Also:
    
    Constant Field Values
  - GREEN
```
protected static final int GREEN
```
    See Also:
    
    Constant Field Values
  - YELLOW
```
protected static final int YELLOW
```
    See Also:
    
    Constant Field Values
  - BLUE
```
protected static final int BLUE
```
    See Also:
    
    Constant Field Values
  - MAGENTA
```
protected static final int MAGENTA
```
    See Also:
    
    Constant Field Values
  - CYAN
```
protected static final int CYAN
```
    See Also:
    
    Constant Field Values
  - WHITE
```
protected static final int WHITE
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - AnsiOutputStream
```
public AnsiOutputStream(java.io.OutputStream os)
```
- Method Detail
  - write
```
public void write(int data)
           throws java.io.IOException
```
    Overrides:
    
    write in class java.io.FilterOutputStream
    
    Throws:
    
    java.io.IOException
  - processRestoreCursorPosition
```
protected void processRestoreCursorPosition()
                                     throws java.io.IOException
```
    Process CSI u ANSI code, corresponding to RCP – Restore Cursor Position
    
    Throws:
    
    java.io.IOException - IOException
  - processSaveCursorPosition
```
protected void processSaveCursorPosition()
                                  throws java.io.IOException
```
    Process CSI s ANSI code, corresponding to SCP – Save Cursor Position
    
    Throws:
    
    java.io.IOException - IOException
  - processInsertLine
```
protected void processInsertLine(int optionInt)
                          throws java.io.IOException
```
    Process CSI L ANSI code, corresponding to IL – Insert Line
    
    Parameters:
    
    optionInt - option
    
    Throws:
    
    java.io.IOException - IOException
    
    Since:
    
    1.16
  - processDeleteLine
```
protected void processDeleteLine(int optionInt)
                          throws java.io.IOException
```
    Process CSI M ANSI code, corresponding to DL – Delete Line
    
    Parameters:
    
    optionInt - option
    
    Throws:
    
    java.io.IOException - IOException
    
    Since:
    
    1.16
  - processScrollDown
```
protected void processScrollDown(int optionInt)
                          throws java.io.IOException
```
    Process CSI n T ANSI code, corresponding to SD – Scroll Down
    
    Parameters:
    
    optionInt - option
    
    Throws:
    
    java.io.IOException - IOException
  - processScrollUp
```
protected void processScrollUp(int optionInt)
                        throws java.io.IOException
```
    Process CSI n U ANSI code, corresponding to SU – Scroll Up
    
    Parameters:
    
    optionInt - option
    
    Throws:
    
    java.io.IOException - IOException
  - processEraseScreen
```
protected void processEraseScreen(int eraseOption)
                           throws java.io.IOException
```
    Process CSI n J ANSI code, corresponding to ED – Erase in Display
    
    Parameters:
    
    eraseOption - eraseOption
    
    Throws:
    
    java.io.IOException - IOException
  - processEraseLine
```
protected void processEraseLine(int eraseOption)
                         throws java.io.IOException
```
    Process CSI n K ANSI code, corresponding to ED – Erase in Line
    
    Parameters:
    
    eraseOption - eraseOption
    
    Throws:
    
    java.io.IOException - IOException
  - processSetAttribute
```
protected void processSetAttribute(int attribute)
                            throws java.io.IOException
```
    process SGR other than 0 (reset), 30-39 (foreground), 40-49 (background), 90-97 (foreground high intensity) or 100-107 (background high intensity)
    
    Parameters:
    
    attribute - attribute
    
    Throws:
    
    java.io.IOException - IOException
    
    See Also:
    
    processAttributeRest(), processSetForegroundColor(int), processSetForegroundColor(int, boolean), processSetForegroundColorExt(int), processSetForegroundColorExt(int, int, int), processDefaultTextColor(), processDefaultBackgroundColor()
  - processSetForegroundColor
```
protected void processSetForegroundColor(int color)
                                  throws java.io.IOException
```
    process SGR 30-37 corresponding to Set text color (foreground).
    
    Parameters:
    
    color - the text color
    
    Throws:
    
    java.io.IOException - IOException
  - processSetForegroundColor
```
protected void processSetForegroundColor(int color,
                                         boolean bright)
                                  throws java.io.IOException
```
    process SGR 30-37 or SGR 90-97 corresponding to Set text color (foreground) either in normal mode or high intensity.
    
    Parameters:
    
    color - the text color
    
    bright - is high intensity?
    
    Throws:
    
    java.io.IOException - IOException
  - processSetForegroundColorExt
```
protected void processSetForegroundColorExt(int paletteIndex)
                                     throws java.io.IOException
```
    process SGR 38 corresponding to extended set text color (foreground) with a palette of 255 colors.
    
    Parameters:
    
    paletteIndex - the text color in the palette
    
    Throws:
    
    java.io.IOException - IOException
  - processSetForegroundColorExt
```
protected void processSetForegroundColorExt(int r,
                                            int g,
                                            int b)
                                     throws java.io.IOException
```
    process SGR 38 corresponding to extended set text color (foreground) with a 24 bits RGB definition of the color.
    
    Parameters:
    
    r - red
    
    g - green
    
    b - blue
    
    Throws:
    
    java.io.IOException - IOException
  - processSetBackgroundColor
```
protected void processSetBackgroundColor(int color)
                                  throws java.io.IOException
```
    process SGR 40-47 corresponding to Set background color.
    
    Parameters:
    
    color - the background color
    
    Throws:
    
    java.io.IOException - IOException
  - processSetBackgroundColor
```
protected void processSetBackgroundColor(int color,
                                         boolean bright)
                                  throws java.io.IOException
```
    process SGR 40-47 or SGR 100-107 corresponding to Set background color either in normal mode or high intensity.
    
    Parameters:
    
    color - the background color
    
    bright - is high intensity?
    
    Throws:
    
    java.io.IOException - IOException
  - processSetBackgroundColorExt
```
protected void processSetBackgroundColorExt(int paletteIndex)
                                     throws java.io.IOException
```
    process SGR 48 corresponding to extended set background color with a palette of 255 colors.
    
    Parameters:
    
    paletteIndex - the background color in the palette
    
    Throws:
    
    java.io.IOException - IOException
  - processSetBackgroundColorExt
```
protected void processSetBackgroundColorExt(int r,
                                            int g,
                                            int b)
                                     throws java.io.IOException
```
    process SGR 48 corresponding to extended set background color with a 24 bits RGB definition of the color.
    
    Parameters:
    
    r - red
    
    g - green
    
    b - blue
    
    Throws:
    
    java.io.IOException - IOException
  - processDefaultTextColor
```
protected void processDefaultTextColor()
                                throws java.io.IOException
```
    process SGR 39 corresponding to Default text color (foreground)
    
    Throws:
    
    java.io.IOException - IOException
  - processDefaultBackgroundColor
```
protected void processDefaultBackgroundColor()
                                      throws java.io.IOException
```
    process SGR 49 corresponding to Default background color
    
    Throws:
    
    java.io.IOException - IOException
  - processAttributeRest
```
protected void processAttributeRest()
                             throws java.io.IOException
```
    process SGR 0 corresponding to Reset / Normal
    
    Throws:
    
    java.io.IOException - IOException
  - processCursorTo
```
protected void processCursorTo(int row,
                               int col)
                        throws java.io.IOException
```
    process CSI n ; m H corresponding to CUP – Cursor Position or CSI n ; m f corresponding to HVP – Horizontal and Vertical Position
    
    Parameters:
    
    row - row
    
    col - column
    
    Throws:
    
    java.io.IOException - IOException
  - processCursorToColumn
```
protected void processCursorToColumn(int x)
                              throws java.io.IOException
```
    process CSI n G corresponding to CHA – Cursor Horizontal Absolute
    
    Parameters:
    
    x - the column
    
    Throws:
    
    java.io.IOException - IOException
  - processCursorUpLine
```
protected void processCursorUpLine(int count)
                            throws java.io.IOException
```
    process CSI n F corresponding to CPL – Cursor Previous Line
    
    Parameters:
    
    count - line count
    
    Throws:
    
    java.io.IOException - IOException
  - processCursorDownLine
```
protected void processCursorDownLine(int count)
                              throws java.io.IOException
```
    process CSI n E corresponding to CNL – Cursor Next Line
    
    Parameters:
    
    count - line count
    
    Throws:
    
    java.io.IOException - IOException
  - processCursorLeft
```
protected void processCursorLeft(int count)
                          throws java.io.IOException
```
    process CSI n D corresponding to CUB – Cursor Back
    
    Parameters:
    
    count - numer of characters to move left
    
    Throws:
    
    java.io.IOException - IOException
  - processCursorRight
```
protected void processCursorRight(int count)
                           throws java.io.IOException
```
    process CSI n C corresponding to CUF – Cursor Forward
    
    Parameters:
    
    count - number of characters to move on
    
    Throws:
    
    java.io.IOException - IOException
  - processCursorDown
```
protected void processCursorDown(int count)
                          throws java.io.IOException
```
    process CSI n B corresponding to CUD – Cursor Down
    
    Parameters:
    
    count - numer of line
    
    Throws:
    
    java.io.IOException - IOException
  - processCursorUp
```
protected void processCursorUp(int count)
                        throws java.io.IOException
```
    process CSI n A corresponding to CUU – Cursor Up
    
    Parameters:
    
    count - number of lines
    
    Throws:
    
    java.io.IOException - IOException
  - processUnknownExtension
```
protected void processUnknownExtension(java.util.ArrayList<java.lang.Object> options,
                                       int command)
```
  - processChangeIconNameAndWindowTitle
```
protected void processChangeIconNameAndWindowTitle(java.lang.String label)
```
    process OSC 0;text BEL corresponding to Change Window and Icon label
    
    Parameters:
    
    label - window label
  - processChangeIconName
```
protected void processChangeIconName(java.lang.String label)
```
    process OSC 1;text BEL corresponding to Change Icon label
    
    Parameters:
    
    label - icon label name
  - processChangeWindowTitle
```
protected void processChangeWindowTitle(java.lang.String label)
```
    process OSC 2;text BEL corresponding to Change Window title
    
    Parameters:
    
    label - window label
  - processUnknownOperatingSystemCommand
```
protected void processUnknownOperatingSystemCommand(int command,
                                                    java.lang.String param)
```
    Process unknown OSC command.
    
    Parameters:
    
    command - command
    
    param - command param
  - processCharsetSelect
```
protected void processCharsetSelect(int set,
                                    char seq)
```
  - close
```
public void close()
           throws java.io.IOException
```
    Specified by:
    
    close in interface java.lang.AutoCloseable
    
    Specified by:
    
    close in interface java.io.Closeable
    
    Overrides:
    
    close in class java.io.FilterOutputStream
    
    Throws:
    
    java.io.IOException

Class AnsiOutputStream

Field Summary

Fields inherited from class java.io.FilterOutputStream

Constructor Summary

Method Summary

Methods inherited from class java.io.FilterOutputStream

Methods inherited from class java.lang.Object

Field Detail

RESET_CODE

REST_CODE

ERASE_SCREEN_TO_END

ERASE_SCREEN_TO_BEGINING

ERASE_SCREEN

ERASE_LINE_TO_END

ERASE_LINE_TO_BEGINING

ERASE_LINE

ATTRIBUTE_INTENSITY_BOLD

ATTRIBUTE_INTENSITY_FAINT

ATTRIBUTE_ITALIC

ATTRIBUTE_UNDERLINE

ATTRIBUTE_BLINK_SLOW

ATTRIBUTE_BLINK_FAST

ATTRIBUTE_NEGATIVE_ON

ATTRIBUTE_CONCEAL_ON

ATTRIBUTE_UNDERLINE_DOUBLE

ATTRIBUTE_INTENSITY_NORMAL

ATTRIBUTE_UNDERLINE_OFF

ATTRIBUTE_BLINK_OFF

ATTRIBUTE_NEGATIVE_Off

ATTRIBUTE_NEGATIVE_OFF

ATTRIBUTE_CONCEAL_OFF

BLACK

RED

GREEN

YELLOW

BLUE

MAGENTA

CYAN

WHITE

Constructor Detail

AnsiOutputStream

Method Detail

write

processRestoreCursorPosition

processSaveCursorPosition

processInsertLine

processDeleteLine

processScrollDown

processScrollUp

processEraseScreen

processEraseLine

processSetAttribute

processSetForegroundColor

processSetForegroundColor

processSetForegroundColorExt

processSetForegroundColorExt

processSetBackgroundColor

processSetBackgroundColor

processSetBackgroundColorExt

processSetBackgroundColorExt

processDefaultTextColor

processDefaultBackgroundColor

processAttributeRest

processCursorTo

processCursorToColumn

processCursorUpLine

processCursorDownLine

processCursorLeft

processCursorRight

processCursorDown

processCursorUp

processUnknownExtension

processChangeIconNameAndWindowTitle

processChangeIconName

processChangeWindowTitle

processUnknownOperatingSystemCommand

processCharsetSelect

close