• 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
        • 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
    • 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
      • Clean start
    • 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
      • All keywords
        • ; [Semicolon]
        • / [Slash]
        • . [Dot]
        • .. [DotDot]
        • = [Equal]
        • <<< [GoFastBackward]
        • >>> [GoFastForward]
        • - [Minus]
        • * [Asterisk]
        • % [Percent]
        • + [Plus]
        • Absolute
        • Acceleration
        • Action
        • ActivationGroup
        • Align
        • AlignTransition
        • Appearance
        • Assign
        • At
        • Attribute
        • Black
        • Blind
        • Block
        • BPM
        • Call
        • Camera
        • Capture
        • Certificate
        • ChangeDestination
        • Channel
        • ChannelSet
        • Chat
        • Cleanup
        • Clear
        • ClearActive
        • ClearAll
        • ClearSelection
        • Clone
        • CmdDelay
        • ColorTheme
        • Configuration
        • Console
        • Cook
        • Copy
        • Cue
        • CueAbs
        • CueDelay
        • CueFade
        • CueInDelay
        • CueInFade
        • CueOutDelay
        • CueOutFade
        • CueRel
        • CurrentUser
        • CurrentUserProfile
        • Cut
        • DataPool
        • Deceleration
        • Decimal8
        • Decimal16
        • Decimal24
        • Default
        • Delay
        • Delete
        • DelGlobalVar
        • DelUserVar
        • Dismiss
        • Display
        • DMXAddress
        • DMXReadout
        • DMXUniverse
        • Down
        • Drive
        • Echo
        • Edit
        • EditSetting
        • Eject
        • Effect
        • EndIf
        • Exchange
        • Executor
        • Export
        • Extract
        • Extension
        • Fade
        • Fader
        • FaderHighlight
        • FaderLowlight
        • FaderMaster
        • FaderRate
        • FaderSolo
        • FaderSpeed
        • FaderTemp
        • FaderTime
        • FaderX
        • FaderXA
        • FaderXB
        • FeatureGroup
        • Filter
        • Fix
        • Fixture
        • FixtureType
        • Flip
        • Flash
        • Fog
        • Font
        • Freeze
        • Full
        • Gel
        • GetGlobalVar
        • GetUserVar
        • Universal
        • Go+
        • GoStep
        • Go-
        • Goto
        • Grid
        • Group
        • 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
        • LearnRate
        • LearnSpeed
        • LeaveSession
        • Library
        • List
        • ListOwner
        • ListRef
        • Load
        • Loaded
        • LoadShow
        • Lock
        • Login
        • Logout
        • Lowlight
        • Lua
        • LuaFile
        • Macro
        • Master
        • MAtricks
        • Media
        • Menu
        • Mesh3DS
        • MessageCenter
        • Monitor
        • Move
        • MyRunningMacro
        • MyRunningSequence
        • NewShow
        • Next
        • Node
        • NonDim
        • Normal
        • Off
        • On
        • OnPC
        • OSC
        • Oops
        • Output
        • OutputLayer
        • Page
        • Part
        • Park
        • Paste
        • Patch
        • Pause
        • Percent
        • PercentFine
        • Phase
        • Physical
        • Plugin
        • Preset
        • PresetUpdate
        • Press
        • Preview
        • Previous
        • Programmer
        • Property
        • PU
        • Pyro
        • Rate1
        • Readout
        • Reboot
        • Recast
        • Relation
        • Relative
        • Release
        • ReloadPlugins
        • ReloadUI
        • Remote
        • RemoteHID
        • RemoteCommand
        • Remove
        • Reset
        • Restart
        • Root
        • RTChannel
        • RunningMacro
        • RunningSequence
        • SaveShow
        • ScreenConfig
        • ScreenContent
        • Scribble
        • Seconds
        • Select
        • Selection
        • SelFix
        • Sequence
        • SendOSC
        • Set
        • SetGlobalVar
        • SetUserVar
        • Shuffle
        • Shutdown
        • SnapDelay
        • SoftwareUpdate
        • SoundChannel
        • Solo
        • SpecialExecutor
        • Speed
        • Speed1
        • Stage
        • Station
        • Step
        • Stomp
        • Store
        • Temp
        • Texture
        • Thru
        • Time
        • Timecode
        • TimecodeSlot
        • Toggle
        • Top
        • Transition
        • Type
        • UIChannel
        • UiGridSelection
        • Unblock
        • Unlock
        • Unpark
        • Unpress
        • Up
        • Update
        • UpdateContent
        • User1
        • User2
        • User
        • UserProfile
        • Video
        • Version
        • View
        • ViewButton
        • Width
        • World
        • Xkeys
        • Zero
      • 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
      • Web remote
      • SFTP connection
    • 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
      • MVR
      • Live patch
      • DMX sheet
      • DMX universes
      • Remove fixtures from the show
      • Position fixtures in the 3D space
      • Marker fixture
      • 3D window
      • Camera Pool
      • Stages
      • Classes and Layers
      • Attribute definitions
        • Activation group
        • Feature group
      • Parameter list
      • DMX curves
    • Operate Fixtures
      • What is the programmer
      • Fixture sheet
      • Encoder resolution
      • Using the color picker
      • Selection bar
      • Align
      • Selection Grid
      • Smart view
    • Scribbles
      • Create scribbles
      • Edit scribbles
      • Assign scribbles
      • Delete scribbles
    • Images
      • Screenshots
    • 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
    • Cues and Sequences
      • What is tracking
      • Look at cues and sequences
      • 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
    • Phasers
      • Step bar
      • Phaser editor
      • Create sinus dimmer phaser
      • Create circle phaser
      • Create circle phaser around position
      • Create color rainbow phaser
    • Macros
      • Create macros
      • Edit macros
      • Assign macros to keys and buttons
      • Examples
    • Agenda
      • Agenda modes
      • Create an agenda entry
      • Edit an agenda entry
      • Agenda toolbar
      • Agenda edit menu
    • 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
      • Edit layout
      • Layout view settings
      • Edit layout view
      • Edit layout elements
      • Layout encoder bar
    • Plugins
      • What is Lua?
      • Lua functions
        • Object-Free API
          • Cmd
          • CmdIndirect
          • CmdIndirectWait
          • CmdObj
          • Confirm
          • DataPool
          • Echo
          • ErrPrintf
          • ErrEcho
          • Export
          • GetPath
          • GetShowFileStatus
          • GetSubfixture
          • GetSubfixtureCount
          • HookObjectChange
          • HostOS
          • HostSubType
          • HostType
          • Import
          • MessageBox
          • ObjectList
          • PopupInput
          • Printf
          • ProgressBar
          • SelectedSequence
          • SelectionCount
          • SelectionFirst
          • SerialNumber
          • SelectionNext
          • TextInput
          • Timer
          • UserVariables
          • Version
        • Object API
          • Children
          • Export
          • HasActivePlayback
          • Import
          • ToAddr
    • Data Pools
    • System
      • Date and time
      • Clock
      • Desk lights
      • System information
      • System monitor
      • Info Window
    • Sound Window
    • Remote In and Out
      • DC remotes
      • MIDI remotes
      • DMX remotes
      • OSC
      • PSN
    • 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
      • Troubleshooting
    • Fixture Types
      • Import fixture types
        • Import GDTF
      • Build fixture types
        • Insert fixture types
        • Insert DMX modes
        • Insert geometries
        • Insert models
        • Link models to geometries
        • Link DMX modes to geometries
      • Export fixture types
        • Export GDTF
    • File Management
      • Import / Export Menu
      • Folder Structure
    • Shut down the System
  • 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.6

Presets

A preset holds information about attribute-values for a selection of fixtures and may be referenced and re-used in cues or in the programmer. The value of a preset in the programmer or stored in a cue is marked with a sea green marker.

The principle of presets is to store a labeled reference in a cue, rather than the actual value itself. Or use presets for busking, where presets are called into the programmer on the fly.

Updating the preset means that the cues do not need to be updated since they reference the preset and not the actual preset values.

Presets are marked with a cyan marker. This maker is visible on cues that use preset and on the values itself, for instance, in the tracking sheet or the fixture sheet. Read more in the Marker topic.

Hint:
Using presets when programming facilitates the work, especially when working with a show which is used in different locations and for various customers.

Preset Pools

Presets are stored in pools. There are pools for each feature group. These pools have a default input filter that only allows the values for that feature group to be stored in the preset pool. There are also five preset pools called "All 1" to "All 5". These do not have a default input filter and can be used to store any attribute values. Learn more about the pools in the Preset Pool topic.

Preset Modes

Presets modes are used when the preset is stored (or updated) and when the preset is called.

There are three different preset modes Selective, Global, and Universal.

Each preset got letters showing the preset mode.

Example:

Preset with all three types of data

The three modes are:

  • Selective (S):
    The data will be added as selective data for each fixture that has active data in the programmer.
  • Global (G):
    The data will be added mainly as global data. If there are several fixtures of the same fixture type but with different values, then the global data will be determined by average, and selective data will be added for the other fixtures which have divergent data.
  • Universal (U):
    Data will be added as global data, and the preset mode will be set to Universal.

When a preset is stored or updated, then there are two more options:

  • Auto:
    When updating or storing into an existing preset, the preset mode of the preset will be respected.
    In the case of global preset mode, selective data will be added to the preset when at least one fixture that can use the preset is active with new values.
    When creating a new preset Auto mode will take the mode defined by the pool and use the rules for each mode.
  • Force Global:
    Data will be added as global data, and untouched existing selective data will be discarded within the preset for the fixtures of the same fixture type.
    Force Global will discard the selective data when updating a preset or when storing with the merge option into an existing preset.

Each preset can store all three modes or some combinations of modes.

Each preset pool has a setting for a default mode. This mode is indicated by one of the letters in the upper right corner of the pool title field.

This default can be used when storing the preset or a different mode can be used.

Learn more in the Create New Presets topic and the Use Preset topic.

Absolute and Relative Values

Preset can store absolute and/or relative values. Relative values are often used with multistep presets but it is not limited to this use.

Example:

Preset with absolute, relative, and both types of values

Presets with absolute values have a square dark red marker with rounded corners. Relative values are indicated by a dark pink square with rounded corners. Presets can contain both absolute and relative values. Learn more about the different programmer layers in the What is the Programmer topic.

Embedded Presets

A preset can contain a link to a different preset. It is the same as cues storing a reference to a preset - just for other presets. This can be useful for instance when a show is built using a set of general preset and other presets are created using these as building blocks.

Example:

In this example, there is a global color preset that has values for all fixture types. This is used to create a new selective preset for a smaller selection of fixtures. If the fixture type change, then only the original global preset needs to be updated. The selective preset links to the global preset values and do not need to be updated.

Preset nine contains embedded data. Preset eight is used in an embedded preset.

The "source" preset has a downward pointing arrow icon to indicate that this preset is referenced by other presets (or cues). The preset with embedded data has a single right pointed arrow icon to indicate that this preset uses referenced data.

If a new name is not defined then the name is also referenced (referenced names are in square brackets). This means that changing the name of the source preset also updates the name of the new preset. Learn more in the Create New Presets topic.

Recipe Presets

Preset can have recipe information. A recipe is one or more lines with information about a group, preset, MAtricks, individual fade, delay, speed, and phase values.

This information can be used to "cook" values into the preset. If the source information changes then the preset can be cooked again to reflect the changes. For instance, if a group is used in a recipe and it changes after the initial cooking, then the preset can be cooked again and it will now reflect the changes to the group. Learn more in the Recipe Presets topic.

Example:

Preset with cooked recipe information

A small pot icon indicates a preset with cooked recipes.

MAgic Presets

MAgic presets are presets where value points in a range are defined. This range can then be applied to a dynamic selection of fixtures. For instance, two fixtures are stored in a MAgic preset with dimmer values of 0% and 100%. MAgic presets need to be stored as a selective preset, but that does not mean that only the selected fixtures can use it - it only means that they contain values for a selection of fixtures. The MAgic preset uses the values to define the points in a range. A different fixture selection can be made and the range of values between the points are assigned to the fixtures when the MAgic preset is called into the programmer. These values are calculated based on the points and then taken into the programmer as hard values. There is no reference back to the MAgic preset.

There can be up to five defined points in the range (on each axis in the selection grid).

MAgic presets have a small wizard hat icon in the preset pool object

Position preset with MAgic information

Example:

A path needs to be defined to control a color range from blue to yellow. The wish is to have the range go through the red area in a CIE color picker - instead of going through white. Three fixtures are needed to define the range.

The first fixture is blue, the second is magenta, and the third is yellow. This is then stored as a MAgic preset. Now this range through three points can be used by multiple fixtures to create the desired path.

Result of a three-point MAgic color preset applied to multiple fixtures

Learn the details on how to create this MAgic preset in the Create New Presets topic.

Multistep Presets

Presets can contain values in multiple steps (Phasers). Presets with only one step usually have the values stored in step one.  If a preset has multiple steps then they are called multistep presets.

Example:

Multistep preset

They have a three-dot icon to indicate multistep values.

The steps can get values from other presets using the Integrate keyword.

Multistep preset with integrated presets

It can be a little hard to see but presets with integrated presets have a three arrow right-pointing arrow icon. The default color for this icon is dark blue.

Integrate is much like embedded. The difference is that integrate can be used to take step one value into other steps. Learn more about multistep presets and integrate in the Create Color Rainbow Phaser topic.

Filtered Presets

The entire preset pool has a default input filter - except the All preset pools. The default filter is on feature group preset pools. They automatically filter the attributes in the feature group.

The input filter can be changed to a custom filter for any preset pool including the All presets.

Besides an entire preset pool having an input filter it is also possible to have an input filter on individual presets. Learn more about input filters in the Edit Presets topic.

Example:

Preset with input filter

It can be hard to see the input filter icon because of the (default) dark blue color, but there is a downward pointing arrow with dots on the sides icon that indicates that the preset has an input filter.




Sub topics

Select different version