Профиль прибора

Библиотеки приборов в TouchDesigner нет, профиль пишут руками, и при правильном чтении мануала это минут пятнадцать.

В инструкции есть таблица DMX (DMX chart): номер канала, название, диапазоны и их смысл. Режимов у прибора часто несколько — 8, 16, 24 канала, — выбирается режим на самом приборе, и профиль обязан ему соответствовать.

Режим — первым делом

Половина «реагирует не так» — режим на приборе не совпал с профилем. Прежде чем искать в коде, смотрят на дисплей прибора.

Тип	Пример	Как вести
Непрерывный	Dimmer, Pan, Tilt, Zoom	0…1 → 0…255, кривая
16-битный	Pan/Pan Fine	Два канала — 16 бит
Цвет	R, G, B, W, A, UV	Обычно линейно, калибровку проверить
Дискретный	Гобо, призма, колесо цвета	Диапазоны — Дискретные каналы
Управляющий	Шаттер, строб, режимы, reset	Особые значения, часто с задержкой
Скорость	Pan/Tilt speed	Бывает перевёрнут: 0 — быстро

0–7      открыто
8–15     гобо 1
16–23    гобо 2
...
128–190  вращение вперёд, скорость по значению
191–255  вращение назад

Так выглядит колесо гобо, и в проекте это выбор: меню или индекс, который превращается в середину нужного диапазона. Край брать нельзя — приборы разных партий расходятся на единицу.

У многих приборов яркость держат двое — диммер и шаттер, и с закрытым шаттером диммер можно крутить сколько угодно. «Шаттер открыт» ставят состоянием по умолчанию, иначе первый запуск уйдёт на отладку не того.

id        имя
type      тип профиля
universe  юниверс
address   стартовый адрес
mode      режим прибора
x y z     позиция в пространстве
rot       ориентация (для голов)

Это минимум на прибор, и позиция тут не для красоты: на ней стоят эффекты по геометрии и наведение.

Профиль проверяют так: все каналы в ноль — прибор гаснет; шаттер открыт, диммер вверх — загорается; дальше каждый канал по очереди от 0 до 255 с записью того, что происходит, — скучно, но иначе надёжно не бывает; и расхождения сверяют с мануалом.

Библиотека профилей в файлах

Прибор — один JSON или CSV с каналами. Со временем появится своя библиотека, и патч нового шоу станет быстрым. Формат придумывают один раз и больше не меняют.

На других пультах