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

В 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 с описанием каналов. Со временем у вас появится своя библиотека, и патч нового шоу станет быстрым. Формат придумайте один раз и не меняйте.

Откуда брать данные#

Типы каналов#

Дискретные диапазоны#

Шаттер и строб#

Что описать в патче#

Проверка профиля#

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