Формат .tb — краткое пояснение

Полное техническое описание формата — в FORMAT.md, на английском: там байты, таблицы, статусы и доказательства. Здесь — в двух словах, что это и зачем.

---

Что это

.tb — файл пресета TourBox: то, что вы экспортируете и импортируете в TourBox Console. Внутри это сжатый XML, а в нём — таблица на 256 ячеек, по одной на каждый контрол и каждую комбинацию контролов. Ячейка хранит, какое нажатие устройство должно отправить.

Вендор формат не публикует. Мы разобрали его сами: писали файл, импортировали в Console, читали, что она показала, экспортировали обратно и сравнивали байты.

Что разобрано

• Контейнер — упаковка файла. Наш обратный проход байт в байт совпадает с

вендорским.

• Модификаторы — Shift 0x02, Alt 0x04, Ctrl 0x08.
• Клавиши — любой символ ASCII и 45 именованных: стрелки, PageUp/Down, Home,

End, Insert, F1–F24, весь цифровой блок.

• Все 47 слотов — включая комбинации: Side+крестовина, двойные нажатия, пары

крупных кнопок, вращения с зажатой кнопкой.

• Удерживаемый модификатор — кнопка держит Ctrl или Ctrl+Alt, пока нажата.

Это то, что позволяет тащить клип мышью с нужным модификатором.

• Колесо мыши — в том числе с модификаторами. Вращение крутит то, на что

наведён курсор: так поворачиваются слайдеры Lightroom и Lumetri, у которых своего сочетания клавиш нет вовсе.

• Скорость вращения и сила тактильной отдачи — задаются отдельно для каждого

вращения.

Что не разобрано

Кнопки мыши и перетаскивание с удержанием, TourMenu, макросы, плагинные команды. Из этого реально мешает только перетаскивание: без него вращением не потянуть ручку кривой напрямую.

Одна поправка, которую стоит знать

Проект YongHee-Kim/tourbox-preset описывает одиночный Alt как модификатор 0x02. На Elite с Console 5.11.3 0x02 — это Shift, а Alt — 0x04. Сходятся два независимых источника. Если генерировать пресеты по таблице upstream, вместо Alt запишется Shift.

Имена контролов

Проект везде использует английские имена, потому что Console локализована и подписи зависят от языка интерфейса.

English	Русский (Console)	Что это
Knob	Ручка	круглая рифлёная, в центре справа
Scroll	Колесо	вертикальное колёсико слева сверху, как у мыши
Dial	Диск	большой плоский круг слева снизу, самый крупный
Tall	Длинная	высокая кнопка справа
Side	Боковая	узкая на левом торце
Top	Поперечная	широкая плоская сверху
Short	Короткая	маленькая округлая под Tall
D-pad	Вверх / Вниз / Левый / Правый	крестовина внизу
C1 / C2	C1 / C2	две круглые справа сверху
Tour	Tour	каплевидная слева снизу

Легче всего перепутать Scroll (Колесо) и Dial (Диск) — по-русски оба круглые. Scroll — маленькое колёсико, Dial — большой плоский диск.

Если у вас другая модель

Не доверяйте этой таблице — соберите свою. Метод описан в FORMAT.md §10 и занимает около получаса: сгенерировать пробу, импортировать, прочитать подписи в Console, экспортировать обратно, сравнить.