Escape-код ANSI

«Код ANSI» перенаправляется сюда. Чтобы узнать о других значениях, см. ANSI (значения) .

ANSI X3.64 (ИСО/МЭК 6429)

Вывод system-monitor htop , приложения ncurses (которое использует SGR и другие управляющие последовательности ANSI/ISO).
Стандартный	ЭКМА -48 ИСО/МЭК 6429 ФИПС 86 АНСИ Х3.64 ДЖИС Х 0211
Классификация	ISO/IEC 2022. на основе Код управления и набор последовательностей управления
Other related encoding(s)	ITU T.61 ISO/IEC 8613-6 / ITU T.416 Other control function standards: ITU T.101 JIS X 0207 ISO 6630 DIN 31626 ETS 300 706

Escape-последовательности ANSI являются стандартом внутриполосной передачи сигналов для управления местоположением курсора, цветом, стилем шрифта и другими параметрами на текстовых видеотерминалах и эмуляторах терминалов . Определенные последовательности байтов , большинство из которых начинаются с escape -символа ASCII и скобки , встроены в текст. Терминал интерпретирует эти последовательности как команды, а не текст для дословного отображения.

Последовательности ANSI были введены в 1970-х годах для замены последовательностей, специфичных для конкретного поставщика, и к началу 1980-х годов получили широкое распространение на рынке компьютерного оборудования. Они используются в разработке, научных, коммерческих текстовых приложениях, а также в системах досок объявлений для обеспечения стандартизированной функциональности.

Хотя аппаратные текстовые терминалы в 21 веке становятся все более редкими, актуальность стандарта ANSI сохраняется, поскольку подавляющее большинство эмуляторов терминала и командных консолей интерпретируют по крайней мере часть стандарта ANSI.

History

Almost all manufacturers of video terminals added vendor-specific escape sequences to perform operations such as placing the cursor at arbitrary positions on the screen. One example is the VT52 terminal, which allowed the cursor to be placed at an x,y location on the screen by sending the ESC character, a Y character, and then two characters representing numerical values equal to the x,y location plus 32 (thus starting at the ASCII space character and avoiding the control characters). The Hazeltine 1500 had a similar feature, invoked using ~, DC1 and then the X and Y positions separated with a comma. While the two terminals had identical functionality in this regard, different control sequences had to be used to invoke them.

As these sequences were different for different terminals, elaborate libraries such as termcap ("terminal capabilities") and utilities such as tput had to be created so programs could use the same API to work with any terminal. In addition, many of these terminals required sending numbers (such as row and column) as the binary values of the characters; for some programming languages, and for systems that did not use ASCII internally, it was often difficult to turn a number into the correct character.

The ANSI standard attempted to address these problems by making a command set that all terminals would use and requiring all numeric information to be transmitted as ASCII numbers. The first standard in the series was ECMA-48, adopted in 1976. It was a continuation of a series of character coding standards, the first one being ECMA-6 from 1965, a 7-bit standard from which ISO 646 originates. The name "ANSI escape sequence" dates from 1979 when ANSI adopted ANSI X3.64. The ANSI X3L2 committee collaborated with the ECMA committee TC 1 to produce nearly identical standards. These two standards were merged into an international standard, ISO 6429. In 1994, ANSI withdrew its standard in favor of the international standard.

The DEC VT100 video display terminal.

The first popular video terminal to support these sequences was the Digital VT100, introduced in 1978. This model was very successful in the market, which sparked a variety of VT100 clones, among the earliest and most popular of which was the much more affordable Zenith Z-19 in 1979. Others included the Qume QVT-108, Televideo TVI-970, Wyse WY-99GT as well as optional "VT100" or "VT103" or "ANSI" modes with varying degrees of compatibility on many other brands. The popularity of these gradually led to more and more software (especially bulletin board systems and other online services) assuming the escape sequences worked, leading to almost all new terminals and emulator programs supporting them.

In 1981, ANSI X3.64 was adopted for use in the US government by FIPS publication 86. Later, the US government stopped duplicating industry standards, so FIPS pub. 86 was withdrawn.

ECMA-48 has been updated several times and is currently at its 5th edition, from 1991. It is also adopted by ISO and IEC as standard ISO/IEC 6429. A version is adopted as a Japanese Industrial Standard, as JIS X 0211.

Related standards include ITU T.61, the Teletex standard, and the ISO/IEC 8613, the Open Document Architecture standard (mainly ISO/IEC 8613-6 or ITU T.416). The two systems share many escape codes with the ANSI system, with extensions that are not necessarily meaningful to computer terminals. Both systems quickly fell into disuse, but ECMA-48 does mark the extensions used in them as reserved.

Platform support

The Xterm terminal emulator.

In the early 1980s, large amounts of software directly used these sequences to update screen displays. This included everything on VMS (which assumed Dec terminals), most software designed to be portable on CP/M home computers, and even lots of Unix software as it was easier to use than the termcap libraries, such as the shell script examples below in this article.

Terminal emulators for communicating with remote machines almost always implement ANSI escape codes. This includes anything written to communicate with bulletin-board systems on home and personal computers. On Unix terminal emulators such as xterm also can communicate with software running on the same machine, and thus software running in X11 under a terminal emulator could assume the ability to write these sequences.

As computers got more powerful even built-in displays started supporting them, allowing software to be portable between CP/M systems. There were attempts to extend the escape sequences to support printers and as an early PDF-like document storage format, the Open Document Architecture.

DOS and Windows

The IBM PC, introduced in 1983, did not support these or any other escape sequences for updating the screen. Only a few control characters (BEL, CR, LF, BS) were interpreted by the underlying BIOS. Any display effects had to be done with BIOS calls, which were notoriously slow, or by directly manipulating the IBM PC hardware. This made any interesting software non-portable and led to the need to duplicate details of the display hardware in PC Clones.

DOS version 2.0 included optional support with a device driver named ANSI.SYS. Poor performance, and the fact that it was not installed by default, meant software rarely took advantage of it. Some other systems did try to address the need for these sequences, many clones of DOS handled them without a driver, and OS/2 had an ANSI command that enabled the sequences.

The Windows Console did not support ANSI escape sequences, nor did Microsoft provide any method to enable them. Some replacements or additions for the console window such as JP Software's TCC (formerly 4NT), Michael J. Mefford's ANSI.COM, Jason Hood's ANSICON and Maximus5's ConEmu interpreted ANSI escape sequences printed by programs. A Python package named colorama internally interprets ANSI escape sequences in text being printed, translating them to win32 calls to modify the state of the terminal, to make it easier to port Python code using ANSI to Windows. Cygwin performs similar translation to all output written to the console using Cygwin file descriptors, the filtering is done by the output functions of cygwin1.dll, to allow porting of POSIX C code to Windows.

In 2016, Microsoft released the Windows 10 version 1511 update which unexpectedly implemented support for ANSI escape sequences, over two decades after the debut of Windows NT. This was done alongside Windows Subsystem for Linux, apparently to allow Unix-like terminal-based software to use the Windows Console. Windows PowerShell 5.1 enabled this by default, and PowerShell 6 made it possible to embed the necessary ESC character into a string with `e.

Windows Terminal, introduced in 2019, supports the sequences by default, and Microsoft intends to replace the Windows Console with Windows Terminal.

Description

C0 control codes

Почти все пользователи берут на себя некоторые функции некоторых однобайтовых символов. Первоначально определенный как часть ASCII, набор управляющих кодов C0 по умолчанию теперь определен в ISO 6429 (ECMA-48), что делает его частью того же стандарта, что и набор C1, вызываемый escape-последовательностями ANSI (хотя ISO 2022 допускает использование ISO 6429). Набор C0 будет использоваться без набора C1 ISO 6429, и наоборот , при условии, что 0x1B всегда равно ESC). Это используется для сокращения объема передаваемых данных или для выполнения некоторых функций, недоступных из escape-последовательностей:

Популярные коды управления C0 (неполный список)

^	С0	Сокр.	Имя	Эффект
^Г	0x07	БЕЛ	Белл	Издает слышимый шум.
^ Ч	0x08	БС	Backspace	Перемещает курсор влево (но может «перевернуться назад», если курсор находится в начале строки).
^Я	0x09	ХТ	Вкладка	Перемещает курсор вправо к следующему числу, кратному 8.
^Дж	0x0A	НЧ	Перевод строки	Переход к следующей строке, прокрутка дисплея вверх, если он находится в нижней части экрана. Обычно не перемещается по горизонтали, хотя программам не следует на это полагаться.
^Л	0x0C	ФФ	Подача формы	Переместите принтер вверх следующей страницы. Обычно не перемещается по горизонтали, хотя программам не следует на это полагаться. Влияние на видеотерминалы варьируется.
^М	0x0D	ЧР	Возврат каретки	Перемещает курсор в нулевой столбец.
^[	0x1B	ЭКУ	Побег	Запускает все escape-последовательности

Escape-последовательности различаются по длине. Общий формат escape-последовательности, совместимой с ANSI, определяется ANSI X3.41 (эквивалент ECMA-35 или ISO/IEC 2022). Escape-последовательности состоят только из байтов в диапазоне 0x20—0x7F (все неуправляющие символы ASCII), их можно анализировать, не заглядывая вперед. Поведение, когда управляющий символ, байт с установленным старшим битом или байт, который не является частью какой-либо допустимой последовательности, встречается до того, как конец не определен.

Fe Escape-последовательности

Если ESC за которым следует байт в диапазоне от 0x40 до 0x5F, escape-последовательность имеет тип Fe. Его интерпретация делегирована применимому стандарту кода управления C1 . Соответственно, все escape-последовательности, соответствующие управляющим кодам C1 из ANSI X3.64/ECMA-48, следуют этому формату.

Стандарт гласит, что в 8-битных средах функции управления, соответствующие типу Fe escape-последовательности (из набора управляющих кодов C1 ) могут быть представлены в виде отдельных байтов в диапазоне 0x80–0x9F. Это возможно в кодировках символов, соответствующих положениям для 8-битного кода, созданным в ISO 2022, например серии ISO 8859 . Однако в кодировках символов, используемых на современных устройствах, таких как UTF-8 или CP-1252 , эти коды часто используются для других целей, поэтому обычно используется только 2-байтовая последовательность. В случае UTF-8 представление управляющего кода C1 через C1 Controls и блок Latin-1 Supplement приводит к другому двухбайтовому коду (например, 0xC2,0x8E для U+008E ), но таким образом пространство не экономится.

Какой-то тип Fe (элемент набора C1) Escape-последовательности ANSI (не исчерпывающий список)

Код	С1	Сокр.	Имя	Эффект
ЭКУ Н	0x8E	СС2	Одна смена, две	Выберите один символ из одного из альтернативных наборов символов . SS2 выбирает набор символов G2, а SS3 выбирает набор символов G3. В 7-битной среде за ним следует один или несколько байтов GL (0x20–0x7F), определяющих символ из этого набора. В 8-битной среде это могут быть байты GR (0xA0–0xFF).
ЭСК О	0x8F	СС3	Одна смена, три
ЭКУ П	0x90	DCS	Строка управления устройством	Прекращено ST. Использование этой последовательности в Xterm включает определение определяемых пользователем ключей, а также запрос или установку данных Termcap/Terminfo.
ЭСК [	0x9B	CSI	Интродуктор управляющей последовательности	Начинает большинство полезных последовательностей, заканчивающихся байтами в диапазоне от 0x40 до 0x7E.
ESC \	0x9C	СТ	Струнный терминатор	Завершает строки в других элементах управления.
ЭСК ]	0x9D	ОСК	Команда операционной системы	Запускает управляющую строку для использования операционной системой, завершающуюся ST.
ЭСК Х	0x98	SOS	Начало строки	Принимает в качестве аргумента текстовую строку, оканчивающуюся ST. Использование этих последовательностей управления строкой определяется приложением. или дисциплина конфиденциальности. Эти функции реализуются редко, а их аргументы игнорируются xterm. Некоторые клиенты Kermit позволяют серверу автоматически выполнять команды Kermit на клиенте, встраивая их в последовательности APC; это потенциальная угроза безопасности, если сервер не является доверенным.
ESC ^	0x9E	ПМ	Сообщение о конфиденциальности
ЭСК _	0x9F	БТР	Команда прикладной программы

Последовательности CSI (Control Sequence Introducer)

Для команд Control Sequence Introducer (CSI) ESC [ (написано как \e[ или \033[ в нескольких языках программирования) за ним следует любое количество (в том числе отсутствие) «байтов параметров» в диапазоне 0x30–0x3F (ASCII 0–9:;<=>?), затем на любое количество «промежуточных байтов» в диапазоне 0x20–0x2F (пробел ASCII и !"#$%&'()*+,-./), затем, наконец, одним «последним байтом» в диапазоне 0x40–0x7E (ASCII @A–Z[\]^_`a–z{|}~).

Все распространенные последовательности просто используют параметры в виде серии чисел, разделенных точкой с запятой, например: 1;2;3. Пропущенные числа рассматриваются как 0 ( 1;;3 действует так, как будто среднее число 0, и вообще никаких параметров в ESC[m действует как 0 код сброса). Некоторые последовательности (например, CUU) лечат 0 как 1 чтобы сделать недостающие параметры полезными.

Подмножество механизмов было объявлено «частным», чтобы производители терминалов могли вставлять свои собственные последовательности, не вступая в противоречие со стандартом. Последовательности, содержащие байты параметров <=>? или последние байты 0x70–0x7E ( p–z{|}~) являются частными.

Поведение терминала не определено в случае, когда последовательность CSI содержит любой символ за пределами диапазона 0x20–0x7E. Этими недопустимыми символами являются либо управляющие символы C0 (диапазон 0–0x1F), DEL (0x7F), либо байты с установленным старшим битом. Возможные ответы: игнорировать байт, немедленно его обработать и, кроме того, продолжать ли последовательность CSI, немедленно прерывать ее или игнорировать остальную часть.

Некоторые управляющие последовательности ANSI (не исчерпывающий список)

Код	Сокр.	Имя	Эффект
CSI н А	КУУ	Курсор вверх	Перемещает курсор n (по умолчанию 1) ячейки в заданном направлении. Если курсор уже находится на краю экрана, это не имеет никакого эффекта.
CSI н Б	CUD	Курсор вниз
CSI н C	CUF	Курсор вперед
CSI и D	КУБ	Курсор Назад
CSI н Э	CNL	Курсор Следующая строка	Перемещает курсор в начало строки n (по умолчанию) . 1) линии вниз. (не ANSI.SYS )
CSI CSInF F	CPL	Курсор Предыдущая строка	Перемещает курсор в начало строки n (по умолчанию) . 1) выстраиваются в очередь. (не ANSI.SYS )
CSI н Г	НЕТ	Курсор Горизонтальный Абсолют	Перемещает курсор в столбец n (по умолчанию) . 1). (не ANSI.SYS )
CSI n ; мГн	ЧАШКА	Позиция курсора	Перемещает курсор в строку n , столбец m . Значения отсчитываются от 1 и по умолчанию равны 1 (верхний левый угол), если опущено. Последовательность, такая как CSI ;5H является синонимом CSI 1;5H а также CSI 17;H то же самое, что CSI 17H и CSI 17;1H
CSI н Джей	ЭД	Стереть на дисплее	Очищает часть экрана. Если n ​ 0 (или отсутствует), очистите от курсора до конца экрана. Если n ​ 1, очистите от курсора до начала экрана. Если n ​ 2, очищает весь экран (и перемещает курсор в левый верхний угол DOS ANSI.SYS ). Если n ​ 3, очистить весь экран и удалить все строки, сохраненные в буфере прокрутки (эта функция была добавлена ​​для xterm и поддерживается другими терминальными приложениями).
CSI н К	ОН	Стереть в строке	Стирает часть линии. Если n ​ 0 (или отсутствует), очистить от курсора до конца строки. Если n ​ 1, очистите от курсора до начала строки. Если n ​ 2, очистить всю строку. Положение курсора не меняется.
CSI н С	Они есть	Прокрутить вверх	Прокрутить всю страницу вверх на n (по умолчанию) . 1) линии. Новые строки добавляются внизу. (не ANSI.SYS )
CSI н Т	СД	Прокрутите вниз	Прокрутить всю страницу вниз на n (по умолчанию) . 1) линии. Новые строки добавляются вверху. (не ANSI.SYS )
CSI n ; м ж	ХВП	Горизонтальное вертикальное положение	То же, что и CUP, но считается эффекторной функцией формата (например, CR или LF ), а не функцию редактора (например, CUD или CNL). Это может привести к различной обработке в определенных режимах терминала.
CSI CSI m	СГР	Выберите графическое представление	Устанавливает цвета и стиль символов, следующих за этим кодом.
CSI 5i		Порт AUX включен	Включите дополнительный последовательный порт, обычно для локального последовательного принтера.
CSI 4i		Порт AUX выключен	Отключите дополнительный последовательный порт, обычно для локального последовательного принтера.
CSI 6n	ДСР	Отчет о состоянии устройства	Сообщает положение курсора (CPR) путем передачи ESC[n;mR, где n — строка, а m — столбец.

Некоторые популярные частные эпизоды

Код	Сокр.	Имя	Эффект
CSI с	SCP, SCOSC	Сохранить текущую позицию курсора	Сохраняет положение/состояние курсора в режиме консоли SCO. В режиме вертикального разделения экрана вместо этого используется для установки (как CSI n ; n s) или сбросьте левое и правое поля.
CSI ты	РКП, СКОРК	Восстановить сохраненную позицию курсора	Восстанавливает положение/состояние курсора в режиме консоли SCO.
CSI? 25 ч.	ДЕКТСЕМ		Показывает курсор от VT220 .
CSI? 25 л	ДЕКТСЕМ		Скрывает курсор.
CSI? 1004 ч.			Включить фокус отчетности. Сообщает всякий раз, когда эмулятор терминала входит в фокус или выходит из него, как ESC [I и ESC [O, соответственно.
CSI? 1004 л			Отключить фокус отчетности.
CSI? 1049 ч.			Включить альтернативный экранный буфер из xterm
CSI? 1049 л			Отключить альтернативный экранный буфер из xterm
CSI? 2004 г.			Включите режим вставки в квадратных скобках. В режиме вставки в квадратных скобках текст, вставленный в терминал, будет окружен рамкой. ESC [200~ и ESC [201~; программы, работающие в терминале, не должны рассматривать символы, заключенные в эти последовательности, как команды ( Vim не рассматривает их как команды). например, Из xterm
CSI? 2004 л			Отключите режим вставки в скобках.

Параметры SGR (Выбор графического представления)

Последовательность управления CSI n m, с именем «Выбрать графическое представление» (SGR), устанавливает атрибуты отображения. В одной последовательности можно задать несколько атрибутов, разделенных точкой с запятой. Каждый атрибут отображения остается в силе до тех пор, пока следующее появление SGR не сбросит его. Если коды не указаны, CSI m рассматривается как CSI 0 m (сброс/нормальный).

н	Имя	Примечание
0	Сброс или нормальный	Все атрибуты отключаются
1	Яркий или повышенная интенсивность	Как и в случае с тусклым изображением, изменение цвета — изобретение ПК (SCO/ CGA ).
2	Слабость, снижение интенсивности или тусклость	Может быть реализован как легкий шрифт, например жирный.
3	Курсив	Не имеет широкой поддержки. Иногда рассматривается как инверсия или мерцание.
4	Подчеркнуть	Расширения стилей существуют для Kitty, VTE, mintty, iTerm2 и Konsole.
5	Медленное мигание	Устанавливает мигание менее 150 раз в минуту.
6	Быстрое моргание	MS-DOS ANSI.SYS, 150+ в минуту; не широко поддерживается
7	Перевернуть видео или инвертировать	Поменять местами цвета переднего плана и фона; противоречивая эмуляция
8	Скрыть или скрыть	Не имеет широкой поддержки.
9	Перечеркнуто , или забастовка	Символы разборчивы, но помечены как будто подлежащие удалению. Не поддерживается в Terminal.app.
10	Основной шрифт (по умолчанию)
11–19	Альтернативный шрифт	Выберите альтернативный шрифт n − 10.
20	Перелом (готика)	Редко поддерживается
21	Дважды подчеркнуто; или: не жирный	Двойное подчеркивание согласно ECMA-48, но вместо этого отключает интенсивность жирного шрифта на нескольких терминалах, в том числе в Linux ядра консоли до версии 4.17.
22	Нормальная интенсивность	Ни смелый, ни слабый; цвет меняется там, где интенсивность реализована как таковая.
23	Ни курсив, ни черный шрифт
24	Не подчеркнуто	Ни одинарно, ни дважды подчеркнуто
25	Не мигает	Выключить мигание
26	Пропорциональное расстояние	ITU T.61 и T.416, которые, как известно, не используются на терминалах.
27	Не отменено
28	Раскрывать	Не скрыто
29	Не зачеркнуто
30–37	Установить цвет переднего плана
38	Установить цвет переднего плана	Следующие аргументы 5;n или 2;r;g;b
39	Цвет переднего плана по умолчанию	Определенная реализация (согласно стандарту)
40–47	Установить цвет фона
48	Установить цвет фона	Следующие аргументы 5;n или 2;r;g;b
49	Цвет фона по умолчанию	Определенная реализация (согласно стандарту)
50	Отключить пропорциональный интервал	Т.61 и Т.416
51	В рамке	Реализован как « селектор вариантов смайлов » в mintty.
52	окружен
53	Перечеркнутый	Не поддерживается в Terminal.app
54	Ни в рамке, ни в окружении
55	Не подчеркнуто
58	Установить цвет подчеркивания	Не в стандарте; реализовано в Kitty, VTE, mintty и iTerm2. Следующие аргументы 5;n или 2;r;g;b.
59	Цвет подчеркивания по умолчанию	Не в стандарте; реализовано в Kitty, VTE, mintty и iTerm2.
60	Подчеркивание идеограммы или правая боковая линия	Редко поддерживается
61	Двойное подчеркивание идеограммы или двойная линия справа.
62	Надчеркивание идеограммы или левая боковая линия
63	Двойное надчеркивание идеограммы или двойная линия слева.
64	Идеограмма маркировки стресса
65	Нет атрибутов идеограммы	Сбросить эффекты всех 60– 64
73	Надстрочный индекс	Реализовано только в mintty
74	Индекс
75	Ни надстрочный, ни подстрочный индекс
90–97	Установить яркий цвет переднего плана	Не в стандарте; первоначально реализовано aixterm
100–107	Установить яркий цвет фона

Цвета

3-битные и 4-битные

В исходной спецификации было всего 8 цветов, и им были даны только названия. Параметры SGR 30–37 выбирали цвет переднего плана, а 40–47 — фона. Многие терминалы реализовали «жирный» шрифт (код SGR 1) как более яркий цвет, а не другой шрифт, тем самым обеспечивая 8 дополнительных цветов переднего плана. Обычно вы не можете получить их в качестве цветов фона, хотя иногда инверсное видео (код SGR 7) позволяет это. Примеры: чтобы получить черные буквы на белом фоне, используйте ESC[30;47m, чтобы получить красный цвет, используйте ESC[31m, чтобы получить ярко-красный цвет, используйте ESC[1;31m. Чтобы сбросить цвета к значениям по умолчанию, используйте ESC[39;49m (не поддерживается на некоторых терминалах) или сбросьте все атрибуты с помощью ESC[0m. В более поздних терминалах добавлена ​​возможность напрямую указывать «яркие» цвета: 90–97 и 100–107.

В таблице ниже показано несколько примеров того, как стандарт VGA и современные эмуляторы терминала преобразуют 4-битные цветовые коды в 24-битные цветовые коды.

ФГ	БГ	Имя	VGA	Windows ХР Консоль	Окна PowerShell& 1.0–6.0	Код Visual Studio	Windows 10 Консоль	Terminal.app	Шпатлевка	мИРЦ	xterm	Убунту	Терминал Затмения
30	40	Черный	0, 0, 0				12, 12, 12	0, 0, 0				1, 1, 1	0, 0, 0
31	41	Красный	170, 0, 0	128, 0, 0		205, 49, 49	197, 15, 31	153, 0, 0	187, 0, 0	127, 0, 0	205, 0, 0	222, 56, 43	205, 0, 0
32	42	Зеленый	0, 170, 0	0, 128, 0		13, 188, 121	19, 161, 14	0, 166, 0	0, 187, 0	0, 147, 0	0, 205, 0	57, 181, 74	0, 205, 0
33	43	Желтый	170, 85, 0	128, 128, 0	238, 237, 240	229, 229, 16	193, 156, 0	153, 153, 0	187, 187, 0	252, 127, 0	205, 205, 0	255, 199, 6	205, 205, 0
34	44	Синий	0, 0, 170	0, 0, 128		36, 114, 200	0, 55, 218	0, 0, 178	0, 0, 187	0, 0, 127	0, 0, 238	0, 111, 184	0, 0, 238
35	45	Пурпурный	170, 0, 170	128, 0, 128	1, 36, 86	188, 63, 188	136, 23, 152	178, 0, 178	187, 0, 187	156, 0, 156	205, 0, 205	118, 38, 113	205, 0, 205
36	46	Голубой	0, 170, 170	0, 128, 128		17, 168, 205	58, 150, 221	0, 166, 178	0, 187, 187	0, 147, 147	0, 205, 205	44, 181, 233	0, 205, 205
37	47	Белый	170, 170, 170	192, 192, 192		229, 229, 229	204, 204, 204	191, 191, 191	187, 187, 187	210, 210, 210	229, 229, 229	204, 204, 204	229, 229, 229
90	100	Ярко-черный (серый)	85, 85, 85	128, 128, 128		102, 102, 102	118, 118, 118	102, 102, 102	85, 85, 85	127, 127, 127	127, 127, 127	128, 128, 128	0, 0, 0
91	101	Ярко-красный	255, 85, 85	255, 0, 0		241, 76, 76	231, 72, 86	230, 0, 0	255, 85, 85	255, 0, 0
92	102	Ярко-зеленый	85, 255, 85	0, 255, 0		35, 209, 139	22, 198, 12	0, 217, 0	85, 255, 85	0, 252, 0	0, 255, 0
93	103	Ярко-желтый	255, 255, 85	255, 255, 0		245, 245, 67	249, 241, 165	230, 230, 0	255, 255, 85	255, 255, 0
94	104	Ярко-синий	85, 85, 255	0, 0, 255		59, 142, 234	59, 120, 255	0, 0, 255	85, 85, 255	0, 0, 252	92, 92, 255	0, 0, 255	92, 92, 255
95	105	Ярко-пурпурный	255, 85, 255	255, 0, 255		214, 112, 214	180, 0, 158	230, 0, 230	255, 85, 255	255, 0, 255
96	106	Ярко-голубой	85, 255, 255	0, 255, 255		41, 184, 219	97, 214, 214	0, 230, 230	85, 255, 255	0, 255, 255
97	107	Ярко-белый	255, 255, 255			229, 229, 229	242, 242, 242	230, 230, 230	255, 255, 255

8-битный

Поскольку таблицы поиска с 256 цветами стали обычным явлением на графических картах, были добавлены escape-последовательности для выбора из заранее определенного набора из 256 цветов:

ESC[38;5;⟨n⟩m Select foreground color      where n is a number from the table below
ESC[48;5;⟨n⟩m Select background color
  0-  7:  standard colors (as in ESC [ 30–37 m)
  8- 15:  high intensity colors (as in ESC [ 90–97 m)
 16-231:  6 × 6 × 6 cube (216 colors): 16 + 36 × r + 6 × g + b (0 ≤ r, g, b ≤ 5)
232-255:  grayscale from dark to light in 24 steps

Информационная технология ITU T.416 – Архитектура открытого документа (ODA) и формат обмена: Архитектура символьного контента Вместо этого в качестве символов-разделителей используется «:»:

ESC[38:5:⟨n⟩m Select foreground color      where n is a number from the table below
ESC[48:5:⟨n⟩m Select background color

скрывать 256-цветный режим — передний план: ESC[38;5;#m фон: ESC[48;5;#m]
Стандартные цвета																		Цвета высокой интенсивности
0   1   2   3   4   5   6   7   8   9  10 11 12 13 14 15
216 цветов
16	17	18	19	20	21	22	23	24	25	26	27	28	29	30	31	32	33	34	35	36	37	38	39	40	41	42	43	44	45	46	47	48	49	50	51
52	53	54	55	56	57	58	59	60	61	62	63	64	65	66	67	68	69	70	71	72	73	74	75	76	77	78	79	80	81	82	83	84	85	86	87
88	89	90	91	92	93	94	95	96	97	98	99	100	101	102	103	104	105	106	107	108	109	110	111	112	113	114	115	116	117	118	119	120	121	122	123
124	125	126	127	128	129	130	131	132	133	134	135	136	137	138	139	140	141	142	143	144	145	146	147	148	149	150	151	152	153	154	155	156	157	158	159
160	161	162	163	164	165	166	167	168	169	170	171	172	173	174	175	176	177	178	179	180	181	182	183	184	185	186	187	188	189	190	191	192	193	194	195
196	197	198	199	200	201	202	203	204	205	206	207	208	209	210	211	212	213	214	215	216	217	218	219	220	221	222	223	224	225	226	227	228	229	230	231
Цвета оттенков серого
232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255

Также существовало похожее, но несовместимое 88-цветное кодирование с использованием той же escape-последовательности, как показано в rxvt и xterm-88color. О схеме мало что известно, кроме цветовых кодов. Он использует цветной куб 4×4×4.

24-битный

Когда графические карты «настоящего цвета» с глубиной цвета от 16 до 24 бит стали широко распространены, приложения начали поддерживать 24-битные цвета. Эмуляторы терминала, поддерживающие установку 24-битных цветов переднего плана и фона с помощью escape-последовательностей, включают Xterm, KDE Консоль , и iTerm, а также все терминалы на базе libvte, включая терминал GNOME .

ESC[38;2;⟨r⟩;⟨g⟩;⟨b⟩ m Select RGB foreground color
ESC[48;2;⟨r⟩;⟨g⟩;⟨b⟩ m Select RGB background color

Синтаксис, вероятно, основан на (ODA) ITU T.416 архитектуре открытых документов и формате обмена: архитектуры символьного контента, который был принят как ISO/IEC 8613-6, но потерпел неудачу с коммерческой точки зрения. Версия ODA более сложна и, следовательно, несовместима:

• Параметры после «2» (r, g и b) являются необязательными и их можно оставить пустыми.
• Точки с запятой заменяются двоеточиями, как указано выше.
• Существует ведущий «идентификатор цветового пространства». Определение идентификатора цветового пространства не включено в этот документ, поэтому он может быть пустым, чтобы представлять неуказанное значение по умолчанию.
• В дополнение к значению «2» после 48 для указания формата «красный-зеленый-синий» (и «5» выше для индексированного цвета от 0 до 255) существуют альтернативы «0» для определяемых реализацией и «1». для прозрачных — ни один из них не имеет дополнительных параметров; «3» определяет цвета с использованием схемы «Голубой-пурпурный-желтый», а «4» — для схемы «Голубой-пурпурный-желтый-черный», причем последний использует позицию, помеченную как «неиспользуемая» для черного компонента:

ESC[38:2:⟨Color-Space-ID⟩:⟨r⟩:⟨g⟩:⟨b⟩:⟨unused⟩:⟨CS tolerance⟩:⟨Color-Space associated with tolerance: 0 for "CIELUV"; 1 for "CIELAB"⟩ m Select RGB foreground color
ESC[48:2:⟨Color-Space-ID⟩:⟨r⟩:⟨g⟩:⟨b⟩:⟨unused⟩:⟨CS tolerance⟩:⟨Color-Space associated with tolerance: 0 for "CIELUV"; 1 for "CIELAB"⟩ m Select RGB background color

Вариант ITU-RGB поддерживается xterm, при этом идентификатор цветового пространства и параметры допуска игнорируются. Более простая схема с использованием точек с запятой изначально встречается в Konsole.

относящиеся к поддержке

Вместо использования поддержки цвета в termcap и terminfo, представленной в SVr3.2 (1987), библиотека S-Lang ( версия 0.99-32 , июнь 1996 г.) использовала отдельную переменную среды $COLORTERM чтобы указать, может ли эмулятор терминала вообще использовать цвета, а позже добавил значения, указывающие, поддерживает ли он 24-битный цвет. Эта система, хотя и плохо документированная, стала достаточно распространенной, чтобы Fedora и RHEL рассмотрели возможность ее использования как более простого и универсального механизма обнаружения по сравнению с запросами к обновленным библиотекам.

Некоторые эмуляторы терминала (urxvt, консоль) установлены $COLORFGBG сообщить о цветовой схеме терминала (в основном светлый или темный фон). Такое поведение возникло в S-Lang и используется vim. Gnome-terminal отказывается добавлять это поведение, поскольку синтаксис значения не согласован, значение не может быть изменено при изменении палитры во время выполнения, и уже существуют более «правильные» последовательности xterm OSC 4/10/11.

Последовательности OSC (команды операционной системы)

Большинство последовательностей команд операционной системы были определены Xterm, но многие из них также поддерживаются другими эмуляторами терминала. По историческим причинам Xterm может завершить команду командой BEL (0x07), а также стандартный ST (0x9C или 0x1B 0x5C). Например, Xterm позволяет устанавливать заголовок окна с помощью ESC ]0;this is the window title BEL.

Расширение, отличное от xterm, — это гиперссылка, ESC ]8;;link ST с 2017 года, используется ВТЕ, iTerm2, и мятный, среди других.

Консоль Linux использует ESC ] P n rr gg bb для изменения палитры, которая, если она жестко запрограммирована в приложении, может зависать от других терминалов. Однако, добавив ST будут игнорироваться Linux и образуют правильную, игнорируемую последовательность для других терминалов.

Fs Escape-последовательности

Если ESC за которым следует байт в диапазоне 0x60—0x7E , escape-последовательность имеет тип Fs. Этот тип используется для функций управления, индивидуально зарегистрированных в реестре ISO-IR . Их таблица приведена в ISO/IEC 2022 .

Fp Escape-последовательности

Если ESC за которым следует байт в диапазоне 0x30—0x3F , escape-последовательность имеет тип Fp, который предназначен для шестнадцати функций управления частного использования.

Какой-то тип Escape-последовательности Fp (частного использования), распознаваемые VT100

	Сокр.	Имя	Эффект
ЭСК 7	ДЕКСК	DEC Сохранить курсор	Сохраняет положение курсора, состояние сдвига кодирования и атрибуты форматирования.
ЭСК 8	ОКРК	Курсор восстановления DEC	Восстанавливает позицию курсора, состояние сдвига кодирования и атрибуты форматирования из предыдущего DECSC, если таковые имеются, в противном случае сбрасывает их все к значениям по умолчанию.

nF Escape-последовательности

Если ESC за которым следует байт в диапазоне 0x20—0x2F , escape-последовательность имеет тип nF. За указанным байтом следует любое количество дополнительных байтов в этом диапазоне, а затем байт в этом диапазоне. 0x30-0x7E . Эти escape-последовательности подразделяются на подкатегории по двум младшим битам первого байта, например, «тип 2F" для последовательностей, где первый байт 0x22 ; и находится ли последний байт в диапазоне 0x30—0x3F, обозначающий частное использование (например, «тип 2Fp") или нет (например, "тип 2Ft").

Большая часть nFt последовательности предназначены для изменения текущего набора символов и перечислены в ISO/IEC 2022 . Некоторые другие:

Какой-то тип 0Ft (объявление) Escape-последовательности ANSI

	Сокр.	Имя	Эффект
ЭСК СП Ф	АКС6 S7C1T	Объявление структуры кода 6 Отправьте 7-битный управляющий символ C1 на хост	Заставляет функциональные клавиши отправлять букву ESC + вместо 8-битных кодов C1.
ЭКУ СП Г	АКС7 S8C1T	Объявление структуры кода 7 Отправить 8-битный управляющий символ C1 на хост	Заставляет функциональные клавиши отправлять 8-битные коды C1.

Если первый байт равен «#», общедоступные последовательности зарезервированы для дополнительных зарегистрированных в ISO-IR индивидуальных функций управления. В настоящее время такие последовательности не зарегистрированы. Тип 3Fp последовательности (в том числе начинающиеся с «#») доступны для функций управления частного использования.

Какой-то тип Escape-последовательности 3Fp (для частного использования), распознаваемые VT100

	Сокр.	Имя	Эффект
ЭСК №3	ДЕКДХЛ	Буквы DEC двойной высоты, верхняя половина	Заставляет текущую строку использовать символы в два раза длиннее. Этот код предназначен для верхней половины.
ЭСК № 4	ДЕКДХЛ	Буквы двойной высоты DEC, нижняя половина	Заставляет текущую строку использовать символы в два раза длиннее. Этот код предназначен для нижней половины.
ЭСК № 5	ДЕКСВЛ	Линия одинарной ширины DEC	Заставляет текущую строку использовать символы одинарной ширины в соответствии с поведением по умолчанию.
ЭСК №6	ДЕКДВЛ	Линия двойной ширины DEC	Заставляет текущую строку использовать символы двойной ширины, отбрасывая любые символы во второй половине строки.

Примеры

CSI 2 J — При этом экран очищается, а на некоторых устройствах курсор перемещается в положение y,x 1,1 (верхний левый угол).

CSI 32 m — Это делает текст зеленым. Зеленый цвет может быть темным, тускло-зеленым, поэтому вы можете включить жирный шрифт с помощью последовательности CSI 1 m что сделало бы его ярко-зеленым, или комбинированным как CSI 32 ; 1 m. В некоторых реализациях используется состояние «Жирный», чтобы сделать символ ярким.

CSI 0 ; 6 8 ; "DIR" ; 13 p — При этом клавиша F10 переназначается для отправки в буфер клавиатуры строки «DIR» и ENTER, которая в командной строке DOS будет отображать содержимое текущего каталога. (Только для MS-DOS ANSI.SYS) Иногда это использовалось для бомб ANSI . Это код частного использования (обозначается буквой p), использующий нестандартное расширение для включения параметра со строковым значением. Если следовать букве стандарта, последовательность будет считаться заканчивающейся буквой D.

CSI s — При этом сохраняется позиция курсора. Использование последовательности CSI u вернет его в прежнее положение. Допустим, текущая позиция курсора — 7(y) и 10(x). Последовательность CSI s сохранит эти два числа. Теперь вы можете перейти к другой позиции курсора, например 20(y) и 3(x), используя последовательность CSI 20 ; 3 H или CSI 20 ; 3 f. Теперь, если вы используете последовательность CSI u, позиция курсора вернется к 7(y) и 10(x). Некоторым терминалам требуются последовательности DEC. ESC 7 / ESC 8 вместо этого он пользуется более широкой поддержкой.

В сценариях оболочки

Escape-коды ANSI часто используются в UNIX и UNIX-подобных терминалах для подсветки синтаксиса . Например, на совместимых терминалах следующая команда списка обозначает цвета файлов и каталогов по типам.

ls --color

Пользователи могут использовать escape-коды в своих сценариях, включая их как часть стандартного вывода или стандартной ошибки . Например, следующая команда GNU sed украшает вывод команды make , отображая строки, содержащие слова, начинающиеся с «WARN», в обратном видео , а слова, начинающиеся с «ERR», ярко-желтым цветом на темно-красном фоне ( регистр букв игнорируется). Представления кодов выделены.

make 2>&1 | sed -e 's/.*\bWARN.*/\x1b[7m&\x1b[0m/i' -e 's/.*\bERR.*/\x1b[93;41m&\x1b[0m/i'

Следующая функция Bash мигает на терминале (путем поочередной отправки кодов обратного и нормального видеорежима), пока пользователь не нажмет клавишу.

flasher () { while true; do printf \\e[?5h; sleep 0.1; printf \\e[?5l; read -s -n1 -t1 && break; done; }

Это можно использовать для предупреждения программиста о завершении длинной команды, например, с помощью make ; flasher .

printf \\033c

Это перезагрузит консоль, аналогично команде reset в современных системах Linux; однако он должен работать даже в старых системах Linux и в других (не Linux) вариантах UNIX.

В C

Вывод примера программы на терминале Gnome

#include <stdio.h>

int main(void)
{
    int i, j, n;

    for (i = 0; i < 11; i++) {
        for (j = 0; j < 10; j++) {
            n = 10 * i + j;
            if (n > 108) break;
            printf("\033[%dm %3d\033[m", n, n);
        }
        printf("\n");
    }
    return 0;
}

Последовательность ввода терминала

Нажатие специальных клавиш на клавиатуре, а также вывод множества последовательностей xterm CSI, DCS или OSC часто приводит к созданию последовательности CSI, DCS или OSC, отправляемой с терминала на компьютер так, как если бы ее набрал пользователь.

При вводе ввода на терминале нажатия клавиш за пределами обычной основной буквенно-цифровой области клавиатуры могут быть отправлены на хост в виде последовательностей ANSI. Клавиши, имеющие эквивалентную функцию вывода, например клавиши курсора, часто отражают последовательность вывода. Однако для большинства нажатий клавиш не существует эквивалентной последовательности вывода.

Существует несколько схем кодирования, и, к сожалению, большинство терминалов смешивают последовательности из разных схем, поэтому программное обеспечение хоста должно иметь возможность обрабатывать входные последовательности, используя любую схему. Еще больше усложняет дело то, что сами терминалы VT имеют две схемы ввода: обычный режим и режим приложения , которые могут переключаться приложением.

(черновой раздел)

<char>                                         -> char
<esc> <nochar>                                 -> esc
<esc> <esc>                                    -> esc
<esc> <char>                                   -> Alt-keypress or keycode sequence
<esc> '[' <nochar>                             -> Alt-[
<esc> '[' (<modifier>) <char>                  -> keycode sequence, <modifier> is a decimal number and defaults to 1 (xterm)
<esc> '[' (<keycode>) (';'<modifier>) '~'      -> keycode sequence, <keycode> and <modifier> are decimal numbers and default to 1 (vt)

Если завершающим символом является «~», первое число должно присутствовать и является номер кода ключа, второе число является необязательным значением модификатора. Если прекращение символ — это буква, буква — это значение кода клавиши, а необязательный номер — значение модификатора.

Значение модификатора по умолчанию равно 1, и после вычитания 1 это растровое изображение модификатора. нажимаемые клавиши: Meta+ Ctrl+ Alt+ ⇧ Shift. Так, например, <esc>[4;2~ является ⇧ Shift+ End, <esc>[20~ это функциональная клавиша F9, <esc>[5C является Ctrl+ →.

Другими словами, модификатор представляет собой сумму следующих чисел:

Клавиша нажата	Число	Комментарий
	1	всегда добавляется, остальное необязательно
Сдвиг	1
(Слева) Альт	2
Контроль	4
Мета	8

vt sequences:
<esc>[1~    - Home        <esc>[16~   -             <esc>[31~   - F17
<esc>[2~    - Insert      <esc>[17~   - F6          <esc>[32~   - F18
<esc>[3~    - Delete      <esc>[18~   - F7          <esc>[33~   - F19
<esc>[4~    - End         <esc>[19~   - F8          <esc>[34~   - F20
<esc>[5~    - PgUp        <esc>[20~   - F9          <esc>[35~   - 
<esc>[6~    - PgDn        <esc>[21~   - F10         
<esc>[7~    - Home        <esc>[22~   -             
<esc>[8~    - End         <esc>[23~   - F11         
<esc>[9~    -             <esc>[24~   - F12         
<esc>[10~   - F0          <esc>[25~   - F13         
<esc>[11~   - F1          <esc>[26~   - F14         
<esc>[12~   - F2          <esc>[27~   -             
<esc>[13~   - F3          <esc>[28~   - F15         
<esc>[14~   - F4          <esc>[29~   - F16         
<esc>[15~   - F5          <esc>[30~   -

xterm sequences:
<esc>[A     - Up          <esc>[K     -             <esc>[U     -
<esc>[B     - Down        <esc>[L     -             <esc>[V     -
<esc>[C     - Right       <esc>[M     -             <esc>[W     -
<esc>[D     - Left        <esc>[N     -             <esc>[X     -
<esc>[E     -             <esc>[O     -             <esc>[Y     -
<esc>[F     - End         <esc>[1P    - F1          <esc>[Z     -
<esc>[G     - Keypad 5    <esc>[1Q    - F2       
<esc>[H     - Home        <esc>[1R    - F3       
<esc>[I     -             <esc>[1S    - F4       
<esc>[J     -             <esc>[T     - 

<esc>[A к <esc>[D такие же, как выходные последовательности ANSI. <modifier> обычно опускается, если не нажаты клавиши-модификаторы, но большинство реализаций всегда выдают <modifier> для F1– F4. (черновой раздел)

В Xterm имеется подробная страница документации по различным схемам последовательности ввода функциональных клавиш и мыши с терминалов DEC VT и различных других терминалов, которые он эмулирует. Томас Дики со временем оказал ему большую поддержку; он также ведет список ключей по умолчанию, используемых другими эмуляторами терминала для сравнения.

• На консоли Linux определенные функциональные клавиши генерируют последовательности вида CSI [ char. Последовательность CSI должна завершиться на [.
• Старые версии Терминатора генерируют SS3 1; modifiers char когда F1 – F4 нажимаются с модификаторами. Неправильное поведение было скопировано из терминала GNOME .
• xterm ответы CSI row ; column R если спросят о положении курсора и CSI 1 ; modifiers R если F3 клавиша нажата с модификаторами, которые конфликтуют в случае row == 1. Этого можно избежать, используя ? частный модификатор как CSI ? 6 n, что будет отражено в ответе как CSI ? row ; column R.
• многие терминалы добавляются ESC к любому символу, который набирается с нажатой клавишей Alt. Это создает неоднозначность для заглавных букв и символов. @[\]^_, который будет формировать коды C1.
• Консоль генерирует SS3 modifiers char когда F1 – F4 нажимаются с модификаторами.
• iTerm2 поддерживает отчеты о дополнительных ключах через расширенный режим CSI u.

См. также

• ANSI искусство
• Управляющий персонаж
• Расширенный ассемблер и воссоздатель терминала атрибутов видео (AVATAR)
• ИСО/МЭК ОТК 1/ПК 2
• Коды управления C0 и C1

Внешние ссылки

• Стандарт ECMA-48, Функции управления для наборов кодированных символов . ( 5-е издание, июнь 1991 г. ), Европейская ассоциация производителей компьютеров, Женева, 1991 г. (также опубликовано ISO и IEC как стандарт ISO/IEC 6429)
• vt100.net Документы DEC
• «ANSI.SYS — escape-последовательности эмуляции терминала ansi» . Архивировано из оригинала 6 февраля 2006 года . Проверено 22 февраля 2007 г.
• Xterm/Escape-последовательности
• AIXterm/Escape-последовательности
• Коллекция escape-последовательностей для терминалов, которые частично соответствуют ECMA-48 и его аналогам.
• «ESC-последовательности ANSI» . Архивировано из оригинала 25 мая 2011 года.
• Рек. МСЭ-Т. МСЭ-Т T.416 (03/93) Информационные технологии – Архитектура открытого документа (ODA) и формат обмена: Архитектуры символьного контента