• grandMA3 User Manual
    • About the manual
    • Device Overview
      • grandMA3 consoles
        • grandMA3 full-size
        • grandMA3 full-size CRV
        • grandMA3 light
        • grandMA3 light CRV
        • grandMA3 compact XT
        • grandMA3 compact
      • grandMA3 extension
      • grandMA3 replay unit
      • grandMA3 processing units
      • grandMA3 Nodes
      • grandMA3 Nodes DIN-Rail
      • grandMA3 I/O Node
      • grandMA3 I/O Node DIN-Rail
      • grandMA3 onPC command wing XT
      • grandMA3 onPC command wing
      • grandMA3 onPC fader wing
      • grandMA3 onPC rack-unit
      • Screen allocation
      • Keyboard shortcuts
      • Keys
        • . [Dot]
        • <<< [GoFastBackward] | Black
        • >>> [GoFastForward] | Flash
        • - [Minus]
        • + [Plus]
        • / [Slash] | * [Asterisk/Multiply]
        • At
        • Assign
        • Align
        • Blind
        • Clear
        • Channel
        • Copy
        • Ctrl
        • Cue
        • Down
        • Delete
        • Esc
        • Edit
        • Freeze
        • Full
        • Fixture
        • Group
        • Goto
        • Go+ [large]
        • Go- [large]
        • Go+ | Temp
        • Go- | Top
        • Help
        • Highlt [Highlight]
        • If
        • Learn | Rate1
        • List
        • MA
        • Menu
        • Move
        • Next
        • Numeric keys | arrows
        • Oops
        • On
        • Off
        • Pause [large]
        • Pause | Fix
        • Page+
        • Page-
        • Please
        • Power
        • Preset
        • Prvw [Preview]
        • Prev [Previous]
        • Select
        • SelFix [SelectFixture]
        • Sequ [Sequence]
        • Set
        • Solo
        • Stomp
        • Store
        • Thru
        • Time
        • Up
        • Update
        • U1
        • U2
        • X1 | Clone
        • X2 | Link
        • X3 | Grid
        • X4 | Layout
        • X5 | Step
        • X6 | TC
        • X7 | View
        • X8 | DMX
        • X9
        • X10
        • X11
        • X12
        • X13 | Phaser
        • X14 | Macro
        • X15 | Page
        • X16 | Exec
        • Xkeys
      • Control elements
        • Command area
        • Master area
        • Custom area
        • Dual encoders
        • Level wheel
        • Grand master
        • Executor elements
      • Connector pin assignment
      • UPS battery
    • System Overview
      • Standalone device
      • Locally networked devices
      • World server
      • Parameters
        • Calculate parameters
        • Expand the amount of parameters
    • First Steps
      • Unpack the device
      • Check scope of delivery
      • Position the device
      • Connect power
      • Connect desk light
      • Connect external screens
      • Connect USB devices
      • Connect DMX
      • Connect Audio In
      • Connect MIDI
      • Connect LTC
      • Connect Ethernet
      • Connect DC Remote In
      • Connect grandMA3 extension
      • Connect grandMA3 fader wing
      • Turn on the device the first time
    • grandMA3 onPC
      • System requirements grandMA3 onPC
      • Windows installation
      • Optimize Windows
      • macOS installation
      • Optimize macOS
      • onPC Terminal App
      • onPC settings
    • Show File Handling
    • Workspace
      • User interface
        • Configuration of displays
        • Desk lock
        • User-defined area
        • Command line
        • Control bar
        • View bar
        • Tables in general
        • Trackpad window
      • Gestures
      • Command area
      • Master controls
      • Playback controls
      • Displays in grandMA3 onPC
      • Encoder bar
        • Feature group control bar
        • Encoder toolbar
      • Calculator
      • Playback bar
      • Command wing bar
      • Colors
        • System
        • Markers
        • Color theme
    • Command Syntax and Keywords
      • General syntax rules
      • General keywords
        • ; [Semicolon]
        • / [Slash]
        • . [Dot]
        • .. [DotDot]
        • = [Equal]
        • <<< [GoFastBackward]
        • >>> [GoFastForward]
        • - [Minus]
        • * [Asterisk]
        • % [Percent]
        • + [Plus]
        • Absolute
        • Acceleration
        • Action
        • ActivationGroup
        • Agenda
        • Align
        • AlignTransition
        • Appearance
        • Assign
        • At
        • Attribute
        • AutoCreate
        • Black
        • Blind
        • Block
        • BPM
        • Call
        • Camera
        • Capture
        • ChangeDestination
        • Channel
        • ChannelSet
        • Chat
        • ChatJoin
        • ChatLeave
        • Cleanup
        • Clear
        • ClearActive
        • ClearAll
        • ClearSelection
        • Clone
        • CommandDelay
        • Collect
        • Collection
        • Color
        • ColorDef
        • ColorTheme
        • Configuration
        • Console
        • Cook
        • Copy
        • Cue
        • CueAbs
        • CueDelay
        • CueFade
        • CueInDelay
        • CueInFade
        • CueOutDelay
        • CueOutFade
        • CueRel
        • CueUpdate
        • CurrentEnvironment
        • CurrentUser
        • CurrentUserProfile
        • Cut
        • DataPool
        • Deceleration
        • Decimal8
        • Decimal16
        • Decimal24
        • Default
        • Delay
        • Delete
        • DeleteOtherVersions
        • DelGlobalVar
        • DelUserVar
        • Dismiss
        • Display
        • DMXLayer
        • DMXAddress
        • DMXReadout
        • DMXUniverse
        • DoubleSpeed
        • Down
        • DumpLog
        • Drive
        • Echo
        • Edit
        • EditSetting
        • Eject
        • Effect
        • EndIf
        • Environment
        • Exchange
        • Executor
        • Export
        • Extract
        • Extension
        • Fade
        • Fader
        • FaderMaster
        • FaderRate
        • FaderSpeed
        • FaderTemp
        • FaderTime
        • FaderX
        • FaderXA
        • FaderXB
        • FeatureGroup
        • Filter
        • Fix
        • FixtureClass
        • FixtureLayer
        • Fixture
        • FixtureType
        • Flip
        • Flash
        • Fog
        • Font
        • Freeze
        • Full
        • Gel
        • GetGlobalVar
        • GetUserVar
        • Go+
        • Go-
        • Goto
        • Grid
        • GridPos
        • Group
        • HalfSpeed
        • HardwareKey
        • Help
        • Helplua
        • Hex8
        • Hex16
        • Hex24
        • Highlight
        • Houselights
        • Hz
        • If
        • IfActive
        • IfOutput
        • IfProg
        • Image
        • Import
        • Index
        • Insert
        • Integrate
        • Interface
        • Invert
        • Invite
        • IP
        • JoinSession
        • Key
        • Keyboard
        • KeyboardShortcuts
        • Knockin
        • Knockout
        • Label
        • Language
        • Layout
        • LearnSpeed
        • LeaveSession
        • Library
        • List
        • ListOwner
        • ListRef
        • Load
        • Loaded
        • LoadShow
        • Lock
        • Login
        • Logout
        • Lowlight
        • Lua
        • LuaFile
        • Macro
        • MArker
        • Master
        • MAtricks
        • Measure
        • Media
        • MemInfo
        • Menu
        • Mesh
        • MessageCenter
        • Monitor
        • Move
        • Multipatch
        • MyRunningMacro
        • MyRunningPreset
        • MyRunningSequence
        • Natural
        • NDI
        • NewShow
        • NextY
        • NextZ
        • Next
        • Node
        • NonDim
        • Normal
        • Off
        • Offset
        • On
        • onPC
        • OSC
        • Oops
        • OutputLayer
        • Page
        • Part
        • Park
        • Paste
        • Patch
        • Pause
        • Percent
        • PercentFine
        • Phase
        • Physical
        • Plugin
        • Preset
        • PresetUpdate
        • Press
        • Preview
        • PreviousY
        • PreviousZ
        • Previous
        • Programmer
        • Property
        • PU
        • Pyro
        • Rate1
        • RDM
        • Readout
        • Reboot
        • Recast
        • Record
        • Relation
        • Relative
        • Release
        • ReloadPlugins
        • ReloadUI
        • Remote
        • RemoteHID
        • RemoteCommand
        • Remove
        • RenderQuality
        • Reset
        • Restart
        • Root
        • RTChannel
        • RunningMacro
        • RunningPreset
        • RunningSequence
        • RunningTimecode
        • SaveShow
        • ScreenConfig
        • ScreenContent
        • Scribble
        • Seconds
        • Select
        • Selection
        • SelFix
        • Sequence
        • SendMIDI
        • SendOSC
        • Set
        • SetGlobalVar
        • SetUserVar
        • Shuffle
        • Shutdown
        • SnapDelay
        • SoftwareImport
        • SoftwareUpdate
        • SoundChannel
        • Solo
        • SpecialExecutor
        • Speed
        • Speed1
        • Stage
        • Station
        • Step
        • Stomp
        • SwitchGma2Mode
        • Swop
        • Store
        • Temp
        • Texture
        • Thru
        • Time
        • Timecode
        • TimecodeSlot
        • Toggle
        • TopUp
        • Top
        • Transition
        • Type
        • UIChannel
        • UIGridSelection
        • UnBlock
        • Universal
        • UnLock
        • UnPark
        • UnPress
        • Up
        • Update
        • UpdateContent
        • User1
        • User2
        • User
        • UserProfile
        • Video
        • Version
        • View
        • ViewButton
        • Width
        • World
        • Xkeys
        • Zero
      • Option keywords
        • /Active
        • /ActiveForSelected
        • /AddNewContent
        • /All
        • /AllForSelected
        • /Ask
        • /Auto
        • /CopyCueDst
        • /CopyCueScr
        • /CreateReferenceObject
        • /CreateSecondCue
        • /CueOnly
        • /Date
        • /Default
        • /DiscardChanges
        • /DMX
        • /Embed
        • /Enumerate
        • /File
        • /ForceGlobal
        • /GDTF
        • /Gaps
        • /Global
        • /GridMergeMode
        • /Indirect
        • /KeepActivation
        • /Look
        • /Merge
        • /NoConfirm
        • /OriginalContentOnly
        • /Overwrite
        • /Path
        • /Release
        • /Remove
        • /Screen
        • /Selective
        • /Universal
      • Extended command line syntax options
    • Windows, Views, and Menus
      • Add window
      • Rearrange
      • Store and recall views
      • Remove windows from a screen
      • Window settings
      • Menus
      • Change menu locations
      • Pool windows
        • Create pool object
        • Label pool objects
        • Move pool objects
        • Insert pool objects
        • Copy pool objects
        • Lock and unlock pool objects
        • Delete pool objects
    • Networking
      • Interfaces and IP
      • Session
        • Create a session
        • Join a session
        • Leave a session
        • Invite to a session
        • Dismiss from session
        • Create a custom key
        • Session master selection
      • Web remote
    • DMX In and Out
      • DMX port configuration
      • Ethernet DMX
        • Art-Net menu
        • sACN menu
        • Transmit DMX using Art-Net
    • Single User and Multi User Systems
      • Create User
      • User settings
    • Patch and Fixture Setup
      • What are fixtures
      • Add fixtures to the show
      • Add multipatch fixtures
      • MVR
      • Live patch
      • DMX sheet
      • DMX universes
      • Remove fixtures from the show
      • Position fixtures in the 3D space
      • 3D
      • Camera Pool
      • Stages
      • Classes and Layers
      • Attribute definitions
        • Activation group
        • Feature group
        • Deactivation group
      • Parameter list
      • DMX curves
    • Operate Fixtures
      • Select Fixtures
      • What is the programmer
      • Fixture sheet
      • Encoder resolution
      • Using the color picker
      • Gel pool
      • Selection bar
      • Align
      • Selection Grid
      • Smart view
      • General parent.child structure
    • Scribbles
      • Create scribbles
      • Edit scribbles
      • Assign scribbles
      • Delete scribbles
    • Images
      • Screenshots
    • Video
    • Appearances
      • Create appearances
      • Use appearances
      • Delete appearances
    • Groups
      • Create groups
      • Edit groups
      • Delete groups
      • Group masters
    • Presets
      • Preset pools
      • Create new presets
      • Recipe presets
      • Use preset
      • Edit or Update presets
    • Worlds and Filters
      • At filter
      • Create a world
      • Create a filter
      • Use a world or filter
      • Delete a world
      • Delete a filter
    • MAtricks and Shuffle
      • Blocks
      • Groups
      • Wings
      • Widths
      • Shuffle
      • Transform
    • Cues and Sequences
      • What is tracking
      • Sequences sheet
      • Content sheet
      • Sequence settings
      • Store cues
      • Update cues
      • Copy cues
      • Cue recipes
      • Store settings and preferences
      • Play back cues
      • Move in black
      • Cue timing
      • Renumber cues
      • Delete cues
    • Executors
      • Assign object to an executor
      • Executor configurations
      • Running playbacks
      • Special executors
    • Masters
      • Selected masters
      • Grand masters
        • Time Control
      • Speed masters
      • Playback masters
    • Recipes
    • Phasers
      • Phaser editor
      • Create sinus dimmer phaser
      • Create circle phaser
      • Create circle phaser around position
      • Create color rainbow phaser
    • XYZ
      • Activating XYZ for fixture types
      • MArker fixture
    • Macros
      • Create macros
      • Edit macros
      • Assign macros to keys and buttons
      • Variables
      • Examples
    • Agenda
      • View modes
      • Create an agenda entry
      • Edit an agenda entry
      • Agenda toolbar
    • Timecode
      • What are timecode slots
      • Timecode settings
      • Track groups
      • Time ranges and events
      • Toggle view mode
      • Record a timecode show
      • Record an external timecode show
      • Edit a timecode show
    • Layouts
      • Create a layout
      • Assign multipatch fixtures
      • Edit layout
      • Layout view settings
      • Edit layout view
      • Edit layout elements
      • Layout encoder bar
    • Plugins
      • What is Lua?
      • Handle
      • Functions - Object-Free API
        • BuildDetails
        • CloseUndo
        • Cmd
        • CmdIndirect
        • CmdIndirectWait
        • CmdObj
        • Confirm
        • CreateUndo
        • DataPool
        • DefaultDisplayPositions
        • DeskLocked
        • Echo
        • ErrEcho
        • ErrPrintf
        • Export
        • ExportCSV
        • ExportJson
        • FromAddr
        • GetPath
        • GetShowFileStatus
        • GetSubfixture
        • GetSubfixtureCount
        • HandleToStr
        • HandleToInt
        • HookObjectChange
        • HostOS
        • HostSubType
        • HostType
        • Import
        • IntToHandle
        • MasterPool
        • MessageBox
        • ObjectList
        • Patch
        • PopupInput
        • Printf
        • ProgrammerPart
        • ProgressBar
        • Pult
        • Root
        • SelectedSequence
        • Selection
        • SelectionCount
        • SelectionFirst
        • SelectionNext
        • SerialNumber
        • ShowData
        • StrToHandle
        • ShowSettings
        • TextInput
        • Timer
        • UserVariables
        • Version
      • Functions - Object API
        • Addr
        • AddrNative
        • Children
        • Dump
        • Export
        • HasActivePlayback
        • Import
        • ToAddr
    • Data Pools
    • System
      • Date and time
      • Clock
      • Desk lights
      • System information
      • System monitor
      • Info Window
    • Sound
      • Sound Window
    • Remote In and Out
      • DC remotes
      • MIDI remotes
      • DMX remotes
      • OSC
      • PSN
      • MIDI
    • RDM
    • Control other MA Devices
      • grandMA3 Nodes
      • MA Network Switch
      • RemoteHID
    • Update the Software
      • Update grandMA3 consoles
      • Update grandMA3 Nodes
      • Update grandMA3 onPC windows hardware
      • Update grandMA3 viz-key
      • Network update
      • Delete update files
      • Troubleshooting
    • Fixture Types
      • Import fixture types
        • Import GDTF
        • Conflicts in fixture types
      • Build fixture types
        • Insert fixture types
        • Insert DMXModes
        • Insert geometries
        • Insert models
        • Link models to geometries
        • Link DMX modes to geometries
      • Export fixture types
        • Export GDTF
    • File Management
      • SFTP connection
      • Import / Export Menu
      • Folder Structure
    • Shut down the System
    • Troubleshooting
      • Clean start
  • grandMA3 Quick Start Guide
  • grandMA3 Quick Manual consoles
  • grandMA3 Quick Manual processing units
  • grandMA3 Quick Manual Nodes
  • grandMA3 Quick Manual Nodes DIN-Rail
  • grandMA3 Quick Manual onPC command wing XT
  • grandMA3 Quick Manual onPC command wing
  • grandMA3 Quick Manual onPC fader wing
  • grandMA3 Quick Manual onPC rack-unit
  • grandMA3 Quick Manual viz-key
  • grandMA3 Quick Manual I/O Nodes
  • Release Notes
Select different version
 
Hint:
New help version
The help version you selected belongs to an older software version. You may want to view the latest help version.
Version 1.8

Use Preset

Presets are often used for live playback or as building blocks in cues. Tapping a preset to get the values uses the At keyword.

Calling Preset Into the Programmer

The first step is to select the desired fixtures and then call the preset into the programmer.

The workflow is the same for every kind of preset (MAgic, Recipe, Multistep, standard single step, etc.)

If the programmer does not have a fixture selection and a preset is tapped, then the first tap selects all the fixtures that can use the preset. In this case, it works like a group.

Tapping a preset with a fixture selection in the programmer calls the preset if it is valid for the selected fixtures.

Timing values can be stored together with attribute values in the preset, and calling a preset that includes timing information calls the values into the programmer using the preset timing.

Calling presets that only contain timing values call the timing values into the timing lavers of the programmer.

Another way to use timing with presets is the Programmer Time master. Learn more about the master in the Time Control topic.

Presets with stored timing values have a higher priority than the Programmer Time master, and the stored timing will be used when the preset is called.

Known Limitation:
Calling a MAgic preset into the programmer will extract the data, and it will not reference the preset. It is recommended to use MAgic presets in combination with recipes to maintain referenceable data.

Presets Running from Executors

Preset can be assigned to executors.

Preset can be assigned to executors using the Assign keyword or by using the Assign menu. Learn more about this in the Assign Object to an Executor topic.

If the preset uses global or universal data, then the executor button should use the At command to call the preset values.

Important:
Using the At command on presets assigned to executors does not playback the values from the executor. The values are called into the selected fixtures in the programmer just like described above - if the preset is valid for the fixture selection.

Other playback commands (like Go+, Toggle, Flash, etc.)are relevant for presets with Selective data. This also means that presets with selective data can be played back from the preset pools using, for instance, a Go+ command.

Opening the EditSetting-tab of the assign menu of an executor that has a preset assigned offers some of the same settings as for sequences. For more information on playback settings, see the Sequence Settings topics.

Edit the global preset playback settings in Menu - Preferences and Timing - Preset.

The OffFade property of preset playbacks determines the fade time when switching off a selective preset playback.

Store Presets in Cues

When a preset is in the programmer, it can be stored in cues. Learn more about storing cues in the Store Cues topic.

A reference to the preset is stored for the specific fixture attributes. This means that the value stored in the preset is not stored in the cue, but a reference to the preset is stored. So if the value stored in the preset is changed after the cue is stored, then the cue still looks in the preset to get the value when the cue is played back, and the values in the preset will be used.

Be aware that the Absolute value layer is connected to the Fade and the Delay layers. The Fade and Delay layers are used by individual fade and delay times for an attribute. Storing a value in the absolute layer for an attribute in a preset has the potential also to add values from the fade and delay layers.

This means that if a preset contains absolute values, it also contains a connection to possible values in the fade and delay layers. If the fade or delay values are later added, changed, or updated, this change will be reflected in the cue referencing the absolute value. See the examples below.

The phaser layers (Speed, Phase, Measure, Accel, Decel, Transition, and Width) are also linked. Adding one of these layers in a preset effectively adds all the phaser layers.

The Relative value layer does not add any references to other layers. Adding individual fade and delay values to a preset with relative values can automatically add the fade and delay layer values to a cue without a preset reference (hardcoded values). See the examples below.

This is very important to keep in mind when updating the preset information.

Examples

This first example is about absolute values.

  1. Create a new Selective preset with an absolute dimmer value for a fixture. Make sure this is all it contains.
  2. Make the preset active in the programmer.
  3. Store cue 1 in a new sequence.
  4. Select the sequence.
  5. Clear the programmer and run the cue.

Notice that the value is output using the cue fade and delay times (default is 0 seconds).

Look at the stored content in the Sequence Sheet in Tracking Sheet mode. Notice that the Absolute layer has a link to the preset. The Fade and the Delay layers show the value from the cue with no link to the preset.

  1. Turn Off the sequence.
  2. Tap the preset twice to get it in the programmer.
  3. Select the Fade layer for the programmer and give it a value higher than the cue fade time.
  4. Do the same for the Delay layer.
  5. Press Update (the key should be flashing).
  6. Make sure to tap the preset in the Update Menu - NOT the cue.
  7. Clear the programmer.
  8. Run the cue.

Look at the cue content in the Sequence Sheet in Tracking Sheet mode. Now the Fade and Delay layers show links to the preset. This means that running the cue automatically uses the individual fade and delay times stored in the preset (when they exist).

This second example is about relative values.

  1. Create a new Selective preset with a relative dimmer value for a fixture. Make sure this is all it contains.
  2. Make the preset active in the programmer.
  3. Store cue 1 in a new sequence.
  4. Select the sequence.
  5. Clear the programmer and run the cue.

Notice that the value is output using the cue fade and delay times (default is 0 seconds).

Look at the stored content in the Sequence Sheet in Tracking Sheet mode. Notice that the Relative layer has a link to the preset. The Fade and the Delay layers show the value from the cue with no link to the preset.

  1. Turn Off the sequence.
  2. Tap the preset twice to get it in the programmer.
  3. Select the Fade layer for the programmer and give it a value higher than the cue fade time.
  4. Do the same for the Delay layer.
  5. Press Update (the key should be flashing).
  6. Make sure to tap the preset in the Update Menu - NOT the cue.
  7. Clear the programmer.
  8. Run the cue.

Look at the cue content in the Sequence Sheet in Tracking Sheet mode. Now the Fade and Delay layers show the values stored in the preset - not a reference to the preset. Changing the Fade and Delay values again automatically changes the values in the cue.

This third example is about both relative and absolute values.

  1. Create a new Selective preset with absolute and relative dimmer values for a fixture. Make sure this is all it contains.
  2. Make the preset active in the programmer.
  3. Store cue 1 in a new sequence.
  4. Select the sequence.
  5. Clear the programmer and run the cue.

Notice that the value is output using the cue fade and delay times (default is 0 seconds).

Look at the stored content in the Sequence Sheet in Tracking Sheet mode. Notice that the Absolute and Relative layers have links to the preset. The Fade and the Delay layers show the value from the cue with no link to the preset.

  1. Turn Off the sequence.
  2. Tap the preset once to select the fixture in the preset.
  3. Select the Fade layer for the programmer and give it a value higher than the cue fade time.
  4. Do the same for the Delay layer.
  5. Press Store and then tap the preset.
  6. Tap Merge in the "Store to Preset #" pop-up.
  7. Clear the programmer.
  8. Run the cue.

Look at the cue content in the Sequence Sheet in Tracking Sheet mode. Now the Fade and Delay layers show links to the preset. This means that running the cue automatically uses the individual fade and delay times stored in the preset (when they exist). Both the relative and absolute values use the fade and delay values from the preset.


If attributes are added to or deleted from the preset after it is used. And the stored cues referencing the preset need to reflect this new change, then the preset needs to be recast. This can be done using the Recast keyword or the Edit Preset Object pop-up. Recasting a preset removes or adds attributes to the fixtures in the cue.

The recast function only recasts presets to cues where a preset reference exists for the absolute layer.

When presets are used in cues and later deleted, the preset values are transferred to the cue (hardcoded values in the cue).

Assign Presets to Attributes in the Tracking Sheet

When a value is edited in the Track Sheet, the available presets can be chosen in the Calculator.

Extract Preset Values

Preset values can be extracted to the selected fixtures. The preset needs to be valid for the selected fixtures. The Extract keyword is used for this.

The values stored in the preset will be pulled into the programmer without a reference to the preset. The values are then like any other typical programmer values.


Select different version