Переменные

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

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

Как задать и как прочитать#

> SetUserVariable "Song" 3
> SetGlobalVariable "Venue" "Arena"
> GetUserVariable "Song"
> DeleteUserVariable "Song"
 

В команду переменная подставляется знаком доллара: Goto Cue $Song, Group $MyGroupName At 80. Отсюда Macro вида «перейти на Cue из переменной» — один Macro вместо двадцати. Имена чувствительны к регистру.

Зачем это на площадке#

Macro с вопросом: текст в скобках в строке Macro спрашивает значение у оператора и подставляет ответ, Goto Cue (Cue #). Один Macro «перейти на песню N» вместо кнопки на каждую песню.

Счётчик: переменная, увеличивающаяся на единицу при каждом нажатии, — основа для «следующий номер программы».

Настройка под площадку: значение, от которого зависит поведение Macro — количество Fixture на ферме, номер стартового Universe.

Связь с Plugin: Plugin на Lua читает и пишет те же переменные, поэтому Macro и Plugin обмениваются через них данными.

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

Переменная хранит значение, а логику не хранит. Условия и циклы — это Plugin. Macro с переменными покрывает случай «одно и то же действие с разным числом», и дальше него не идёт.

Порядок отладки#

1. Задать переменную руками из командной строки.
2. Прочитать её и убедиться, что там то, что вы ждёте.
3. Выполнить команду с подстановкой руками.
4. Только потом собрать это в Macro.

Тот же порядок, что и с Macro вообще: сначала работает строка, потом появляется кнопка.