Сплайны и одиночные приборы

Любой прибор в проекте Light Stream относится к одному из двух видов: это либо одиночный прибор, либо сплайн — линия, вдоль которой расставлена цепочка приборов. От этого выбора зависит, как приборы адресуются, как их патчить и насколько просто будет менять расстановку потом. Ниже — чем они отличаются, что выбрать под конкретный объект и как превратить одно в другое, если выбор оказался неудачным.

Как рисуются и те и другие — в статье Добавление сплайнов и приборов. Какие бывают типы приборов и сколько у них каналов — в статье Виды и типы приборов.

Коротко о разнице

Одиночный прибор: Самостоятельный объект: своё имя, свой адрес, своя вселенная, свой тип прибора. В окне Приборы занимает отдельную строку, на поле Маппинг выглядит точкой. Двигать, адресовать и патчить его можно независимо от соседей.

Сплайн: Линия с расставленными по ней приборами. Сплайн — это один объект: одно имя, один первый адрес, один тип прибора на все приборы линии. Приборы вдоль линии программа раскладывает сама и сама же назначает им адреса подряд. В окне Приборы сплайн занимает одну строку, сколько бы приборов на нём ни было — хоть 10, хоть 500.

Главное практическое следствие: сплайном управляют целиком, а одиночными приборами — поштучно.

	Одиночные приборы	Сплайн
В окне Приборы	по строке на каждый прибор	одна строка на всю линию
Адрес	задаётся каждому прибору	задаётся первому, остальные считаются автоматически
Патчинг	каждый прибор переносится в порт отдельно	переносится в порт целиком, одним движением
Количество приборов	меняется добавлением и удалением приборов	параметр Количество приборов в свойствах
Расстановка	произвольная: где поставили, там и стоит	вдоль линии, форму которой правят по вершинам
Порядок приборов	задаётся их адресами	задаётся направлением линии, разворачивается кнопкой Реверс
Выделение на поле	можно выделить один прибор	выделяется вся линия целиком
Связь с 3D	с одиночным прибором в окне 3D Просмотр	со сплайном в окне 3D Просмотр

Для эффектов разницы нет: и приборы сплайна, и одиночные приборы получают цвет по своему положению на поле Маппинг. Вид прибора выбирают ради удобства работы с проектом и адресации, а не ради картинки.

Как отличить их на поле Маппинг

Приборы обоих видов рисуются зелёными точками, выделенные — красными.
Приборы сплайна соединяет тёмно-серая линия. Она нужна только для наглядности — свет дают приборы, а не линия. Показ линий включается пунктом меню Просмотр → 2D Маппинг → Показать сплайны и по умолчанию включён.
Первый прибор сплайна обведён белой рамкой. Это начало линии: от него идёт отсчёт адресов, и именно его меняет местами с последним кнопка Реверс.
Если приборы не подписаны, включите нужное в том же меню: Показать номера пикселей, Показать вселенные приборов, Показывать мультиадреса приборов. Пункт Показать пиксельную сетку включает сетку поля — по ней удобно проверять, ровно ли встали приборы.

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

Что выбрать под конкретный объект

Сплайн — когда приборы идут подряд по одной линии и адресуются подряд:

светодиодные ленты, линейки, пиксельные трубки;
гирлянды и нити;
контуры фасада, карнизы, оконные проёмы, перила;
любой длинный ряд одинаковых приборов, подключённых к одному порту.

Одиночные приборы — когда каждый прибор сам по себе:

прожекторы, приборы заливающего света, лучевые приборы;
отдельные точки на объекте, расставленные без общего порядка;
приборы разных типов, стоящие вперемешку;
приборы, которым нужны непоследовательные адреса или разные порты.

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

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

Адресация

Это самое заметное отличие двух видов, и именно из-за него чаще всего приходится переделывать расстановку.

У сплайна

В свойствах задаются Адрес и Вселенная — они относятся к первому прибору линии. Дальше программа считает сама:

шаг между приборами равен числу каналов выбранного типа прибора плюс значение параметра Смещение адреса (по умолчанию 0, то есть адреса идут вплотную);
когда приборы перестают помещаться во вселенную, продолжение сплайна автоматически переходит в следующую; в порту, переключённом в режим SPI, прибор при этом не разрезается — очередной прибор начинается с первого адреса следующей вселенной;
в окне Приборы рядом со сплайном показан занятый диапазон в виде U1-1-300: вселенная, первый и последний адрес.

Любое изменение — количества приборов, типа прибора, смещения адреса, реверс — пересчитывает адресацию всей линии сразу. Приборам внутри сплайна адреса вручную не задаются: это плата за удобство.

У одиночных приборов

Адрес и вселенная задаются каждому прибору отдельно. Чтобы не делать это вручную, приборы ставят с включённым Автопатчингом — тогда каждый следующий прибор получает адрес сразу за предыдущим. Уже расставленным приборам адреса можно пересчитать: правая кнопка мыши по порту в окне Приборы → Пересчитать адреса приборов.

Учтите: значение, введённое в поле Адрес окна Свойства, получают все приборы, выделенные в этот момент в окне Приборы. Если нужно поправить адрес одному прибору, снимите выделение с остальных.

Подробно о патчинге и распределении приборов по портам — в статье Патчинг приборов.

Ошибки адресации

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

Свойства

Часть параметров есть у обоих видов, часть — только у сплайна.

Параметр	Одиночный прибор	Сплайн	Что делает
Имя	есть	есть	Имя в окне Приборы. Понятные имена сильно экономят время при патчинге.
Видимость	есть	есть	Выключенный прибор не отображается на поле и не выделяется мышью; вместе с ним скрывается и связанный объект в 3D Просмотр.
Адрес, Вселенная	есть	есть	У сплайна — адрес и вселенная первого прибора линии.
Тип прибора	есть	есть	Кнопка с названием текущего прибора, открывает Библиотеку приборов. У сплайна тип меняется сразу у всех приборов линии.
Перейти к 3D прибору	есть	есть	Находит и выделяет связанный объект в окне 3D Просмотр.
Тип распространения	—	есть	Равномерное — приборы раскладываются по всей длине линии, а их число задаёте вы. Фиксированные пиксели — прибор ставится в каждую вершину линии, и количество приборов равно числу вершин.
Количество приборов	—	есть	Сколько приборов на линии. Доступно при равномерном распространении.
Смещение адреса	—	есть	Сколько каналов пропускать между соседними приборами линии.
Реверс	—	есть	Разворачивает порядок приборов: первый становится последним.
Сглаживать	—	есть	Скругляет углы линии: вместо ломаной получается плавная кривая.
Привязка к пикселям	—	есть	Ставит приборы линии ровно в клетки пиксельной сетки.

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

Преобразование одного вида в другой

Выбор не окончательный. На панели инструментов окна Маппинг есть две кнопки — Преобразовать в сплайн и Преобразовать в приборы (в более ранних версиях они назывались Связать и Развязать). Обе работают при активном инструменте Выбор и перемещение и обе отменяются по Ctrl+Z. В режиме редактирования сплайна кнопки заблокированы.

Из одиночных приборов в сплайн

Возьмите инструмент Выбор и перемещение и выделите два или более одиночных приборов.
Нажмите Преобразовать в сплайн.

Что получится:

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

Перед преобразованием стоит проверить адреса: если они расставлены не в том порядке, в котором приборы идут на объекте, линия получится путаной. Проще сначала пропатчить приборы по порядку и только потом собирать их в сплайн.

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

Из сплайна в одиночные приборы

Выделите один или несколько сплайнов.
Нажмите Преобразовать в приборы.

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

Преобразование нужно, когда:

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

После преобразования проверьте связь с окном 3D Просмотр: она была создана для сплайна, и новым одиночным приборам её потребуется назначить заново. Об этом — в статье Связь 2D и 3D.

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

Не меняется количество приборов на сплайне. Выбран тип распространения Фиксированные пиксели — в нём число приборов равно числу вершин линии. Переключите на Равномерное или добавьте вершины в режиме редактирования сплайна.
Как выделить один прибор внутри сплайна? Никак: сплайн выделяется, адресуется и перемещается только целиком. Если нужен доступ к отдельным приборам — преобразуйте сплайн в приборы.
Анимация бежит по линии не в ту сторону. У сплайна нажмите Реверс, у одиночных приборов проверьте порядок адресов.
Кнопка «Преобразовать в сплайн» не нажимается. Нужно выделить не меньше двух одиночных приборов и выйти из режима редактирования сплайна.
Строка прибора или сплайна в окне «Приборы» покраснела. Адреса вышли за пределы вселенных порта или наложились на адреса соседей.
Приборы на сплайне стоят не по клеткам. Включите в его свойствах Привязку к пикселям.
Приборов много, и в списке невозможно ничего найти. Соберите однотипные ряды в сплайны: вместо сотен строк в окне Приборы останется по одной на каждую линию, а адреса будут считаться автоматически.