Просмотр кода страницы Сплайны и одиночные приборы

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

== Адресация ==

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

=== У сплайна ===

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

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

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

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

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

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

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

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

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

== Свойства ==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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