Skip to content

kitty keyboard protocol

unxed edited this page Jan 28, 2025 · 24 revisions

Оригинал документации на протокол китти

Ответы на вопросы про непонятные места в протоколе

Ниже русский перевод спецификации.

Полноценная работа с клавиатурой в терминалах

В современных терминалах есть множество проблем, связанных с обработкой клавиатуры. Основные из них:

  • Нельзя использовать модификаторы, кроме ctrl и alt.
  • Нет надежного способа использовать комбинации из нескольких модификаторов, за исключением shift+alt и ctrl+alt.
  • Многие escape-последовательности, кодирующие события клавиатуры, неоднозначны: разные нажатия могут кодироваться одинаково.
  • Нет способа различать типы событий: нажатие, отпускание, повторение.
  • Нет надёжного способа отличить одиночное нажатие Esc от начала escape-последовательности. Программы используют для этого хаки, основанные на замерах времени, что приводит к ошибкам (например, https://github.com/neovim/neovim/issues/2035).

Чтобы решить эти и другие проблемы, для kitty разработан новый протокол клавиатуры, обратно совместимый, но позволяющий приложениям использовать расширенные возможности. Протокол основан на уже имеющейся работе в этом направлении, начатой в статье fixterms (http://www.leonerd.org.uk/hacks/fixterms/), но исправляет в ней ряд ошибок (см. конец документа). Обсуждение спецификации — https://github.com/kovidgoyal/kitty/issues/3248.

Посмотреть протокол в действии (со всеми улучшениями) можно, запустив в kitty:

kitten show-key -m kitty

Кроме kitty, этот протокол реализован в:

Библиотеки, реализующие протокол:

Программы, реализующие протокол:

Оболочки, реализующие протокол:

Добавлено в версии 0.20.0.

Быстрый старт

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

  1. Отправьте escape-последовательность CSI > 1 u при запуске приложения (если используется основной экран) или при переходе в альтернативный экран.
  2. Все события клавиатуры будут отправляться в нескольких легко разбираемых форматах.
  3. Отправьте escape-последовательность CSI < u при выходе из приложения (если используется основной экран) или перед выходом из альтернативного экрана, чтобы восстановить предыдущий режим клавиатуры.

События будут передаваться либо как обычный UTF-8 текст, либо в виде escape-последовательностей (CSI — это байты 0x1b 0x5b):

CSI число ; модификаторы [u~]
CSI 1 ; модификаторы [ABCDEFHPQS]
0x0d - для Enter
0x7f или 0x08 - для Backspace
0x09 - для Tab

число в первом формате — это либо Unicode-код клавиши (например, 97 для a), либо одно из чисел из таблицы функциональных клавиш (см. ниже). Необязательный параметр модификаторы кодирует активные модификаторы.

Второй формат используется для некоторых функциональных клавиш (Home, End, стрелки, F1-F4). Если модификаторов нет, параметры опускаются: CSI [ABCDEFHPQS].

Для расширенных возможностей (повторы, отпускания клавиш и т.д.) используйте механизм прогрессивного улучшения, описанный далее.

Обзор

События клавиатуры делятся на два типа: печатающие и непечатающие. Печатающие события отправляются как UTF-8 текст. Это безопасно, так как UTF-8 не содержит управляющих кодов C0. Непечатающие события кодируются escape-последовательностями. В режиме совместимости (по умолчанию) используются старые escape-коды, чтобы старые приложения продолжали работать. Для расширенных функций (отпускание/повтор) приложения могут запросить у терминала дополнительную информацию.

Основная escape-последовательность:

CSI код-клавиши-unicode:альтернативные-коды-клавиш ; модификаторы:тип-события ; текст-в-виде-кодов u

Пробелы добавлены для ясности. Параметры — десятичные числа. Поля разделяются точкой с запятой, подполя — двоеточием. Обязательно только поле код-клавиши-unicode. Последовательность заканчивается символом u (байт 0x75).

Коды клавиш

код-клавиши-unicode — это Unicode-код клавиши в десятичном представлении. Например, клавиша A представляется как 97 (код строчной a). Всегда используется код строчной версии клавиши. Например, ctrl+shift+a кодируется как CSI 97;модификаторы u, а не CSI 65;модификаторы u.

Если приложение запрашивает альтернативные коды, терминал может отправить ещё два Unicode-кода: код клавиши со сдвигом и код клавиши в базовой раскладке, разделённые двоеточиями. Код со сдвигом — это просто код заглавной версии символа (если сдвиг активен). Например, a становится A. Это нужно для корректной обработки сочетаний клавиш вроде ctrl+плюс, которое может быть ctrl+shift+равно или ctrl+плюс в зависимости от клавиатуры. Код со сдвигом отправляется только если в модификаторах есть shift.

Код в базовой раскладке — это код соответствующей клавиши в стандартной раскладке PC-101. Например, если пользователь использует кириллическую клавиатуру, нажатие ctrl+С будет соответствовать ctrl+c в стандартной раскладке. Терминал отправит базовый код 99, соответствующий клавише c.

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

CSI код-клавиши-unicode::базовый-код

Модификаторы

Протокол поддерживает восемь модификаторов: shift, alt, ctrl, super, hyper, meta, num_lock и caps_lock. super — это клавиша Windows/Linux или Command на Mac. alt — это Option на Mac. hyper и meta обычно есть только в X11/Wayland с особыми правилами XKB.

Модификаторы кодируются битовой маской:

shift     0b1         (1)
alt       0b10        (2)
ctrl      0b100       (4)
super     0b1000      (8)
hyper     0b10000     (16)
meta      0b100000    (32)
caps_lock 0b1000000   (64)
num_lock  0b10000000  (128)

В escape-последовательности значение модификатора кодируется как десятичное число 1 + фактические модификаторы. Например, только shift — это 1 + 1 = 2, ctrl+shift — это 1 + 0b101 = 6. Если поле модификаторов отсутствует, значение по умолчанию — 1 (нет модификаторов). Если модификатор активен (клавиша нажата или включен lock), бит этого модификатора должен быть установлен.

Когда событие связано с клавишей-модификатором, бит соответствующего модификатора должен быть установлен в соответствии с состоянием модификатора, включая эффект текущего события. Например, при нажатии LEFT_CONTROL бит ctrl должен быть установлен, а при отпускании — сброшен. Когда нажаты обе клавиши Ctrl, и одна отпускается, событие отпускания должно иметь бит ctrl установленным. Подробнее: https://github.com/kovidgoyal/kitty/issues/6913.

Типы событий

Есть три типа событий: press (нажатие), repeat (повтор) и release (отпускание). Они кодируются (если запрошены флагом 0b10) как подполе поля модификаторов, разделённое двоеточием. Если модификаторов нет, поле модификаторов должно иметь значение 1, а подполе типа события — тип события. press имеет значение 1 и используется по умолчанию. repeat — это 2, release — это 3. Примеры:

CSI код-клавиши             # press
CSI код-клавиши;модификатор    # press
CSI код-клавиши;модификатор:1  # press
CSI код-клавиши;модификатор:2  # repeat
CSI код-клавиши;модификатор:3  # release

Замечание: Для печатающих событий типы событий не поддерживаются, если приложение не запрашивает режим отчёта о клавишах (см. ниже).

Текст в виде кодов

Терминал может отправлять текст, связанный с событием, как последовательность Unicode-кодов. Это включается механизмом прогрессивного улучшения. Примеры:

shift+a -> CSI 97 ; 2 ; 65 u  # Текст 'A' кодируется как 65
option+a -> CSI 97 ; ; 229 u  # Текст 'å' кодируется как 229

Несколько кодов разделяются двоеточиями. Если текст не связан ни с одной клавишей, используется код 0. Текст не должен содержать управляющих кодов (коды меньше U+0020 и коды из блоков C0 и C1).

Не-Unicode клавиши

Многие клавиши не соответствуют буквам (функциональные клавиши: Escape, Play, Pause, F1, Home и т.д.). Они кодируются с помощью кодов из Private Use Area (57344 - 63743). Соответствие имён клавиш кодам приведено в таблице функциональных клавиш ниже.

Прогрессивное улучшение

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

CSI = флаги ; режим u

флаги — десятичное число, кодирующее набор битовых флагов. Необязательный параметр режим (по умолчанию 1) указывает, как применяются флаги:

  • 1: все установленные биты устанавливаются, сброшенные — сбрасываются.
  • 2: все установленные биты устанавливаются, сброшенные — не меняются.
  • 3: все установленные биты сбрасываются, сброшенные — не меняются.
Бит Значение
0b1 (1) Различать escape-последовательности
0b10 (2) Сообщать о типах событий
0b100 (4) Сообщать об альтернативных клавишах
0b1000 (8) Сообщать обо всех клавишах как escape-кодах
0b10000 (16) Сообщать о связанном тексте

Программа может запросить текущие значения флагов:

CSI ? u

Терминал ответит:

CSI ? флаги u

Программа может поместить/извлечь текущие флаги в стек терминала:

CSI > флаги u  # поместить в стек (по умолчанию ноль, если флаги опущены)
CSI < число u # извлечь число записей из стека (по умолчанию 1)

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

Замечание: Основной и альтернативный экраны должны иметь независимые стеки режимов клавиатуры. Это позволяет программе, использующей альтернативный экран (например, редактору), менять режим клавиатуры, не затрагивая основной экран. Без этого редактору пришлось бы каким-то образом узнавать режим основного экрана и восстанавливать его при выходе.

Различать escape-последовательности

Это улучшение (0b1) решает проблему пересечения кодов некоторых клавиш с другими управляющими кодами. Например, нажатие Esc генерирует байт 0x1b, который также используется для начала escape-последовательностей. alt+[ генерирует байты, используемые для CSI.

Включение этого флага заставит терминал сообщать о Esc, alt+клавиша, ctrl+клавиша, ctrl+alt+клавиша, shift+alt+клавиша с помощью последовательностей CSI u вместо старых. Здесь клавиша — любая ASCII-клавиша. Непечатающие события клавиш цифрового блока также будут кодироваться с помощью CSI u, используя специальные коды из таблицы ниже.

С этим флагом все непечатающие события представляются в одном из двух форматов:

CSI число;модификатор u
CSI 1;модификатор[~ABCDEFHPQS]

Это упрощает разбор событий. ctrl+c больше не будет генерировать сигнал SIGINT, а будет доставлено как escape-код CSI u. Исключения: Enter, Tab и Backspace — они генерируют те же байты, что и раньше, чтобы пользователь мог ввести и выполнить команду вроде reset, если программа, установившая этот режим, завершилась аварийно, не сбросив его. Модификаторы-блокировки (Lock) не сообщаются для печатающих клавиш, чтобы сохранить их работоспособность в старых программах. Чтобы получать lock-модификаторы для всех клавиш, используйте улучшение "Сообщать обо всех клавишах как escape-кодах".

Сообщать о типах событий

Это улучшение (0b10) заставляет терминал сообщать о повторах и отпусканиях клавиш. Обычно отправляются только нажатия, а повторы обрабатываются как нажатия.

Замечание: Enter, Tab и Backspace не будут иметь событий отпускания, если не установлено также "Сообщать обо всех клавишах как escape-кодах".

Сообщать об альтернативных клавишах

Это улучшение (0b100) заставляет терминал сообщать об альтернативных кодах клавиш в дополнение к основному, что помогает в обработке сочетаний клавиш. Обратите внимание, что этот флаг только дополняет escape-коды, используемые для представления событий клавиатуры. Поэтому это усовершенствование затронет только события клавиатуры, уже представленные в виде escape-кодов из-за других действующих улучшений.

Сообщать обо всех клавишах как escape-кодах

Печатающие события (например, обычные нажатия без модификаторов) в старом протоколе отправляют только текст. Нет способа узнать о повторах/отпусканиях. Это нужно, например, в играх (перемещение с помощью WASD).

Это улучшение (0b1000) включает отправку событий для всех клавиш, включая печатающие. Текст при этом не отправляется. Если нужен и текст, используйте совместно с улучшением "Сообщать о связанном тексте".

Кроме того, в этом режиме сообщается о нажатиях клавиш-модификаторов. Все клавиши, включая Enter, Tab, Backspace, сообщаются как escape-коды.

Сообщать о связанном тексте

Это улучшение (0b10000) указывает терминалу при событиях, связанных с печатающими текст клавишами, добавлять соответствующий текст внутрь escape-кодов CSI u. Обратите внимание, что этот флаг является улучшением режима «отправлять все нажатия клавиш как escape последовательности» и отдельно от него не работает (поведение в этом случае строго не определено).

Определение поддержки протокола

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

Старая кодировка событий клавиатуры

По умолчанию терминал использует старую кодировку. В ней отправляются только нажатия и повторы, и нет способа их различить. Текст отправляется как UTF-8.

Все события, не описанные в этом разделе, отправляются с помощью стандартной кодировки CSI u. Это включает клавиши, не кодируемые в старой кодировке, что расширяет возможности даже без прогрессивного улучшения.

Старые функциональные клавиши

Эти клавиши кодируются тремя способами:

CSI число ; модификатор ~
CSI 1 ; модификатор {ABCDEFHPQS}
SS3 {ABCDEFHPQRS}

Если модификаторов нет, параметр модификатор опускается. Во втором формате число всегда 1 и опускается, если нет модификаторов. Третий формат преобразуется во второй, если есть модификаторы (SS3 — это байты 0x1b 0x4f).

Эти последовательности должны соответствовать записям в базе данных terminfo. В таблице ниже перечислены клавиша, её имя в terminfo и escape-код, используемый kitty. Другой терминал будет использовать код из своей базы terminfo.

Некоторые клавиши имеют альтернативное представление в режиме клавиш курсора (terminfo: smkx/rmkx). Эта форма используется только в режиме клавиш курсора и только без модификаторов.

Название Имя в terminfo Escape-код
INSERT kich1 CSI 2 ~
DELETE kdch1 CSI 3 ~
PAGE_UP kpp CSI 5 ~
PAGE_DOWN knp CSI 6 ~
UP cuu1,kcuu1 CSI A, SS3 A
DOWN cud1,kcud1 CSI B, SS3 B
RIGHT cuf1,kcuf1 CSI C, SS3 C
LEFT cub1,kcub1 CSI D, SS3 D
HOME home,khome CSI H, SS3 H
END -,kend CSI F, SS3 F
F1 kf1 SS3 P
F2 kf2 SS3 Q
F3 kf3 SS3 R
F4 kf4 SS3 S
F5 kf5 CSI 15 ~
F6 kf6 CSI 17 ~
F7 kf7 CSI 18 ~
F8 kf8 CSI 19 ~
F9 kf9 CSI 20 ~
F10 kf10 CSI 21 ~
F11 kf11 CSI 23 ~
F12 kf12 CSI 24 ~
MENU kf16 CSI 29 ~

Ещё несколько функциональных клавиш имеют особые старые кодировки, так как они часто используются, и старые приложения могут путаться, видя CSI u:

Клавиша Без мод. Ctrl Alt Shift Ctrl+Shift Alt+Shift Ctrl+Alt
Enter 0xd 0xd 0x1b 0xd 0xd 0xd 0x1b 0xd 0x1b 0xd
Escape 0x1b 0x1b 0x1b 0x1b 0x1b 0x1b 0x1b 0x1b 0x1b 0x1b
Backspace 0x7f 0x8 0x1b 0x7f 0x7f 0x8 0x1b 0x7f 0x1b 0x8
Tab 0x9 0x9 0x1b 0x9 CSI Z CSI Z 0x1b CSI Z 0x1b 0x9
Space 0x20 0x0 0x1b 0x20 0x20 0x0 0x1b 0x20 0x1b 0x0

Backspace и ctrl+Backspace в некоторых терминалах перепутаны. Это можно определить по свойству terminfo kbs, которое должно соответствовать Backspace.

Все клавиши цифрового блока кодируются как их не-keypad эквиваленты. Чтобы различать их, используйте флаг disambiguate.

Терминалы могут по-разному обрабатывать функциональные клавиши без старой кодировки. kitty кодирует их с помощью CSI u даже в старом режиме, чтобы их можно было использовать даже в программах, не поддерживающих протокол kitty. Другие терминалы могут игнорировать такие клавиши в старом режиме или иметь опцию для управления этим поведением.

Старые текстовые клавиши

Для совместимости клавиши a-z, 0-9, `, -, =, [, ], \, ;, ', ,, ., / с модификаторами shift, alt, ctrl, shift+alt, ctrl+alt выводятся по следующему алгоритму:

  1. Если нажат alt, вывести байт ESC (0x1b).
  2. Если нажат ctrl, преобразовать клавишу по таблице в разделе "Старое преобразование ASCII-клавиш с Ctrl".
  3. Иначе, если нажат shift, вывести код клавиши со сдвигом (например, A для a, $ для 4).
  4. Иначе вывести код клавиши без изменений.

ctrl+space выводится как NULL-байт (0x0).

Любые другие комбинации модификаторов с этими клавишами выводятся как escape-коды CSI u.

Клавиша Обычная shift alt ctrl shift+alt alt+ctrl ctrl+shift
i i (105) I (73) ESC i ) (41) ESC I ESC ) CSI 105; 6 u
3 3 (51) # (35) ESC 3 3 (51) ESC # ESC 3 CSI 51; 6 u
; ; (59) : (58) ESC ; ; (59) ESC : ESC ; CSI 59; 6 u

Замечание: Многие старые escape-коды неоднозначны: разные нажатия дают одинаковые коды (например, ctrl+i — то же, что и tab, ctrl+m — то же, что и Enter, ctrl+r — то же, что и ctrl+shift+r). Чтобы решить это, используйте улучшение disambiguate.

Определения функциональных клавиш

Все числа находятся в Private Use Area (57344 - 63743), кроме нескольких клавиш, использующих числа меньше 32 и 127 (управляющие коды C0) для совместимости.

Название CSI Название CSI
ESCAPE 27 u ENTER 13 u
TAB 9 u BACKSPACE 127 u
INSERT 2 ~ DELETE 3 ~
LEFT 1 D RIGHT 1 C
UP 1 A DOWN 1 B
PAGE_UP 5 ~ PAGE_DOWN 6 ~
HOME 1 H или 7 ~ END 1 F или 8 ~
CAPS_LOCK 57358 u SCROLL_LOCK 57359 u
NUM_LOCK 57360 u PRINT_SCREEN 57361 u
PAUSE 57362 u MENU 57363 u
F1 1 P или 11 ~ F2 1 Q или 12 ~
F3 13 ~ F4 1 S или 14 ~
F5 15 ~ F6 17 ~
F7 18 ~ F8 19 ~
F9 20 ~ F10 21 ~
F11 23 ~ F12 24 ~
F13 57376 u F14 57377 u
F15 57378 u F16 57379 u
F17 57380 u F18 57381 u
F19 57382 u F20 57383 u
F21 57384 u F22 57385 u
F23 57386 u F24 57387 u
F25 57388 u F26 57389 u
F27 57390 u F28 57391 u
F29 57392 u F30 57393 u
F31 57394 u F32 57395 u
F33 57396 u F34 57397 u
F35 57398 u KP_0 57399 u
KP_1 57400 u KP_2 57401 u
KP_3 57402 u KP_4 57403 u
KP_5 57404 u KP_6 57405 u
KP_7 57406 u KP_8 57407 u
KP_9 57408 u KP_DECIMAL 57409 u
KP_DIVIDE 57410 u KP_MULTIPLY 57411 u
KP_SUBTRACT 57412 u KP_ADD 57413 u
KP_ENTER 57414 u KP_EQUAL 57415 u
KP_SEPARATOR 57416 u KP_LEFT 57417 u
KP_RIGHT 57418 u KP_UP 57419 u
KP_DOWN 57420 u KP_PAGE_UP 57421 u
KP_PAGE_DOWN 57422 u KP_HOME 57423 u
KP_END 57424 u KP_INSERT 57425 u
KP_DELETE 57426 u KP_BEGIN 1 E или 57427 ~
MEDIA_PLAY 57428 u MEDIA_PAUSE 57429 u
MEDIA_PLAY_PAUSE 57430 u MEDIA_REVERSE 57431 u
MEDIA_STOP 57432 u MEDIA_FAST_FORWARD 57433 u
MEDIA_REWIND 57434 u MEDIA_TRACK_NEXT 57435 u
MEDIA_TRACK_PREVIOUS 57436 u MEDIA_RECORD 57437 u
LOWER_VOLUME 57438 u RAISE_VOLUME 57439 u
MUTE_VOLUME 57440 u LEFT_SHIFT 57441 u
LEFT_CONTROL 57442 u LEFT_ALT 57443 u
LEFT_SUPER 57444 u LEFT_HYPER 57445 u
LEFT_META 57446 u RIGHT_SHIFT 57447 u
RIGHT_CONTROL 57448 u RIGHT_ALT 57449 u
RIGHT_SUPER 57450 u RIGHT_HYPER 57451 u
RIGHT_META 57452 u ISO_LEVEL3_SHIFT 57453 u
ISO_LEVEL5_SHIFT 57454 u

Замечание: Escape-коды вида CSI 1 буква будут без 1, если нет модификаторов, так как 1 — значение по умолчанию.

Замечание: В изначальной версии спецификации F3 кодировалась как CSI R и CSI ~. Однако CSI R конфликтует с отчётом о позиции курсора, поэтому был удалён.

Старое преобразование ASCII-клавиш с Ctrl

Когда нажаты ctrl и другая клавиша, терминалы для некоторых клавиш преобразуют результат в управляющий код C0 (значение от 0 до 31). Это преобразование исторически зависело от раскладки аппаратных терминалов и нигде полностью не специфицировано. Лучший источник — Таблица 3-5 в документации VT-100.

Таблица ниже предоставляет распространённое надмножество этой таблицы. ASCII-клавиши, которых нет в таблице, ctrl не должен изменять.

Клавиша Байт Клавиша Байт Клавиша Байт
SPC 0 / 31 0 48
1 49 2 0 3 27
4 28 5 29 6 30
7 31 8 127 9 57
? 127 @ 0 [ 27
\ 28 ] 29 ^ 30
_ 31 a 1 b 2
c 3 d 4 e 5
f 6 g 7 h 8
i 9 j 10 k 11
l 12 m 13 n 14
o 15 p 16 q 17
r 18 s 19 t 20
u 21 v 22 w 23
x 24 y 25 z 26
~ 30

Ошибки в fixterms

Здесь перечислены ошибки в оригинальном предложении fixterms, исправленные в этой спецификации:

  • Нет способа отличить нажатие Esc, кроме использования 8-битных управляющих кодов, что нежелательно.
  • Неверно утверждается, что специальные клавиши иногда кодируются как CSI буква, хотя на самом деле это SS3 буква во всех терминалах новее VT-52.
  • ctrl+shift+tab должен быть CSI 9 ; 6 u, а не CSI 1 ; 5 Z (shift+tab — не отдельная клавиша).
  • Нет поддержки модификатора super.
  • Не упоминается режим клавиш курсора и как он меняет кодировки.
  • Неверное кодирование клавиш со сдвигом: например, ctrl+shift+i кодируется как ctrl+I.
  • Нет способа задать неконфликтующие escape-коды для alt+буква, ctrl+буква, ctrl+alt+буква.
  • Нет способа указать и сдвинутую, и несдвинутую клавишу для надёжного сопоставления сочетаний (например, ctrl+shift+равно и ctrl+плюс).
  • Нет способа указать клавишу в альтернативной раскладке (полезно для кириллицы, чтобы ctrl+c работал при нажатии ctrl+С).
  • Нет способа сообщать о повторах и отпусканиях клавиш, только о нажатиях.
  • Нет способа сообщать о событиях для печатающих клавиш (полезно для игр).
  • Числа назначены только небольшому подмножеству функциональных клавиш.
  • Утверждается, что CSI u не имеет фиксированного значения, хотя он десятилетиями использовался как SCORC (xterm, ansi.sys) и DECSMBV (VT-510). Это неважно, так как эти коды используются для связи с терминалом, а не от него.
  • Упрощённо говорится, что ctrl обычно маскирует с 0x1f. На самом деле это происходит только для некоторых клавиш. Действие ctrl не специфицировано и различается между терминалами из-за разных раскладок клавиатуры.

Почему не стоит использовать modifyOtherKeys из xterm

  • Нет поддержки событий отпускания.
  • Не решает проблему неразличимости Esc от escape-кодов.
  • Не решает проблему одинаковых кодов для разных нажатий.
  • Нет надёжного способа запросить состояние или управлять им из программы.
  • Нет поддержки сдвинутых клавиш.
  • Нет поддержки альтернативных раскладок.
  • Нет поддержки модификаторов, кроме основных четырёх.
  • Нет поддержки клавиш-блокировок (Num Lock, Caps Lock).
  • Полностью не специфицировано. Лучшее описание — здесь. Оно не содержит спецификации, какие числа назначать функциональным клавишам, кроме запуска скрипта на Perl в X11!

Clone this wiki locally