Команда mode¶
Включает один из 19 режимов подсветки и настраивает его параметры.
Примеры¶
./katana.py mode 1 --color ff00ff # статика, маджента
./katana.py mode static --color magenta # то же алиасами
./katana.py mode breathing # дыхание спектром
./katana.py mode breathing --color blue --no-spectrum # синее дыхание
./katana.py mode spectrum --color cyan # цвет игнорируется
./katana.py mode static --spectrum # статика спектром
./katana.py mode waterfall --color gold --no-spectrum --speed 5
./katana.py mode marquee --color red --no-spectrum --direction left
Аргументы¶
| Аргумент | Значения | По умолчанию | Описание |
|---|---|---|---|
N |
1–19, hex, алиас, off |
— | режим подсветки |
--color |
hex или имя | ffffff |
цвет для моно-режимов |
--brightness |
1–15 | 15 |
яркость |
--speed |
2–15 | 10 |
скорость анимации |
--spectrum |
флаг | по режиму | включить спектр |
--no-spectrum |
флаг | — | рисовать один цвет |
--direction |
up, down, left, right | по режиму | направление анимации |
--no-save |
флаг | выключено | не писать во флеш |
Номер режима принимается в десятичном виде или hex.
Значения скорости ниже 2 команда принимает, но печатает предупреждение: в дампах вендора встречаются только края слайдера 0x01 и 0x0f.
Цвет¶
По умолчанию ffffff.
Цвет игнорируется в режиме спектра, а также в flower и spectrum.
У большинства режимов спектр включён по умолчанию, поэтому для одноцветного эффекта нужен --no-spectrum.
Яркость и скорость¶
Яркость принимает значения от 1 до 15.
Скорость принимает значения от 2 до 15, по умолчанию 10.
Для static скорость не применяется: прошивке всегда отправляется 10, а при явном другом значении печатается предупреждение.
Спектр¶
| Ключ | Байт [8] |
Поведение |
|---|---|---|
--spectrum |
01 |
спектр |
--no-spectrum |
00 |
цвет из --color |
| без ключа | по режиму | вендорский выбор |
Вендорский выбор: моно у static и star, спектр у остальных режимов.
Направление¶
Направление задаётся ключом --direction и работает только у пяти режимов.
| Режим | Значения | Смысл |
|---|---|---|
waterfall |
down, up |
вниз или вверх |
flow |
right, left |
вправо или влево |
marquee |
right, left |
вправо или влево |
wind |
right, left |
вправо или влево |
rotate |
right, left |
против часовой или по часовой |
У остальных режимов ключ завершается ошибкой.
Без ключа действует вендорское направление: вниз, вправо, против часовой.
У waterfall и rotate направление работает только в моно: добавьте --no-spectrum.
Направление и значения байта [11] разобраны в разделе Подсветка.
Сохранение¶
По умолчанию настройка пишется во флеш.
Ключ --no-save пропускает 04 f0: режим действует до выключения клавиатуры.
Это полезно для экспериментов, чтобы не изнашивать флеш.
В профиле¶
Секция mode команды apply принимает те же параметры: mode, color, brightness, speed, spectrum и direction.
Подробности — в разделе Команда apply.