101 lines
4.9 KiB
Markdown
101 lines
4.9 KiB
Markdown
# 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).
|