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

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

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

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

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

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

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

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

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

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

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

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

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

Каналы

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Снятая галочка убирает пределы поворота из описания. Если включить её обратно, значения Pan и Tilt стоит проверить заново.

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

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

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

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

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

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

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

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

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

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

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

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

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