К содержанию
fohbook/ TouchDesigner для света
уверенный

Раскладка: змейка и произвольная геометрия

Как описать, где физически находится каждый светодиод, и превратить это в карту выборки.

Физический порядок светодиодов почти никогда не совпадает с порядком пикселей в картинке. Задача раскладки — построить соответствие.

Змейка

Самый частый случай: лента уложена рядами, и каждый следующий ряд идёт в обратную сторону.

ряд 1:  → → → → → →
ряд 2:  ← ← ← ← ← ←
ряд 3:  → → → → → →

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

Решается двумя способами:

  1. На контроллере: многие пиксель-контроллеры имеют настройку serpentine. Если она есть — включите её и не думайте.
  2. В патче: перевернуть каждый чётный ряд. Проще всего сделать это на уровне картинки — Flip TOP для чётных строк или готовая UV-карта.

Произвольная геометрия

Настоящая сила TouchDesigner. Схема:

координаты светодиодов (таблица или SOP/POP)
              │
        карта выборки (UV)
              │
    remap / сэмплирование картинки по этим точкам
              │
       значения в порядке подключения

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

Координаты берутся из таблицы патча или прямо из трёхмерной сцены.

Как построить карту

Через UV-текстуру. Картинка, в которой красный канал — координата X, зелёный — Y. Remap TOP берёт исходник и раскладывает по этой карте. Быстро, всё на GPU.

Через инстансинг. Точки в трёхмерной сцене, каждая берёт цвет из картинки по своим координатам, результат рендерится в строку N × 1. Гибко, наглядно, чуть дороже.

Через POP. Точки с атрибутами, цвет сэмплируется на GPU и уходит прямо в DMX Out POP. Самый прямой путь в версии 2025.

Замер реальных координат

Координаты нужно откуда-то взять. Варианты по возрастанию точности:

  1. Из чертежа — если конструкция сделана по чертежу.
  2. Замер рулеткой — надёжно и долго.
  3. По фотографии: снять конструкцию с включёнными по одному светодиодами и найти их на кадре. Автоматизируется скриптом и даёт реальные координаты в системе камеры.
  4. По камере в реальном времениКамера как обратная связь.

Третий способ — самый практичный на сложных объектах: полчаса работы вместо дня замеров.

Направление и начало

Запишите для каждой линии: где первый светодиод, в какую сторону идёт лента, сколько их. Это документация, без которой перекоммутация после ремонта превращается в детектив.

Тестовый паттерн для проверки раскладки

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

Раскладка живёт в данных, а не в узлах

Соблазн «поправить пару рядов руками» велик, но такая правка не переживёт следующей перекоммутации. Всё описание — в таблице или в карте, которую можно перестроить.

рядом по смыслу