Initial commit

2026-09-06 01:06:40 +08:00
commit 57c4e80f0d
69 changed files with 20940 additions and 0 deletions
@@ -0,0 +1,100 @@
+# paint — per-key раскраска
+
+```
+./katana.py paint --all orange                        # вся клавиатура оранжевым
+./katana.py paint --black --key Tab=green             # только Tab зелёным
+./katana.py paint --black --key a=red --key s=green --key d=blue
+./katana.py paint --black --key 0x25=ff0000           # hex-индекс тоже работает
+./katana.py paint --keep --key tilde=red --key semicolon=lime   # синонимы клавиш
+./katana.py paint --keep --key ~=red --key ;=lime     # символы тоже работают
+./katana.py paint --black --row1 red --row6 magenta   # ряды: F-строка и низ
+```
+
+## Аргументы `paint`
+
+### `--all ЦВЕТ`
+
+Залить все 143 слота этим цветом.
+Без `--black` незатронутые `--key` слоты получат этот же цвет.
+
+### `--key КЛЮЧ=ЦВЕТ`
+
+Покрасить одну клавишу.
+Повторяется сколько нужно (`--key a=red --key s=green`).
+КЛЮЧ — имя из `keymap.py` (`Tab`, `a`, `num7`, `esc`, `f12`), символ клавиши (`` ` ``, `1`, `-`, `[`, `;`, `'`, `\`, `,`, `.`, `/`, `~`), синоним (`tilde`, `minus`, `equal`, `lbracket`, `semicolon`, `quote`, `backslash`, `comma`, `period`, `dot`, `slash`, `question`, `shift`, `ctrl`, `alt`, `enter`, `return`, `del`, `ins`, `pgup`, `pgdn`, `left`/`right`/`up`/`down`, `num0`–`num9`, `numplus`, `numminus`, `numdot`, ...) или hex-индекс `0x00`–`0x8e` (голые цифры — имена клавиш цифрового ряда).
+ЦВЕТ — hex или имя.
+Подробности об именах клавиш — [keys.md](keys.md), о цветах — [colors.md](colors.md).
+
+### `--wasd ЦВЕТ`
+
+Shorthand для четырёх `--key`: покрасить W, A, S, D одним цветом.
+Пример: `paint --black --wasd red`.
+
+### `--numpad ЦВЕТ`
+
+Shorthand для `--key`: покрасить весь нумпад одним цветом (NumLock, `/`, `*`, `-`, `7`–`0`, `.`, `+`, Enter).
+Пример: `paint --black --numpad blue`.
+
+### `--alpha ЦВЕТ`
+
+Shorthand для `--key`: покрасить все 26 буквенных клавиш (A–Z) одним цветом.
+Пример: `paint --black --alpha gold`.
+
+### `--punct ЦВЕТ`
+
+Shorthand для `--key`: покрасить знаковые клавиши основного блока `[`, `]`, `;`, `'`, `\`, `,`, `.`, `/` и пробел одним цветом.
+Пример: `paint --black --punct orange`.
+
+### `--digits ЦВЕТ`
+
+Shorthand для `--key`: покрасить цифровой ряд `` ` ``, `1`–`0`, `-`, `=` одним цветом.
+Пример: `paint --black --digits cyan`.
+
+### `--arrows ЦВЕТ`
+
+Shorthand для `--key`: покрасить четыре стрелки одним цветом.
+Пример: `paint --black --arrows magenta`.
+
+### `--row1`…`--row6 ЦВЕТ`
+
+Shorthand для `--key`: покрасить горизонтальный ряд полной клавиатуры одним цветом (включая нумпад).
+
+Ряд 1 (16 клавиш): `esc`, F1–F12, `prtsc`, `scrlk`, `pause`.
+
+Ряд 2 (21): `` ` ``–`0`, `-`, `=`, `backspace`, `insert`, `home`, `pgup`, `numlock`, `num/`, `num*`, `num-`.
+
+Ряд 3 (21): `tab`, Q–P, `[`, `]`, `\`, `delete`, `end`, `pgdown`, `num7`–`num9`, `num+`.
+
+Ряд 4 (16): `caps`, A–L, `;`, `'`, `enter`, `num4`–`num6`.
+
+Ряд 5 (17): `lshift`, Z–M, `,`, `.`, `/`, `rshift`, `arrowup`, `num1`–`num3`, `numenter`.
+
+Ряд 6 (13): `lctrl`, `lwin`, `lalt`, `space`, `ralt`, `fn`, `menu`, `rctrl`, стрелки, `num0`, `num.`.
+
+Высокие клавиши нумпада (`num+`, `numenter`) отнесены к ряду, где они начинаются физически.
+Пример: `paint --black --row1 red --row6 magenta`.
+
+### `--black`
+
+Начать с полностью чёрной таблицы: покрашены будут только перечисленные клавиши.
+
+### `--keep`
+
+Начать с текущего живого кадра (чтение 04 f5): все прочие клавиши сохраняют свои цвета.
+Используется только вместе с `--key`.
+Цвета читаются в отмасштабированном по яркости виде (максимум `ee`).
+
+### `--brightness 1–15`
+
+Яркость режима `0x80`.
+По умолчанию `15`.
+
+### `--no-save`
+
+Не писать во флеш (см. `mode --no-save` в [COLOR-MODES.md](../COLOR-MODES.md)).
+По умолчанию save выполняется.
+
+Без `--all` и `--key` команда завершается ошибкой.
+Команда пишет таблицу и сразу переключает подсветку в режим `0x80` (custom-таблица).
+
+Имена клавиш и цвета описаны в [keys.md](keys.md) и [colors.md](colors.md).