Создание пользовательских приборов

Создание пользовательских приборов — это описание в программе прибора, которого нет в готовых разделах Библиотеки приборов, или прибора, работающего не в том DMX-режиме, что заводское описание. По сути своё описание — это перенесённая в программу таблица каналов из паспорта прибора: сколько каналов прибор занимает, что означает каждый из них и как прибор светит в окне 3D Просмотр.

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

Когда нужно своё описание

Нужной модели нет ни в разделе LED Приборы, ни в разделе Производители.
Модель в библиотеке есть, но на самом приборе выставлен другой DMX-режим — с другим количеством каналов или другим их порядком.
У прибора нестандартный порядок цветов, и с заводским описанием он светит не тем цветом.
Часть каналов прибора программа трогать не должна.
Готовое описание подходит по каналам, но прибор должен светить в 3D иначе — другим типом луча или другого размера.

Для обычной пиксельной ленты, линейки или гирлянды своё описание не нужно: подойдёт стандартный прибор из раздела LED Приборы (см. Виды и типы приборов).

Что выяснить заранее

Описание собирается по паспорту прибора, поэтому до начала работы стоит знать:

какой DMX-режим выставлен на самом приборе — у одной модели их обычно несколько;
сколько каналов занимает этот режим;
что делает каждый канал по порядку, начиная с первого;
для вращающихся приборов — пределы поворота Pan и Tilt в градусах.

Если режим на приборе потом изменится, описание придётся переделать: программа считает каналы ровно так, как записано в описании.

Создание прибора с нуля

Откройте Настройки → Библиотека приборов.
Выберите Создать → Прибор. В разделе Мои приборы появится заготовка с названием RGB: три канала — красный, зелёный, синий — и вид Пиксель. Заготовка сразу выделяется, и справа открывается её описание, все поля доступны для правки.
Задайте название в поле в самом верху правой панели. Имя видно в дереве библиотеки и в свойствах приборов, поэтому лучше писать так, чтобы угадывались и модель, и режим: например, Модель 12ch.
В блоке 3D Превью выберите Тип луча светильника и размеры луча.
Ниже, в блоке Настройки DMX, задайте Количество каналов — столько, сколько занимает выбранный DMX-режим.
В таблице каналов задайте назначение каждого канала: щёлкните по строке и выберите значение из списка.
Выполните Файл → Сохранить библиотеку. Пока библиотека не сохранена, прибор существует только в открытом окне.

Теперь прибор можно назначать: выделите приборы на маппинге и нажмите Выбрать прибор в правом нижнем углу окна библиотеки — подробно об этом в статье Библиотека приборов.

Каналы

Таблица каналов — главная часть описания. Номер в столбце # — это смещение канала от адреса прибора: первая строка уходит по адресу прибора, вторая — по следующему адресу и так далее. Поэтому порядок строк должен точно повторять порядок каналов в паспорте.

Что можно выбрать в списке назначений:

Назначение	Что программа отправляет в канал
red, green, blue	Красную, зелёную и синюю составляющие цвета из точки прибора на поле Маппинг
white min, white average	Белую составляющую: наименьшую или среднюю из трёх составляющих цвета
red-min(rgb), green-min(rgb), blue-min(rgb)	Цветную составляющую за вычетом белой. Ставится вместе с белым каналом у приборов, где белый светодиод заменяет собой серую часть цвета
pan, tilt и точные panfine, tiltfine	Углы поворота вращающегося прибора
strob, shuttern, gobo, focus, zoom, frost, movementspeed, reset	Служебные каналы «умных» приборов. Сама по себе программа их не меняет — значение задают эффекты Установить значения каналов и Анимация каналов
other, other 1…other 10	Каналы, назначение которых в описании не расшифровано: диммер, макросы, выбор цветового колеса и прочее
color white 5 bit	Особый белый канал отдельных моделей. В обычных описаниях не используется
Empty	Канал, который прибор занимает, но программа в него ничего не пишет

Несколько правил, о которые проще всего споткнуться:

Одно назначение — один канал. Если в описании два канала помечены одинаково (например, два red), данные получит только последний из них. Поэтому у всех каналов, которыми вы собираетесь управлять, назначения должны быть разными — для этого и сделаны other 1…other 10.
Лишние каналы нельзя пропускать. Если прибор в своём режиме занимает 12 каналов, а нужны только первые три, всё равно поставьте 12 каналов, а остальные пометьте как Empty — его можно ставить хоть всем строкам подряд, программа в такие каналы ничего не пишет. Иначе следующий прибор в порту встанет по чужому адресу.
Увеличение количества каналов копирует последний канал. Добавленные строки повторяют назначение последней, и их нужно переназначить — иначе получатся те самые одинаковые каналы.
Уменьшение количества каналов убирает строки с конца, но их значения запоминаются: если тут же вернуть прежнее число, назначения восстановятся такими, какими были.

Значения цветных и белых каналов программа считает сама, кадр за кадром. Остальные каналы держат ноль, пока их не задаст эффект. Подробнее о том, что означают каналы и как из них складываются адреса и вселенные, — Виды и типы приборов.

Настройки 3D Превью

Блок 3D Превью отвечает только за то, как прибор выглядит и светит в окне 3D Просмотр. На DMX-данные он не влияет, но от него зависит, насколько предпросмотр похож на реальный объект.

Тип луча светильника	Как светит	Поля размеров	Значения по умолчанию
Пиксель	Светится сам, как точка; луча нет	Размеров луча нет — размеры самой точки задаются у прибора в 3D-сцене	—
Линейный	Заливает поверхность широким лучом вдоль корпуса	Длина, Угол°, Глубина	100, 30, 600
Прожектор	Даёт направленный конус света	Угол°, Высота	30, 500

Набор полей меняется сразу при смене типа луча, лишние поля скрываются. Угол° — раскрытие луча, Глубина и Высота — как далеко луч добивает, Длина — длина светящейся части корпуса.

Эти размеры — заготовка для новых приборов. У прибора, который уже стоит в 3D-сцене, луч настраивается отдельно, в его свойствах (см. Виды и типы приборов).

Изображение прибора

Рядом с полями 3D Превью показана картинка прибора — она же выводится маленькой иконкой слева от названия в дереве библиотеки. У своего прибора её можно заменить: нажмите ссылку Изменить изображение и выберите файл JPG, BMP, GIF или PNG.

Изображение не встраивается в библиотеку — запоминается путь к файлу. Диалог выбора сразу открывает папку программы с изображениями приборов: если положить картинку туда и не удалять её, изображение останется на месте и после перезапуска. Если файл потом переместить или удалить, картинка просто перестанет отображаться — на работу прибора это не влияет.

Вращающиеся приборы

Для приборов с механикой поворота есть отдельная заготовка: Создать → Вращающаяся голова. Она создаётся с названием Move head, четырьмя каналами поворота — pan, panfine, tilt, tiltfine — и уже включённой галочкой Вращающ. прибор с пределами Pan 0–540° и Tilt 0–180°. Заготовка добавляется в конец раздела Мои приборы: найдите её и выделите, чтобы настроить.

Дальше описание собирается так же, как обычное: количество каналов доводится до числа каналов режима, каналы расставляются по паспорту. Если у прибора нет точных каналов поворота, строки panfine и tiltfine переназначаются или убираются.

Галочку Вращающ. прибор можно поставить и у обычного прибора — тогда откроются поля Pan, мин / макс и Tilt, мин / макс. Впишите в них полный диапазон поворота прибора в градусах из паспорта: по ним эффект Анимация PAN TILT пересчитывает заданный угол в значение канала. Если диапазон указан неверно, прибор будет доворачивать не туда, куда показывает эффект.

Снятая галочка убирает пределы поворота из описания. Если поставить её обратно, в полях окажутся те же значения, что были до снятия, а у прибора, который вращающимся раньше не был, — 0–540° и 0–180°.

Прибор на основе заводского

Когда нужное описание почти совпадает с готовым, быстрее не собирать его с нуля, а скопировать. Выделите прибор в любом разделе и нажмите Копировать в личные — копия появится в разделе Мои приборы с добавкой Copy в названии, сразу выделится, и её уже можно править.

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

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

Сохранение и применение

Всё, что сделано в окне библиотеки, сначала существует только в нём. Закрепляет изменения Файл → Сохранить библиотеку. Программа и сама напомнит о сохранении: при закрытии окна с несохранёнными правками спросит Сохранить библиотеку? — ответ Нет вернёт библиотеку к тому виду, в каком она была при открытии окна. При нажатии Выбрать прибор программа тоже предложит сохранить библиотеку перед выбором.

При сохранении новое описание применяется ко всем приборам проекта, которым этот прибор уже назначен. Что это значит на практике:

если изменилось количество каналов, приборы займут другое количество адресов, а вот адреса соседних приборов в порту останутся прежними — получится наложение или разрыв. Пересчитать адреса можно по правой кнопке мыши на порту, пункт Пересчитать адреса приборов, или задать их вручную — см. Патчинг приборов;
если изменились назначения каналов, поменяется и картина на реальном объекте — цвета встанут по-новому;
параметры луча у приборов в 3D-сцене берутся из описания заново. Если вы настраивали луч у отдельных приборов в окне 3D Просмотр, эти настройки вернутся к тому, что записано в приборе библиотеки.

Удалить свой прибор можно только из раздела Мои приборы: выделите его и нажмите Delete или Backspace либо выберите Удалить по правой кнопке мыши. Программа попросит подтвердить удаление. Проекты, где прибор уже назначен, от удаления не пострадают: его описание хранится и внутри самого проекта.

Как проверить описание

Назначьте новый прибор одному прибору на маппинге и пропатчите его в порт устройства. В окне Приборы посмотрите в столбце Address адрес следующего прибора: разница должна быть равна количеству каналов.
Поставьте в композицию простую однотонную заливку и включите Art-Net. Если вместо красного прибор светит зелёным или синим — перепутан порядок цветных каналов.
Служебные каналы проверяются эффектом Установить значения каналов: он показывает каналы выбранных приборов по названиям, каждый канал включается кнопкой On, а значение выставляется ползунком — и сразу видно, что делает реальный прибор.
Поворот проверяется эффектом Анимация PAN TILT: задайте крайние углы и сравните с тем, куда прибор поворачивается на самом деле.

Частые вопросы

Поля справа серые, ничего не изменить. Выбран прибор из защищённого раздела. Править можно только то, что лежит в Мои приборы: скопируйте прибор туда кнопкой Копировать в личные.
После перезапуска программы прибор пропал. Библиотека не была сохранена. Изменения закрепляет только Файл → Сохранить библиотеку или ответ Да на вопрос при закрытии окна.
Один из каналов не реагирует. Скорее всего, это же назначение стоит и у другой строки таблицы. Из двух каналов с одинаковым назначением работает только последний.
Сам прибор светит правильно, а соседние — нет. Количество каналов в описании не совпадает с реальным DMX-режимом, и все следующие приборы в порту смещаются. Сверьте количество каналов с паспортом и пересчитайте адреса — по правой кнопке мыши на порту, Пересчитать адреса приборов.
Изменил описание, а в проекте ничего не поменялось. Изменения применяются в момент сохранения библиотеки. Если и после сохранения ничего не изменилось — приборам проекта назначено другое описание, например оригинал, а не копия; назначьте нужный прибор кнопкой Выбрать прибор.
Как сделать несколько режимов одной модели. Отдельным описанием на каждый режим: скопируйте готовое и поправьте количество и назначения каналов. Названия удобно давать с номером режима, чтобы не путать их при выборе.
Прибор нужен на другом компьютере. Библиотека вместе с проектом не переносится, но описание используемого прибора хранится в файле проекта: откройте проект на другом компьютере, найдите прибор в разделе Используются в проекте и нажмите Копировать в личные — он попадёт в Мои приборы этого компьютера.