# 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).