Синтаксис опций команд в grandMA2
На этой странице я постарался собраться информацию из документации, различных статей и форумов в интернете, что-то взял из своего опыта и постарался систематизировать и объединить по смысловым разделам, чтобы очень упростить жизнь при написании макросов.
Ещё обязательно посмотрите справочник ключевых слов в grandMA2.
Как применяются опции (параметры) для команд?
Множество команд внутри МА2 может принимать дополнительные опции, которые
передаются через знак /, например
Assign Effect 15 /wings=2
Назначит во все строки 15-го эффекта два крыла. Название параметра пишется после
знака / без пробела, параметр может иметь значения (как в примере выше), тогда
оно передаётся через знак =, либо может не иметь значения, в таком случае
важен именно сам факт передачи параметра, например
Store Exec 106 /o
/o - это сокращённая запись параметра /overwrite, которая означает, что
необходимо выполнить команду Store с перезаписью всего, что могло быть на 106-м
экзекьюторе.
Теперь вы знаете, как работать с параметрами команд, поэтому далее в подразделах с опциями будут представлены только таблицы с их названиями и описаниями, уже без примеров использования самих параметров.
Работа с эффектами
Установка формы эффекта
Формы эффектов хранятся в отдельном окне пула форм, там можно увидеть все формы, которые есть в пульте, либо добавить свою.
На весь эффект форма назначается командой
Assign Form НОМЕР_ФОРМЫ At Effect НОМЕР_ЭФФЕКТА
На конкретную строку эффекта форма назначается командой
Assign Form НОМЕР_ФОРМЫ At Effect 1.НОМЕР_ЭФФЕКТА.НОМЕР_СТРОКИ
Параметры для команды Assign у эффектов
Можно применять ко всем строкам эффекта
Assign Effect НОМЕР_ЭФФЕКТА /param=value
Либо к конкретной строке эффекта
Assign Effect 1.НОМЕР_ЭФФЕКТА.НОМЕР_СТРОКИ /param=value
x в данном случае — это номер эффекта в пуле, а y — номер строки в эффекте.
| Название параметра | Возможные значения | Описание |
|---|---|---|
/attack | 0..100 | Работает только с формами Random, PWM или Chase |
/blocks | 0..9999, none | Можно использовать =none, это аналогично =0 |
/decay | 0..100 | Работает только с формами Random, PWM или Chase |
/dir | >, >bounce, <, <bounce | |
/groups | 0..9999, none | Можно использовать =none, это аналогично =0 |
/interleave | none, odd или even, “1 of 3” или “2 of 3” или “3 of 3”, “1 of 4” или “2 of 4” или “3 of 4” или “4 of 4” | |
/lowvalue | -9999..9999 | Как указать значение из пресетов описано ниже |
/highvalue | -9999..9999 | Как указать значение из пресетов описано ниже |
/mode | rel/abs | Переключение режима работы между относительным и абсолютным |
/phase | -2879..2879 | Используйте две точки .. для обозначения thru (например, =0..360 установит фазу 0 thru 360) |
/rate | 0..256 | |
/singleshot | yes/no | |
/speed | 0..256 | |
/speedgroup | none или “Speed x” или “Rate y” | |
/width | 0..100 | Не работает с формой Chase |
/wings | -9999..9999, none | Можно использовать =none, это аналогично =0 |
Установка минимального и максимального значения из пресетов
С помощью команды Assign нельзя задать минимальное и максимальное значение из
пресетов, но это можно сделать, когда эффект находится в программаторе,
например, можно выбрать приборы и запустить эффект
Group X at Effect Y
а потом у эффекта внутри программатора задать минимальное и максимальное значение из пресетов:
At Preset 2."X OPEN" /layer=effectlow
At Preset 2."X CLOSE" /layer=effecthigh
После этого можно обновить эффект
Store Effect Y /o /nc
Добавление/изменение строк эффекта
К эффекту можно добавить строчку, или изменить существующую. Для этого нужно назначить атрибут на номер строки в эффекте:
Assign Attribute "dim" Effect 1.НОМЕР_ЭФФЕКТА.НОМЕР_СТРОКИ
например Effect 1."WASH DIM SIN".1
Опции команды Assign для экзекьюторов
| Название параметра | Возможные значения | Описание |
|---|---|---|
/autofix | on/off | |
/autostart | on/off | |
/autostomp | on/off | |
/autostop | on/off | |
/chaser | on/off | |
/crossfade | on/off | |
/cmddisable | on/off | |
/effectspeed | on/off | |
/ignoreexectime | on/off | |
/killprotect | on/off | |
/mastergo | off/on/go/top | |
/mibalways | on/off | |
/mibnever | on/off | |
/offtime | z | |
/ooo | on/off | Параметр Off On Overwriten |
/playbackmaster | 0..50 | |
/prepos | on/off | |
/priority | low (или 6), normal (или 5), high (или 4), htp (или 3), swap (или 2), super (или 0) | |
/ratemaster | 0..16 | |
/restart | first, current, next | |
/softltp | on/off | |
/speed | mul2/mul4/mul8/mul16/mul32, normal, div2/div4/div8/div16/div32 | |
/speedmaster | 0..16 | |
/swopprotect | on/off | |
/triggerisgo | on/off | |
/width | 1..5 | |
/wrap | on/off |
Опции команды Assign для секвенций
| Название параметра | Возможные значения | Описание |
|---|---|---|
/cuezero | off, on, “dimmers only”, all, effects | Off — выключить Cue Zero; on — включить Cue Zero для всех атрибутов; “dimmers only” — включить Cue Zero для диммера; all — включить Cue Zero для всех атрибутов; effects — включить Cue Zero и добавить стомп ко всем атрибутам |
/cuezeroextract | on/off | Сохраняет текущие значения по умолчанию в Cue Zero для защиты от последующих изменений значений по умолчанию |
/forcedpos.mode | pt/xyz/none | |
/info | “text” | |
/name | “text” | |
/releasefirststep | on/off | |
/track | on/off | Трекинг в секвенции |
Опции команды Assign для Cue
| Название параметра | Возможные значения | Описание |
|---|---|---|
/ae | on/off | Перезапускать эффекты при старте cue |
/cmd | “command ; command ; etc.” | |
/forcedpos.mode | pt/xyz/none | |
/info | “text” | |
/lcount | 0+ или infinite | Количество повторений |
/loop | [номер cue из секвенции] или none | |
/ltime | 0+ или infinite | |
/mib | none/early/late/[cue#] | |
/mode | normal/break/x-break/assert/x-assert/release | |
/name | “text” | |
/trig | go/time/follow/sound/bpm/smpte/midi | |
/trigtime | y | |
/delay_<preset type> | y | |
/fade_<preset type> | y |
Опции команды Store для Cue
| Название параметра | Возможные значения | Описание |
|---|---|---|
/add /a | ||
/cueonly /co | true/false | |
/release /rel | ||
/status | ||
/statusmerge /sm | ||
/trackingshield /ts |
Опции команды Assign для таймкода
| Название параметра | Возможные значения | Описание |
|---|---|---|
/autostart | on/off | |
/info | “text” | |
/length | y | Установка продолжительности таймкода в формате 1h2m3.45s или 1:2:3.45 |
/name | “text” | |
/offset | y | Смещение в формате 1h2m3.45s или 1:2:3.45 |
/runs | Количество циклов воспроизведения (только для внутренних часов), для бесконечности использовать значение 0 | |
/slot | “intern” (или -1), “link selected” (или 0), 1..8 | |
/statuscall | on/off | |
/switchoff | “playbacks off”, “keep playbacks” | |
/timeunit | “1/100 sec”, “30 fps”, “25 fps”, “24 fps” | |
/whenending | stop или pause | Что произойдет при завершении времени (только для внутренних часов) |
/whenstopping | “do nothing”, rewind |
Опции команды Appearance
| Название параметра | Возможные значения | Описание |
|---|---|---|
/blue /b | 0..100 | |
/brightness /br | 0..100 | |
/green /g | 0..100 | |
/hue /h | 0..360 | |
/red /r | 0..100 | |
/reset | ||
/saturation /s | 0..100 |
Базовые опции команды Store
| Название параметра | Возможные значения | Описание |
|---|---|---|
/effects /ef | true/false | |
/keepactive /ka | true/false | |
/merge /m | ||
/noconfirm /nc | ||
/overwrite /o | ||
/remove /r | ||
/source /so | prog, output, “DMX in” | |
/useselection /use | active, allforselected, activeforselected, all, look | |
/values /v | true/false | |
/valuetimes /vt | true/false |
Опции команды Store для пресетов
| Название параметра | Возможные значения | Описание |
|---|---|---|
/auto | ||
/embedded /e | true/false | |
/global /g | ||
/presetfilter /pf | true/false | |
/selective /s | ||
/universal /u |
Опции команды Store для View
| Название параметра | Возможные значения | Описание |
|---|---|---|
/screen | 1..6 |
Опции команды Store для Layout
| Название параметра | Возможные значения | Описание |
|---|---|---|
/x | -10000..10000 | |
/y | -10000..10000 |
Опции настроек консоли
Глобальные настройки:
Assign Root 3.1 (или Root "Settings"."Global") ТУТ_ДОП_ОПЦИИ
| Название параметра | Возможные значения | Описание |
|---|---|---|
/Agenda | Running/Stopped | |
/Wysiwyg | On/Off | |
/ForceLogin | On/Off | |
/EnableRDM | On/Off | |
/Remotes | “Login Disabled” / “Login Enabled” | |
/Telnet | “Login Disabled” / “Login Enabled” | |
/SelectedTimecodeSlot | 1..8 |
Локальные настройки:
Assign Root 3.2 (или Root "Settings"."Local") ТУТ_ДОП_ОПЦИИ
| Название параметра | Возможные значения | Описание |
|---|---|---|
/DefaultLanguage | English/German | |
/NetworkDMXifAlone | On/Off | |
/ShowReleaseNotesonStart | On/Off | |
/FlashingerrorLED,onwrongFaderposition | On/Off | |
/ExecCLI | On/Off | |
/DefaultGo,Goback,PauseCLI | On/Off | |
/IntensityBtnBackground | 0..79 | |
/IntensityBtnHighlight | 0..255 | |
/IntensityExecLED | 0..255 | |
/IntensityDeskLamp | 0..255 | |
/Intensity9Inch | 0..255 | |
/Intensity15Inch | 91..255 | |
/DesklockBackground | “Black” / “Image Pool Picture” / “Current Desk UI” |
Настройки шоу:
Assign Root 3.3 (или Root "Settings"."Show") ТУТ_ДОП_ОПЦИИ
| Название параметра | Возможные значения | Описание |
|---|---|---|
/Off | 0s..23h59m59s | |
/GoBack | “cuetiming” или 0s..23h59m59s | |
/Goto | “cuetiming” или 0s..23h59m59s | |
/GoFast | 0s..23h59m59s | |
/MIBDelay | 0s..23h59m59s | |
/MIBFade | 0s..23h59m59s | |
/Startup | “команды, выполняемые после загрузки шоу” | |
/XfadeReload | On/Off | |
/TimecodeRecordSingleUser | On/Off | |
/KillwithOffTime | On/Off |
Опции для настроек сетевых протоколов
Art-Net
Assign Root 4.1 (или Root "DMX_Protocols"."Art-Net") /OutActive=on/off /InActive=on/off
Assign Root 4.1.x (или Root "DMX_Protocols"."Art-Net".x) /опции
x в данном случае — номер строки в таблице Art-Net.
| Название параметра | Возможные значения | Описание |
|---|---|---|
/Requested | yes/no | |
/Mode | Input/OutputAuto/OutputBroadcast/OutputUnicast | |
/DestinationIP | “IP адрес” | Изменение этого параметра командой НЕ РАБОТАЕТ! |
/LocalStart | 1..256 | |
/Amount | 1..256 | |
/Network | 1..128 | |
/Subnet | 0..F | |
/Universe | 0..F | |
/Delay(ms) | 0..5 | |
/Info | “любой текст, например о расположении артгейта” |
sACN
Assign Root 4.4 (или Root "DMX_Protocols"."sACN") /OutActive=on/off /InActive=on/off
Assign Root 4.4.x (или Root "DMX_Protocols"."sACN".x) /опции
x в данном случае — номер строки в таблице sACN.
| Название параметра | Возможные значения | Описание |
|---|---|---|
/Requested | yes/no | |
/Mode | InputMulticast/InputUnicast/OutputMulticast/OutputUnicast | |
/DestinationIP | “IP адрес” | Изменение этого параметра командой НЕ РАБОТАЕТ! |
/LocalStart | 1..256 | |
/Amount | 1..256 | |
/sACNUniverse | 1..64000 | |
/Priority | 0..200 | |
/Protocol | Draft/Final | |
/TTL | 0..255 | |
/Delay(ms) | 0..5 | |
/Info | “любой текст” |