• grandMA3 User Manual
    • About the Help
      • Open the help in the console
      • Open the help in the web
      • Open the help as pdf
      • Navigate in the help
    • 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
        • Framework 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
      • Windows™® installation
      • Optimize Windows™®
      • macOS® installation
      • Optimize macOS®
      • onPC Terminal App
      • onPC settings
    • Show File Handling
      • Load show file
      • Save show file
      • New show file
      • Backup, demo and template show files
      • Organize show files
    • 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
      • Oops overlay
      • 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
        • Compare tool
    • Command Syntax and Keywords
      • Syntax rules
      • Parent child concept
      • General keywords
        • ; [Semicolon]
        • / [Slash]
        • . [Dot]
        • = [Equal]
        • <<< [GoFastBackward]
        • >>> [GoFastForward]
        • - [Minus]
        • * [Asterisk]
        • % [Percent]
        • + [Plus]
        • Absolute
        • Acceleration
        • Action
        • ActivationGroup
        • Agenda
        • Align
        • AlignTransition
        • Appearance
        • Assign
        • At
        • Attribute
        • AutoCreate
        • Black
        • Blind
        • Block
        • BPM
        • Call
        • CancelSoftwareUpdate
        • Camera
        • Capture
        • ChangeDestination
        • Channel
        • ChannelSet
        • Chat
        • ChatJoin
        • ChatLeave
        • CleanUp
        • Clear
        • ClearActive
        • ClearAll
        • ClearSelection
        • Clone
        • CommandDelay
        • Collect
        • Collection
        • Color
        • ColorDefinition
        • ColorTheme
        • Configuration
        • Console
        • Cook
        • Copy
        • Cue
        • CueAbsolute
        • CueDelay
        • CueFade
        • CueInDelay
        • CueInFade
        • CueOutDelay
        • CueOutFade
        • CueRelative
        • CueUpdate
        • CurrentEnvironment
        • CurrentUser
        • CurrentUserProfile
        • Cut
        • DataPool
        • Deceleration
        • Decimal8
        • Decimal16
        • Decimal24
        • Default
        • Delay
        • Delete
        • DeleteOtherVersions
        • DeleteGlobalVariable
        • DeleteUserVariable
        • Dismiss
        • Display
        • DMXAddress
        • DMXLayer
        • DMXReadout
        • DMXUniverse
        • DoubleSpeed
        • Down
        • DumpLog
        • Drive
        • DropOwnership
        • Echo
        • Edit
        • EditSetting
        • Eject
        • Effect
        • EncoderPage
        • EndIf
        • Environment
        • Exchange
        • Executor
        • Export
        • Extract
        • Extension
        • Fade
        • FaderCrossFade
        • FaderCrossFadeA
        • FaderCrossFadeB
        • FaderMaster
        • FaderRate
        • FaderSpeed
        • FaderTemp
        • FaderTime
        • FeatureGroup
        • Filter
        • Fix
        • FixtureClass
        • FixtureLayer
        • Fixture
        • FixtureType
        • Flip
        • Flash
        • Fog
        • Freeze
        • Full
        • Gel
        • GetGlobalVariable
        • GetUserVariable
        • Go+
        • Go-
        • Goto
        • Grid
        • GridPosition
        • Group
        • HalfSpeed
        • Help
        • HelpLua
        • Hex8
        • Hex16
        • Hex24
        • Highlight
        • Houselights
        • Hz
        • If
        • IfActive
        • IfOutput
        • IfProgrammer
        • Image
        • Import
        • Index
        • Insert
        • Integrate
        • Interface
        • Invert
        • Invite
        • IP
        • JoinSession
        • Key
        • Keyboard
        • KeyboardShortcut
        • Kill
        • KnockIn
        • KnockOut
        • Label
        • Layout
        • LearnSpeed
        • LeaveSession
        • Library
        • List
        • ListOwnership
        • ListReference
        • Load
        • Loaded
        • LoadShow
        • Lock
        • LogIn
        • LogOut
        • Lowlight
        • Lua
        • LuaFile
        • Macro
        • MArker
        • Master
        • MAtricks
        • Measure
        • Media
        • MemoryInfo
        • Menu
        • Mesh
        • Move
        • Multipatch
        • MyRunningMacro
        • MyRunningPreset
        • MyRunningSequence
        • MyRunningTimer
        • Natural
        • NDI
        • NewShow
        • Next
        • NextY
        • NextZ
        • NetworkNode
        • NonDim
        • Normal
        • Note
        • Off
        • Offset
        • On
        • onPC
        • OSC
        • Oops
        • OutputLayer
        • Page
        • Part
        • Park
        • Paste
        • Patch
        • Pause
        • Percent
        • PercentFine
        • Phase
        • Physical
        • Plugin
        • Preset
        • PresetUpdate
        • Press
        • Preview
        • Previous
        • PreviousY
        • PreviousZ
        • Programmer
        • Property
        • ProcessingUnit
        • Pyro
        • Quickey
        • Rate1
        • RDM
        • Readout
        • Reboot
        • Recast
        • Record
        • Relative
        • Release
        • ReloadAllPlugins
        • ReloadUI
        • Remote
        • RemoteHID
        • RemoteCommand
        • Remove
        • RenderQuality
        • Reset
        • Restart
        • Root
        • RealtimeChannel
        • RunningMacro
        • RunningPreset
        • RunningSequence
        • RunningTimecode
        • RunningTimer
        • SaveShow
        • ScreenConfiguration
        • ScreenContent
        • Scribble
        • Seconds
        • Select
        • Selection
        • SelectFixtures
        • Sequence
        • SendMIDI
        • SendOSC
        • Set
        • SetGlobalVariable
        • SetUserVariable
        • Shuffle
        • ShutDown
        • SnapDelay
        • SoftwareImport
        • SoftwareUpdate
        • SoundChannel
        • Solo
        • SpecialExecutor
        • Speed
        • Speed1
        • SpeedMaster
        • Stage
        • Station
        • StationSettings
        • Step
        • Stomp
        • Store
        • SwitchTograndMA2Software
        • SwitchTograndMA3Software
        • Swap
        • Temp
        • Thru
        • Time
        • Timecode
        • TimecodeSlot
        • Timer
        • 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
        • Zero
      • Option keywords
        • /Active
        • /ActiveForSelected
        • /AddNewContent
        • /All
        • /AllForSelected
        • /Ask
        • /Auto
        • /CopyCueDestination
        • /CopyCueSource
        • /CreateReferenceObject
        • /CreateSecondCue
        • /CueOnly
        • /Date
        • /Default
        • /DiscardChanges
        • /DMX
        • /DMXProtocols
        • /Embed
        • /Enumerate
        • /File
        • /ForceGlobal
        • /GDTF
        • /Gaps
        • /Global
        • /GridMergeMode
        • /Indirect
        • /InputFilter
        • /KeepActivation
        • /LocalSettings
        • /Look
        • /MAtricks
        • /Merge
        • /MergeHighPriority
        • /MergeLowPriority
        • /MoveValues
        • /NoAutoClose
        • /NoConfirmation
        • /NoDependencies
        • /NoOops
        • /NoRefresh
        • /NoSave
        • /NoShowData
        • /NoSubfolders
        • /OriginalContentOnly
        • /Output
        • /OutputStations
        • /Overwrite
        • /PatchOffset
        • /Path
        • /PhaserData
        • /Programmer
        • /Release
        • /Remove
        • /Save
        • /Screen
        • /Selection
        • /Selective
        • /Single
        • /Tab
        • /Type
        • /Universal
        • /Wrap
      • Extended command line syntax options
    • Windows, Views, and Menus
      • Add window
      • Rearrange
      • Store and recall views
      • Remove windows from a screen
      • Window settings
      • Title bar configuration
      • Menus
      • Change menu locations
      • Pool windows
        • Create pool objects
        • 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
      • Network design
        • Protocol details
        • WLAN (WiFi)
      • Regulations and standards
    • 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
      • Object ownership
    • 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 viewer
      • Render quality
      • 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
        • Graphics
      • Encoder resolution
      • Using the color picker
      • Gel pool
      • Selection bar
      • Align
      • Selection Grid
      • SMArt view
    • Scribbles
      • Create scribbles
      • Edit scribbles
      • Assign scribbles
      • Delete scribbles
    • Images
      • Screenshots
    • Video
    • Meshes
    • Gobos
    • Symbols
      • Import symbols
      • Delete symbols
    • Appearances
      • Create appearances
      • Use appearances
      • Delete appearances
    • Notes
    • 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
        • Tracking distance
        • Break
      • Sequence 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
      • Import macros
      • Edit macros
      • Assign macros to keys and buttons
      • Variables
      • Examples
    • Agenda
      • View modes
      • Create an agenda entry
      • Edit an agenda entry
      • Agenda toolbar
    • Timers
      • Stopwatch
      • Countdown
    • 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
      • External sources
    • 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
      • Interface functions
        • Progress bar
      • Variable functions
      • Functions - Object-Free API
        • AddonVars
        • BuildDetails
        • ClassExists
        • CloseAllOverlays
        • CloseUndo
        • Cmd
        • CmdIndirect
        • CmdIndirectWait
        • CmdObj
        • ConfigTable
        • Confirm
        • CreateUndo
        • CurrentEnvironment
        • CurrentExecPage
        • CurrentProfile
        • CurrentUser
        • DataPool
        • DefaultDisplayPositions
        • DelVar
        • DeskLocked
        • DeviceConfiguration
        • DrawPointer
        • Echo
        • ErrEcho
        • ErrPrintf
        • Export
        • ExportCSV
        • ExportJson
        • FromAddr
        • GetApiDescriptor
        • GetAttributeByUIChannel
        • GetAttributeCount
        • GetAttributeIndex
        • GetChannelFunction
        • GetChannelFunctionIndex
        • GetClassDerivationLevel
        • GetDisplayByIndex
        • GetDisplayCollect
        • GetDMXUniverse
        • GetDMXValue
        • GetExecutor
        • GetFocus
        • GetFocusDisplay
        • GetObjApiDescriptor
        • GetPath
        • GetPathSeparator
        • GetRTChannel
        • GetRTChannelCount
        • GetRTChannels
        • GetSample
        • GetSelectedAttribute
        • GetShowFileStatus
        • GetSubfixture
        • GetSubfixtureCount
        • GetTokenName
        • GetTokenNameByIndex
        • GetUIChannelCount
        • GetUIChannelIndex
        • GetUIChannels
        • GetVar
        • GlobalVars
        • HandleToInt
        • HandleToStr
        • HookObjectChange
        • HostOS
        • HostSubType
        • HostType
        • Import
        • IncProgress
        • IntToHandle
        • IsObjectValid
        • KeyboardObj
        • MasterPool
        • MessageBox
        • MouseObj
        • ObjectList
        • Patch
        • PopupInput
        • Printf
        • ProgrammerPart
        • Pult
        • ReleaseType
        • Root
        • SelectedSequence
        • Selection
        • SelectionCount
        • SelectionFirst
        • SelectionNext
        • SerialNumber
        • SetBlockInput
        • SetLED
        • SetProgress
        • SetProgressRange
        • SetProgressText
        • SetVar
        • ShowData
        • ShowSettings
        • StartProgress
        • StopProgress
        • StrToHandle
        • TextInput
        • Time
        • Timer
        • TouchObj
        • UserVars
        • Version
      • Functions - Object API
        • Addr
        • AddrNative
        • Children
        • Dump
        • Export
        • HasActivePlayback
        • Import
        • ToAddr
    • Quickeys
      • Quickey editor
      • Use quickey pool objects
      • Example
    • Data Pools
    • System
      • Date and time
      • Clock
      • Desk lights
      • System information
      • System monitor
      • Info window
    • Sound
    • Remote In and Out
      • DC remotes
      • MIDI remotes
      • DMX remotes
      • OSC
        • Examples
        • TouchOSC
        • QLab
        • Open stage control
        • zactrack
        • Protocol viewer
      • 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
        • Environmental fixture types
      • Export fixture types
    • File Management
      • SFTP connection
      • Import / Export menu
      • Folder structure
    • Shut Down the System
    • Troubleshooting
      • Clean start
      • Update does not work
      • Station does not connect
      • Panic macro
    • Glossary
  • 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.9

Break

Tracking and common tracking functions are described in the What is Tracking topic.

Breaks in cues are a filtered version of the Release function. Where the release stops all tracking values, the break will stop tracking of attributes based on a selected filter or world.

The main difference between the release function and setting a break, filtering all attributes, is that the release will release currently tracked attributes from the sequence immediately when the release is activated. Setting a break does not affect existing stored and tracking values. An existing break can only affect tracking values added or changed that pass the cues where the break is already set - if the selected filter or world includes the attribute.

Editing the Break cell in a cue opens an Assignment Editor pop-up.

Assignment Editor pop-up

This has three tabs: Empty, Filter, and World.

Empty will remove any break setting. Filter and World allow the selection of an existing filter or world. Selecting one of these will stop tracking changes or additions, passing the cue where the break is set based on the content of the selected filter or world. Learn more about filters and worlds in the Worlds and Filter section.

Follow the example below for a better understanding of the break function.

 

Example

The base sequence for this example looks like this:

Base sequence for Break example

Here we have nine cues. Cue number 1 has some stored values (Dimmer, Position, and Color) for fixture 1.

The values stored in cue number 1 are tracked from 1 to the end. The values are released in the OffCue because there is a Yes in the Release column.

Two filters in the Filters pool will be used: "All" and "Only Dimmer".

Filter pool with filter objects

The filters are one filter that contains all attributes and layers and one that only contains the dimmer attributes and all layers.

In this scenario, it is known that cue number 4 is a fade out to black, and cue number 7 is used to pre-set fixtures for the second scene in the show.

The break function can protect these two cues from tracking value changes.

Before moving any further with the example, let us explore the release function by editing the Release cell for cue 7, so it changes to "Yes".

Release is out of the scope of this topic (It is explained more in the What is Tracking topic), but it is included here to show that a release stops all future and existing tracking. The tracking values are released from the sequence.

Release is not the goal for cue 7. Remove the "Yes" in the Release column again.

Editing the Break cell for cue number 7 opens the Assignment Editor. Select Filter and then tap All to select it.

Now the sequence looks like this:

Break is set for cue 7

Notice the difference between this and the release. The existing tracking values are not released but are protected from future changes.

A break adds a white line to indicate the tracking break. If the break affects all attributes - typically by using Filter 1 or world 1 - it will extend across the entire row (just like the release).

Cue 4 is a fade out. The current dimmer value of 0% can be protected by adding a second break in cue 4, but this time using the "Only Dimmer" filter:

A break is set for cue 4

The break in cue 4 looks a bit different. The white line is black in the attribute columns. This indicates that some attributes are filtered. The Feature Group Indicator Bar is visible at the bottom of the break cell. It shows the features active in the filter.

 

Now all the breaks are set, and the values can be changed. A new dimmer, position, and color values for fixture 1 are stored in cue number 2.

Result

The result is the dimmer, and only the dimmer, value being returned to 0% (the previous tracked value) in cue number 4 because the filter in the break stopped the newly added values tracking past the cue.

All the values in cue 7 were protected from changes by the filter in the break, and the old tracking values are added (if needed) in cue number 7.


Select different version