Initial commit

2026-09-06 01:06:40 +08:00
commit 57c4e80f0d
69 changed files with 20940 additions and 0 deletions
@@ -0,0 +1,61 @@
+# Имена клавиш
+
+В `paint --key КЛЮЧ=ЦВЕТ` (и во всех shorthand-алиасах) клавиша задаётся любым из способов:
+
+**Канонические имена** (US-раскладка, из `keymap.py`): `esc`, `f1`–`f12`, `` ` ``–`0` (цифры и тильда), `-`, `=`, `tab`, `q`–`p`, `[`, `]`, `caps`, `a`–`l`, `;`, `'`, `\`, `enter`, `z`–`m`, `,`, `.`, `/`, `lshift`, `lctrl`, `lwin`, `lalt`, `space`, `ralt`, `fn`, `menu`, `rctrl`, `arrowleft`, `arrowdown`, `arrowup`, `arrowright`, `backspace`, `prtsc`, `scrlk`, `pause`, `insert`, `home`, `pgup`, `delete`, `end`, `pgdown`, а также нумпад: `numlock`, `num/`, `num*`, `num-`, `num7`–`num0`, `num.`, `num+`, `numenter`.
+Буквы — строчные или заглавные (`a` = `A`).
+
+**Символы клавиш** пишутся как есть: `` ` ``, `1`–`0`, `-`, `=`, `[`, `]`, `;`, `'`, `\`, `,`, `.`, `/`, `~`.
+
+**Синонимы** (полная таблица — `KEY_SYMBOL_ALIASES` в `keymap.py`; просмотр: `python3 keymap.py`), по клавишам:
+
+| Клавиша          | Синонимы                                                              |
+| ---------------- | --------------------------------------------------------------------- |
+| `` ` `` (тильда) | `tilde`, `grave`, `backquote`, `backtick`                             |
+| `-`              | `minus`, `dash`, `hyphen`                                             |
+| `=`              | `equal`, `equals`                                                     |
+| `[`              | `lbracket`, `leftbracket`, `openbracket`                              |
+| `]`              | `rbracket`, `rightbracket`, `closebracket`                            |
+| `;`              | `semicolon`, `colon`                                                  |
+| `'`              | `quote`, `apostrophe`, `singlequote`                                  |
+| `\`              | `backslash`, `bslash`                                                 |
+| `,`              | `comma`, `lessthan`                                                   |
+| `.`              | `period`, `dot`, `greaterthan`                                        |
+| `/`              | `slash`, `question`                                                   |
+| `space`          | `spacebar`                                                            |
+| `esc`            | `escape`                                                              |
+| `tab`            | `tab`                                                                 |
+| `caps`           | `capslock`                                                            |
+| `enter`          | `return`, `cr`                                                        |
+| `backspace`      | `bksp`                                                                |
+| `lshift`         | `shift`, `leftshift`                                                  |
+| `rshift`         | `rightshift`                                                          |
+| `lctrl`          | `ctrl`, `leftctrl`                                                    |
+| `rctrl`          | `rightctrl`                                                           |
+| `lalt`           | `alt`, `leftalt`                                                      |
+| `ralt`           | `altgr`, `rightalt`                                                   |
+| `lwin`           | `windows`, `super`, `meta`                                            |
+| `menu`           | `context`, `apps`                                                     |
+| `insert`         | `ins`                                                                 |
+| `delete`         | `del`                                                                 |
+| `pgup`           | `pageup`                                                              |
+| `pgdown`         | `pgdn`, `pagedown`                                                    |
+| `prtsc`          | `printscreen`, `prntscr`, `pscr`                                      |
+| `scrlk`          | `scrolllock`, `slck`                                                  |
+| `pause`          | `break`                                                               |
+| `arrowleft`      | `left`, `leftarrow`                                                   |
+| `arrowright`     | `right`, `rightarrow`                                                 |
+| `arrowup`        | `up`, `uparrow`                                                       |
+| `arrowdown`      | `down`, `downarrow`                                                   |
+| `numlock`        | `numlock`                                                             |
+| `num/`           | `numslash`, `numdivide`                                               |
+| `num*`           | `numasterisk`, `numtimes`                                             |
+| `num-`           | `numminus`                                                            |
+| `num+`           | `numplus`                                                             |
+| `num.`           | `numdot`, `numpoint`, `numdecimal`, `numdel`, `numcomma`, `numperiod` |
+| `num0`–`num9`    | `num0`, `num1`, … `num9`                                              |
+| `numenter`       | `numenter`                                                            |
+
+**Hex-индексы**: `0x00`–`0x8e` — прямой адрес LED-слота (голые цифры без `0x` — имена клавиш цифрового ряда, не индексы).
+
+Цвета для `КЛЮЧ=ЦВЕТ` задаются hex-кодом или именем — см. [colors.md](colors.md).