|
grandMA3 User Manual » Command Syntax and Keywords » General Keywords » Preset
|
Version 2.1
|
To enter the Preset keyword in the command line, use one of the options:
- Press Preset
- Type Preset
- Type the shortcut Pres
Description
With the Preset keyword, it is possible to:
- Select the fixtures stored in a preset;
- Apply the At function on the preset within the fixture or channel selection;
- Set a property in a preset.
A command containing only the Preset keyword and the preset ID performs the default function SelectFixtures. For more information see SelectFixtures keyword.
To give the fixture attributes a link to the preset, the At keyword needs to be added in front of the Preset keyword and the preset ID. For more information see At Keyword.
Syntax
Preset ["FeatureGroup_Name" or FeatureGroup_Number].["Preset_Name" or Preset_Number]
[Function] Preset ["FeatureGroup_Name" or FeatureGroup_Number].["Preset_Name" or Preset_Number] ([Setting] ["Setting_Value"] [/OptionKeyword])
Assign [Object] ["Object_Name" or Object_Number] At Preset ["FeatureGroup_Name" or FeatureGroup_Number].["Preset_Name" or Preset_Number]
Settings
Some settings need an object assigned. These can be assigned using the Assign Keyword.
Other settings contain a text option or a value. The Set keyword is used for these settings.
The following table displays the settings that need an object:
| Setting | Object | Description |
|---|---|---|
| Appearance | "Appearance 1" | Assigns the appearance to the pool object. |
| InputFilter | "Filter 12" | Assigns a filter or world as an input filter to the pool object. |
| Scribble | "Scribble 1" | Assigns the scribble to the preset pool object. |
The following table displays the settings that need an option or value:
| Setting | Option/Value | Description |
|---|---|---|
| Name | "Preset Name" | Sets the name of the preset pool object. |
| MoveGridCursor | "Yes" or "No" | This defines if the grid cursor is moved after calling the preset. |
| CuePart | "Default" or a specific part number | This is the programmer cue part the preset will be called into. |
| MAgic | "Yes" or "No" | This defines if the preset is a magic preset or not. |
| PresetMode | Read only | This is information only about the preset mode. |
| StoredData | Read only | This is information only about the stored data. |
Presets can also contain settings for MAtricks and recipe values. These can be changed using the Set keyword.
Option Keywords
The Preset keyword uses the following option keywords:
- /Active
- /ActiveForSelected
- /AddNewContent
- /All
- /AllForSelected
- /Ask
- /Auto
- /DMX
- /Embed
- /ForceGlobal
- /Global
- /GridMergeMode
- /InputFilter
- /KeepActivation
- /Look
- /MAtricks
- /Output
- /Overwrite
- /PhaserData
- /Programmer
- /Selective
- /Universal
Examples
- To select the fixtures that can use preset 5 of the dimmer feature group, type:
|
User name[Fixture]>SelFix Preset 1.5 |
- To select the fixtures stored in any preset with the name "DarkRed", type:
|
|
User name[Fixture]>SelFix Preset *."DarkRed" |
- To call a reference to preset 21.45 ("All 1" preset number 45) to the attributes of the selected fixtures, type:
|
|
User name[Fixture]>At Preset 21.45 |
- To set the name of the position preset 3 to be "Stage Left", type:
|
|
User name[Fixture]>Set Preset 2.3 Name "Stage Left" |
- To assign world 5 as an input filter on position preset 4, type:
|
|
User name[Fixture]>Assign World 5 At Preset 2.4 |