CTerm

CTerm is the ANSI parsing code maintained as part of ciolib (and used by SyncTERM). This page is basically a pretty version of the cterm.txt file in git, as of 72305c4cfe7afe31064422694beac53a9fe8e5f3

The text file is still the normative reference, but this may serve as a friendlier source.

The cursor is moved to the first character of the next line as soon as a character is written to the last column of the current line, not on the next character. A tab will wrap to the next line only if the current cursor position is the last character on the line. This behavior is often surprising to people who are used to VT emulators which implement the LCF as documented in STD-070, who expect the cursor to “stick” in the last column until the next character is received.

There are two settable flags that will impact the default behaviour.

CSI ? 7 l will disable wrapping at the end of line completely, and any characters written to the last column will not move the cursor at all, overwriting the existing charater. Default behaviour can be restored with CSI ? 7 h.

If the CSI = 4 h sequence is received, CTerm will enable LCF mode as documented in STD-070, and CSI = 4 l will restore default behaviour. CSI = 5 h will set LCF mode and disable CSI = 4 l, as well as cause LCF to remain enabled across an ESC c (RIS).

Specifically, the LCF will be set when displaying a printable character advances the cursor to the right margin, and cleared by any of the following being received: CSI ? 6 h, CSI ? 6 l, CSI ? 7 l, CSI @, CSI A, CSI B, CSI a, CSI j, CSI H, CSI f, CSI I, CSI Y, CSI J, CSI K, CSI P, CSI X, CSI r, ESC E, ESC M, CR, LF, BS, TAB, Any normal printable character when the cursor is at the right margin (of the screen or scrollable area).

Control codes are in the following format: ESC {'0' (ZERO) to '~'} Legal combinations which are not handled are silently dropped.

CTerm:Font:p1:<b64>

Indicates the string is a loadable font. (CTerm 1.213)

p1 is a font slot number, which must be higher than the last default defined font (See CSI sp D for list of predefined fonts). <b64> is the base64 encoded font data. Font size is deduced from the size of the data. This replaces the now deprecated CSI = Ps1 ; Ps2 {

[ p1 [ ; p2 ] ] q

Defaults: p1 = 0 p2 = 0

Indicates the string is a sixel sequence.

p1 selects the vertical height of a single pixel. This may be overridden by the raster attributes command, and is deprecated.

Supported values

p2 indicates if unset sixels should be set to the current background colour. If p2 is 1, positions specified as 0 remain at their current colour.

Any additional parameters are ignored.

The rest of the string is made up of sixel data characters and sixel control functions. Sixel data characters are in the rage of '?' (0x3f) to '~' (0x7e). Each sixel data character represents six vertical pixels. The data is extracted by subtracting 0x3f from the ASCII value of the character. The least significant bit is the topmost pixel.

$ q pt

pt is the intermediate and/or final characters of a control function to query the status of. The terminal will send a response in the format DCS p1 $ r pt ST

p1 is 1 if the terminal supports querying the control function and 0 if it does not.

pt is the characters in the control function except the CSI characters.

Currently supported values of p1:

p1 [ ; p2 [ ; p3 ] ! z

Defaults: p2 = 0 p3 = 0

Sets a macro to be replayed using CSI Pn * z

p1 is the macro number to set, and make be between 0 and 63 inclusive.

If p2 is zero, the macro numbered p1 will be deleted. If p2 is one, all macros are deleted.

If p3 is zero, the macro is defined using ASCII characters (0x20 - 0x7e and 0xa0 - 0xff only) if p3 is one, the macro is defined using hex pairs.

When the macro is defined using hex pairs, a repeat sequence may be included in the format of ! Pn ; D..D ;. Pn specifies the number of repeats (default of one instance) D..D is the sequence of pairs to send Pn times. The terminating ; may be left out if the sequence to be repeated ends at the end of the string.

4;(pX;pY)...

Specifies one or more palette redefinitions. pX is the palette index, and pY is the colour definition Color format: rgb:R/G/B Where R, G, and B are a sequence of one to four hex digits representing the value of the red, green, and blue channels respectively. xterm

SyncTERM implements the following APS commands:

APS SyncTERM:C;S Ps1 Ps2 ST Where Ps1 is a filename and Ps2 is the base64 encoded contents of the file. The named file is stored in the cache directory for the current connection.

APS SyncTERM:C;L Ps ST List files in cache. SyncTERM responds with an APS string with lines separated by newlines. The first line is always “SyncTERM:C;L\n” and for each matching file, a line in the form <Filename> TAB <MD5 sum> LF is sent (ie: “coolfont.fnt\t595f44fec1e92a71d3e9e77456ba80d1\n”)

And additional argument can be specified as a glob(3) pattern (defaults to “*”) in APS SyncTERM:C;L;Ps ST.

APS SyncTERM:C;SetFont Pn Ps Where Pn is a font slot number (max 255) and Ps is a filename in the cache. This sets font slot Pn to use the specified font file.

APS SyncTERM:C;DrawPPM Ps... Ps2 Draws a PPM from the cache directory on the screen. Ps2 is the filename and is required. Arguments for Ps are optional. The following options can be included (separated by semi-colons):

The PPM file may be raw (preferred) or text. SyncTERM does not support more than 255 values per colour channel and assumes it is correctly using the BT.709 gamma transfer.

APS SyncTERM:C;LoadPPM Ps... Ps0 Loads a PPM to a buffer. Ps0 is the filename

• ANSI References