11. Вывод DMX LUMIVERSE и VOLUMETRIC¶

English

Помимо проекторов и дисплеев (страница 10a), экран OUTPUT умеет вести LED-приборы по протоколам управления светом и собирать из слоёв композиции настоящий светодиодный объём. Оба типа — свои устройства Screen в том же списке SCREENS/SLICES, со своей карточкой и своим набором вкладок холста.

DMX LUMIVERSE¶

Экран типа DMX LUMIVERSE превращает композицию в управление LED-приборами по проводу: палки (ряд пикселей N×1) и 2D-матрицы W×H, адресованные в вселенные Art-Net 4 или sACN (E1.31).

Приборы и раскладка¶

Библиотека профилей приборов хранится на машине; немодальный FIXTURE EDITOR (кнопка EDIT… у поля PROFILE) редактирует профиль с живым превью обхода. Прибор кладётся на композицию так же, как слайс монитора — сэмплирующим N×1 рендер-путём со своими коррекциями и гаммой. Палка — ряд пикселей N×1, 2D-матрица — сетка W×H с одним из шестнадцати порядков змейки обхода; у прибора есть ведущие каналы и свой порядок цветов (RGB / GBR / …). Прибор двигается по карте каналов мышью (новый стартовый канал; Shift — не выходя за свою вселенную), стрелками — на ±1 канал (Shift — на ширину прибора), Delete удаляет, Ctrl+D дублирует со сдвигом встык; правый клик — IDENTIFY (мигание 1 Гц прямо на проводе), двойной клик открывает EDIT… профиля.

Протоколы и адресация¶

PROTOCOL — Art-Net 4 или sACN (E1.31), до 768 вселенных, общая частота обновления провода (RATE HZ) задаётся на весь проект; AUTO SPAN сам раскладывает приборы по вселенным при адресации.

Карта каналов¶

Вкладка CHANNELS — карта всех каналов лумиверса: сетка 32×16 ячеек на вселенную (512 каналов, заголовок показывает занятость вида «96/512»), номер первого канала каждого ряда слева (1, 33, 65 … 481) не зависит от ширины ячейки. Цвет ячейки — настоящий цвет пикселя прибора (RGB или RGBW через свой порядок цветов, без отдельной арифметики адресации — только через провод), пересечения приборов подсвечены красным; переключатель NUM / % / BAR меняет вид значения в ячейке, HOLD замораживает картинку (провод при этом продолжает идти), живое значение байта в ячейке обновляется не чаще 20 Гц. Инспектор под сеткой показывает под курсором вселенную, канал, прибор, пиксель, функцию канала и значение.

Вкладка CHANNELS: сетка каналов 32×16 на вселенную U0, ряды подписаны слева (1, 33, 65, 97…481), первые
четыре прибора раскрашены по рядам (красный/зелёный, зелёный/фиолетовый, фиолетовый/оливковый), переключатель
NUM активен; справа та же панель DMX LUMIVERSE и FIXTURE; внизу холста — «HOVER A CHANNEL»

У DMX-экрана на холсте доступны только вкладки INPUT SELECTION и CHANNELS — OUTPUT TRANSFORMATION к приборам не применяется, как и варп, бленд и маски. В дереве SCREENS/SLICES у прибора вместо размера показан адрес — «первый–последний · U» (у прибора без каналов — «— · 0 ch»); при переносе слайса с другого экрана на люмиверс и при операциях контекстного меню (Match Input Shape, маска треугольником или кругом) панель сама переключается на страницу CHANNELS.

Тест-паттерны¶

TEST — WHITE (проверка питания и адресации), RGB CYCLE и CHASE (бегущая проверка по приборам), плюс IDENTIFY отдельного прибора — все операционные, в проект не записываются, STOP снимает немедленно.

Производительность¶

Измерено на эмуляции рига 2000 приборов Clenled 270 px (128 000 ячеек, 384 000 каналов, 750 вселенных): 1,06 мс на кадр рендера, 138 Мбит/с трафика Art-Net, четырёхкратный запас у отправителя, 39,7 Гц на проводе при заданных 40.

VOLUMETRIC¶

Экран типа VOLUMETRIC собирает объём из Z-слоёв композиции и отправляет его как набор вселенных Art-Net или sACN — для настоящего LED-объёма (куб, инсталляция из кабинетов) вместо плоского экрана. С 0.8.97 панель VOLUMETRIC — это простая карточка бокса Clen P83: выбрать прибор, число боксов, IP и нажать START.

Карточка P83 (0.8.97)¶

Поводом стало прямое слово заказчика: «по волюметрике вообще не понятно, как работать, все очень сложно, нужно упрощать настройку, сейчас у меня в доступе 2 кабинета». Поэтому панель VOLUMETRIC теперь — одна карточка, а не набор полей куба и мастера. Правки в карточке применяются сразу, кнопки CREATE нет.

FIXTURE — прибор: Clen P83 · 36 px или Clen P83 · 72 px. Прибор задаёт кабинет целиком: 6×6 нитей, платы 2×2, старт, шаг, 144 пикселя на вселенную. Пункт CUSTOM (серый, выбрать нельзя) только показывает, что в экране лежит установка из мастера, которую карточка разложить не может; её BOXES и IP — только для чтения, правка — в ADVANCED → NEW VOLUME.
BOXES X × Z × Y — сколько боксов в ряд, в глубину и этажей. Боксы заполняют сетку по X, затем по Z, затем по Y.
IP — адрес каждого бокса. Пустое поле — правило «первый адрес + номер бокса»; кнопка AUTO +1 возвращает это правило во все поля. Полей показывается не больше 64 (дальше — строка «+ N MORE BOXES NOT LISTED», остальные боксы идут по правилу или со своими прежними адресами).
UNIVERSES — только показ: каждый бокс занимает вселенные подряд (при 36 пикселях это 9 вселенных на бокс: «1–9 · 10–18»); FIRST — первая вселенная буквально на проводе. Серая строка под показом — «wire numbers start at 0» (с 0.8.98; подробнее — ниже, FIND UNIVERSE).
PROTOCOL / PORT — Art-Net (6454) или sACN (5568). sACN на порту 6454 берёт 5568 сам, Art-Net на 5568 — 6454; свой порт оператора карточка не трогает.
CONTENT — FULL DEPTH (умолчание: плоский слой композиции тиражируется на всю глубину установки, число слоёв не нужно считать руками; у бокса P83 36 px сетка клеток 6 × 36 × 6 — глубина Z = 6 слоёв, нить идёт по Y; у двух боксов в ряд — 12 × 36 × 6), ONE LAYER (один слой на плоскости Z PLANE), DEPTH MAP (слой плюс карта глубины). Режим QUILT доступен в ADVANCED — комбо показывает его серой строкой.
TEST — тест-паттерны на проводе: BOX n мигает целиком 1 Гц (остальные боксы тёмные), ALL WHITE зажигает все точки, OFF снимает. Нажата не больше одной кнопки. Паттерн операционный — в проект не пишется, STOP и смена типа экрана его снимают; так «бокс не тот» ловится без правки проекта. Кнопок BOX не больше 64; ALL WHITE покрывает все боксы. Номер кнопки совпадает с «#n» на срезе. Если бокса нажатой кнопки больше нет (BOXES стало меньше, CREATE мастера, Undo), паттерн снимается сам. Второй строкой ряда — FIND UNIVERSE (с 0.8.98; подраздел ниже).
STATUS — «N boxes · P points · U universes»; ошибка патча (например, пересечение каналов) — красным; предупреждение HOST_NOT_ON_NIC — второй строкой, янтарным (START оно не запрещает), и только здесь: в ADVANCED оно не повторяется. Строка состояния выхода (LIVE · WIRE …) — на карточке устройства слева.

Свежий экран. Новый экран VOLUMETRIC — это 1 бокс P83 на 2.0.0.11 с контентом на всю глубину. Раньше START на умолчаниях слал куб 32×16×8 на 127.0.0.1 (так было в отзыве с ноутбука заказчика на 0.8.95). Умолчание создаётся только если установка пуста, а классический куб на умолчаниях структуры; экран с уже настроенным кубом при смене типа не меняется.

Срез. На вкладке INPUT SELECTION срез слоя рисует рамку каждого бокса и подпись «#n · IP» по центру; если рамка уже 48 px (меньше 48) — только «#n». Срез красится тем же буфером, что ушёл на провод, в том числе под тест-паттерном.

Честно. Умолчания профиля P83 взяты из документа производителя; порядок плат на самом боксе не сверен (если картинка перепутана — ADVANCED → NEW VOLUME → BOARD ORDER); данные патча двух боксов заказчика (боксы запатчены MAD-SHOW, IP известны) ещё не получены, поэтому карточка проверена пробами на loopback, а не на двух настоящих боксах. Модули и автопатч по IP — отдельный этап (V1) после полевой проверки карточки.

FIND UNIVERSE: поиск первой вселенной бокса (0.8.98)¶

Поводом стал отзыв заказчика 2026-10-13 с ноутбука (0.8.97, первая сессия с настоящим боксом). В журнале — START DMX 0 Art-Net -> 2.0.0.112 universe 0 (1 fixtures) from 2.0.0.2 [NIC pinned] и START VOLUMETRIC 0 6x36x6 flat -> installation art-net port 6454, 1296 points to 1 receivers on 9 universes, затем семь пар ALL WHITE / OFF и ни одной строки WIRE или dropped. Зажёгся ли бокс — из журнала не видно. Гипотеза: карточка считает вселенные с FIRST 1, а бокс, который MAD-SHOW показывает как «1–9», слушает на проводе Art-Net 0–8; она не доказана — выпуск даёт инструмент, который это покажет, и журнал, где это видно.

Ряд TEST теперь двухстрочный; вторая строка — FIND UNIVERSE:

Впишите IP бокса в карточку и остановите выход (STOP THIS OUTPUT): при живом выходе кнопка недоступна, её подсказка — «STOP the output to scan».
Нажмите FIND UNIVERSE. Программа шлёт белый пакет (510 каналов по 255) прямо на вселенную n на IP бокса 1 карточки — мимо патча, поэтому находится и вселенная 0, которой при FIRST 1 в патче нет. Номер n растёт раз в секунду от 0 до 31 и идёт по кругу (у sACN — от 1 до 32: вселенной 0 у него нет). Уходя со вселенной, программа гасит её чёрным пакетом (все каналы 0): в каждый момент горит одна вселенная, участок бокса вспыхивает на секунду и гаснет. В карточке строка SCANNING UNIVERSE n, в журнале сессии — SCAN UNIVERSE n.
Когда бокс вспыхнул — нажмите STOP SCAN (или ещё раз FIND UNIVERSE). Скан встаёт на удержание HOLD: текущий n продолжает гореть белым, строка — HOLDING UNIVERSE n — ◀ ▶ to find the box, then SET FIRST, под FIND UNIVERSE появляются кнопки ◀, ▶ и SET FIRST = n. Пока вы тянулись к кнопке, номер мог уйти вперёд: кнопками ◀ ▶ (n−1 / n+1 по кругу; прежний номер гаснет чёрным, новый горит белым) добейтесь, чтобы бокс горел на показанном n. При счёте от 0 это первая вселенная бокса.
Нажмите SET FIRST = n — поле FIRST примет удерживаемый n (как при ручном вводе), вселенная погаснет, удержание снимется. Затем START, ALL WHITE.

Выйти из удержания можно повторным нажатием FIND UNIVERSE или кнопкой OFF; скан и удержание останавливают также любая кнопка TEST, START выхода, смена экрана, правка карточки и закрытие программы — всякий раз на текущую вселенную уходит чёрный пакет, и бокс не остаётся белым. Кнопка SET FIRST = n видна только при удержании — после STOP SCAN или повторного нажатия FIND UNIVERSE. Скан — операционная ручка: в проект не пишется. Если боксов больше одного, сканируется бокс 1 — пакеты уходят только на его IP: SET FIRST = n ставит FIRST для всей установки, и первая вселенная бокса 1 становится n.

Известно. Если бокс не вспыхнул ни на одной вселенной 0–31 — проверьте IP бокса (в отзыве — 2.0.0.112) и подсеть ноутбука (в отзыве — 2.0.0.2); строка SCANNING красным («SEND FAILED …») называет код ошибки сети. Чёрный пакет и удержание проверены на тестовом приёмнике, на настоящем боксе — нет.

Подсказка под UNIVERSES. Серая строка «wire numbers start at 0»; её подсказка поясняет: номера на проводе Art-Net начинаются с 0, MAD-SHOW показывает 1–9 для провода 0–8; бокс остаётся тёмным — попробуйте FIRST 0 или FIND UNIVERSE.

Что видно в журнале. Строка START объёма называет приёмники и диапазон вселенных: … 1296 points to 1 receivers (2.0.0.112) on 9 universes (U0–8), а HEARTBEAT несёт vol_sent и vol_dropped (пакеты и сбросы провода объёма). В отзыве, отправленном из SEND FEEDBACK, это теперь есть. Паттерн «одна вселенная» движка (VOLUMETRIC n TEST UNIVERSE u в журнале) красит только точки патча с этой вселенной; для поиска вселенной вне патча служит FIND UNIVERSE.

ADVANCED: мастер NEW VOLUME и классический куб¶

Кнопка ADVANCED… внизу карточки раскрывает прежние элементы: мастер NEW VOLUME, кнопку CLASSIC CUBE (состояние «простой кубоид без установки»), поля VOLUME W×H×D, SLICE LAYER, MODE, THICKNESS, TRANSPORT, HOST / PORT / UNIVERSE и QUILT GRID. Раскрытость запоминается между запусками. Старые проекты загружаются и сохраняются как раньше: установка мастера (в том числе из двух боксов P83 с 0.8.95) остаётся установкой — карточка показывает её, если она раскладывается, иначе — CUSTOM; классический куб остаётся кубом (CLASSIC CUBE нажата, строки установки скрыты). Щелчок CLASSIC CUBE убирает установку и тест-паттерн; второй щелчок возвращает прежнюю установку этого экрана как есть, в том числе CUSTOM мастера (память — на сеанс, в проект не пишется).

Объём строится в одном из трёх режимов: FLAT (плоский срез по Z), DEPTH-MAPPED (2D-слой плюс карта глубины) или QUILT (сеткой из нескольких слоёв-плиток). Превью на холсте — живой куб вокселей, управляется мышью (орбита, зум); в режиме FLAT ползунок ZPLANE выбирает один срез по Z, и превью показывает этот срез вместо целого куба.

Кабинеты, нити и мастер NEW VOLUME¶

Мастер лежит под ADVANCED…. Для настоящего рига — не одного плоского кубоида, а инсталляции из физических кабинетов со своими нитями пикселей — есть отдельный мастер, кнопка NEW VOLUME. Он строит инсталляцию из тех же параметров, что и реальная проводка: сколько пикселей в нити и шаг между ними, сколько нитей в кабинете по каждой стороне, с какого угла и в каком порядке идёт провод, сколько кабинетов по каждой оси и зазор между ними; адресация — сколько пикселей на вселенную, с какой вселенной и с какого хоста начинать отправку, протокол (Art-Net или sACN) и порт.

Установка идёт на провод (0.8.95). Установка из мастера уходит в сеть по IP кабинетов: по 144 пикселя на вселенную, нить не рвётся. Честно: с 0.7.0 по 0.8.94 при непустой установке в провод уходил классический куб из полей W/H/D на один IP — установка хранилась, проверялась и рисовалась на срезе, но не отправлялась; это дефект, закрытый в 0.8.95. Теперь поля W/H/D (под ADVANCED…) при установке показывают сетку клеток и недоступны; срез красится тем же буфером, что ушёл в провод. Если патч невалиден (например, два кабинета делят каналы), START отказывает и не шлёт ни пакета; правка, сделавшая патч невалидным на живом выходе, останавливает выход. Предупреждение HOST_NOT_ON_NIC не блокирует отправку: ни один из локальных адаптеров не в сети приёмников (если локальных сетей не видно, оно молчит). Протокол, порт и приоритет берутся из адресации мастера; sACN с портом 6454 (умолчание Art-Net) уходит на 5568, как у классического куба. Поля HOST, PORT и UNIVERSE классического куба при установке недоступны: адресацию задаёт мастер NEW VOLUME. Если выключены все кабинеты, START отказывает с текстом «all cabinets are disabled — enable at least one».

Пресет P83 и платы. В мастере есть пресет P83 PRESET (6×6 нитей, 36 пикселей, шаг 83 мм, платы 2×2, порядок плат «2 1 3 4», старт TOP-RIGHT, змейка выключена, 144 пикселя на вселенную, первый адрес 2.0.0.11, Art-Net 6454) и поля BOARDS A×B и BOARD ORDER (номера плат через пробел или запятую, с 1). Порядок плат взят из документа производителя и на самом боксе не сверялся — если картинка перепутана, поменяйте порядок полем BOARD ORDER. Несовпадение числа плат с порядком — ошибка BOARDS_MISMATCH.

Строка состояния живого объёма (0.8.96). На экране OUTPUT подпись объёма во время работы выглядит так: LIVE · N frames · VOLUMETRIC · WIRE S sent · D dropped. WIRE — то, что видно по счётчикам отправителя: S кадров ушло в сеть, D потеряно. Если отправка отказала, в конце добавляется первый код ошибки с адресом: · sendto 240.0.0.1:6454: WSAENETUNREACH (10051) (цветом предупреждения); то же сообщение попадает в журнал сессии при первом сбросе, дальше не чаще раза в ~120 кадров. Если D растёт, а кода нет, кадры теряются из-за заполненной очереди отправителя, а не из-за отказа сети. У вывода в FILE части WIRE нет. Что значат коды — страница 16. На узкой панели строка обрезается — полный текст с кодом виден во всплывающей подсказке. После STOP или живой правки адреса счётчики WIRE и код начинаются заново, и строка называет новый адрес. Отправка объёма устроена как у DMX: сокет блокирующий, sendto выполняет рабочий поток (прежний неблокирующий сокет мог терять кадры — тот же урок, что у DMX-отправителя); честно: причину отзыва «0 delivered» на 127.0.0.1 с ноутбука заказчика воспроизвести не удалось, поэтому выпуск 0.8.96 прежде всего называет код ошибки.

Адресация и известное ограничение¶

sACN считает вселенные с 1 на пути через мастер NEW VOLUME: поле FIRST UNIVERSE при выбранном sACN не принимает 0 — значение подтягивается к 1 и при вводе, и при нажатии CREATE; старый проект, у которого это поле сохранялось нулём при sACN, загружается как «авто с 1» с предупреждением в журнал сессии, а не тёмным первым кабинетом.

У поля FIRST UNIVERSE разный смысл на двух путях отправки. На старом пути простого кубоида (панель VOLUMETRIC без мастера) это поле — смещение: номер вселенной на проводе = значение поля + 1 (0 → первая вселенная). На пути «инсталляция» через мастер NEW VOLUME то же поле читается буквально — что ввёл оператор, то и уходит на провод. На умолчаниях оба пути зажигают первый кабинет в одну и ту же вселенную; при ручном вводе одно и то же число в двух полях даёт на проводе разные вселенные. Унификация этого поля — отдельная задача с переносом сохранённых проектов, в этом выпуске её нет.

Как сделать¶

Добавить прибор DMX¶

Нажмите + SCREEN, в карточке экрана переключите тип на DMX LUMIVERSE — экран откроет только вкладки INPUT SELECTION и CHANNELS.
Укажите PROTOCOL (Art-Net или sACN), цель (TARGET), вселенную (UNIVERSE) и частоту (RATE HZ).
В секции FIXTURE выберите профиль прибора (PROFILE) или откройте FIXTURE EDITOR (EDIT…), задайте размер W×H, порядок обхода (SNAKE · LEAD) и порядок цветов (ORDER).
Нажмите + SLICE, чтобы положить прибор на холст — задайте стартовый канал (START CH, кнопка AUTO — автоматически) и проверьте адрес кнопкой IDENTIFY (мигание на проводе).
Перейдите на вкладку CHANNELS, чтобы увидеть карту адресации целиком и проверить пересечения — они подсвечены красным.

Собрать VOLUMETRIC¶

Нажмите + SCREEN, переключите тип на VOLUMETRIC — экран сразу получает 1 бокс P83 на 2.0.0.11 с контентом на всю глубину.
В FIXTURE выберите прибор (Clen P83 · 36 px или 72 px).
В BOXES задайте число боксов X × Z × Y (для двух кабинетов в ряд — 2 × 1 × 1).
Впишите IP каждого бокса (или первый адрес и AUTO +1); при необходимости поправьте FIRST, PROTOCOL и PORT. Строка STATUS должна показывать число боксов, точек и вселенных без красного.
Нажмите START THIS OUTPUT. Проверьте каждый бокс кнопкой TEST → BOX n (мигает 1 Гц), затем ALL WHITE; OFF или STOP снимают паттерн. Бокс остаётся тёмным — остановите выход и найдите его первую вселенную кнопкой FIND UNIVERSE (подраздел выше: STOP SCAN, ◀ ▶, SET FIRST = n) и снова START.

Мастер NEW VOLUME и классический куб — не часть этого пути: они под ADVANCED….

Параметры¶

Параметр	Значения
Протоколы DMX/VOLUMETRIC	Art-Net 4 (UDP) / sACN (E1.31)
Вселенных (DMX)	до 768
Карта каналов	32×16 ячеек на вселенную (512 каналов)
Порядков змейки матрицы	16
Порядок цвета прибора	RGB / GBR / … (настраивается)
Обновление карты каналов	не чаще 20 Гц
Режимы VOLUMETRIC	FLAT / DEPTH-MAPPED / QUILT
Транспорт VOLUMETRIC	Art-Net, sACN, файл (файл — под ADVANCED)
Приборы карточки VOLUMETRIC	Clen P83 · 36 px, Clen P83 · 72 px (CUSTOM — только показ)
Содержимое (CONTENT)	FULL DEPTH / ONE LAYER / DEPTH MAP
Тест-паттерны объёма	BOX n (мигает 1 Гц), ALL WHITE, OFF — в проект не пишутся
Полей IP и кнопок BOX n на карточке	до 64

Ограничения¶

У DMX-экрана на холсте нет вкладки OUTPUT TRANSFORMATION — варп, soft edge blend и маски к приборам не применяются.
У VOLUMETRIC-экрана тоже нет варпа, бленда и масок — геометрия слайса к объёму не применяется.
Поле FIRST UNIVERSE у пути простого кубоида и у мастера NEW VOLUME считается по-разному (смещение против буквального номера на проводе) — унификация не входит в этот выпуск.
Карточка VOLUMETRIC раскладывает только установки из боксов одного прибора P83 (сетка без дырок, все боксы включены, без поворота и своих первых вселенных); остальные показывает как CUSTOM — их правят в ADVANCED → NEW VOLUME.
Тест-паттерн объёма идёт только на установку; у классического куба кнопок TEST нет.
FIND UNIVERSE работает только при остановленном выходе, на карточке из боксов P83 (не CUSTOM, не классический куб), по 32 вселенным (Art-Net 0–31, sACN 1–32) и только на IP бокса 1 (0.8.98). Гипотеза о нумерации с нуля, чёрный пакет и удержание HOLD на настоящем боксе не проверены.
Порядок плат P83 на самом боксе не сверен, данные патча двух боксов заказчика не получены — карточка проверена пробами на loopback; полевая проверка впереди (0.8.97).