Структура шоу-файла

Световой проект служит дольше видеопатча — его правят на каждой площадке, и структура тут важнее красоты.

/project1
  /config       таблицы: патч, группы, кью, looks, сеть
  /input        приём: DMX in, OSC, таймкод, звук, камера
  /engine       генерация: эффекты, пиксель, наведение
  /state        текущее состояние шоу, кью, мастер
  /output       сборка юниверсов, DMX out
  /ui           панель оператора
  /monitor      диагностика и логи

Поток один, слева направо: вход, движок, состояние, выход, — и правка в одном блоке не задевает остальные.

Всё про конкретную площадку лежит в /config и приходит из файлов, так что переезд — это замена файлов, а не правка сети.

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

Панель оператора — свой Container COMP на служебном мониторе: текущее и следующее кью крупно, таймкод и признак сигнала, мастер и блэкаут, индикаторы «DMX уходит», «контроллеры отвечают», «кадры в норме», последние ошибки. По ней на площадке принимают решения, так что украшением она не считается.

В папке docs при проекте — карта каналов, что вы принимаете с пульта; раскладка юниверсов, кто чем владеет; схема сети с адресами, коммутаторами и портами; инструкция на страницу — включить, выключить, что делать, если; и кому звонить.

.toe двоичный и обычным диффом не читается, хотя утилита toeexpand из комплекта TouchDesigner разберёт его в текст. Помогают логика в .tox и отдельных .py, конфигурация в CSV, которая версионируется нормально, имена с датой и площадкой вроде show_2026-03-14_gorky.toe и копия на флешке, Файл проекта.