• 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
    • 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
        • /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
      • 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
    • 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?
      • Functions - Object-Free API
        • BuildDetails
        • Cmd
        • CmdIndirect
        • CmdIndirectWait
        • CmdObj
        • Confirm
        • DataPool
        • DefaultDisplayPositions
        • DeskLocked
        • Echo
        • ErrEcho
        • ErrPrintf
        • Export
        • ExportCSV
        • ExportJson
        • GetPath
        • GetShowFileStatus
        • GetSubfixture
        • GetSubfixtureCount
        • HookObjectChange
        • HostOS
        • HostSubType
        • HostType
        • Import
        • MasterPool
        • MessageBox
        • ObjectList
        • Patch
        • PopupInput
        • Printf
        • ProgrammerPart
        • ProgressBar
        • Pult
        • SelectedSequence
        • Selection
        • SelectionCount
        • SelectionFirst
        • SelectionNext
        • SerialNumber
        • ShowData
        • ShowSettings
        • TextInput
        • Timer
        • UserVariables
        • Version
      • Functions - Object API
        • 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
    • 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
      • 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
      • 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
 
Version 1.8

MAtricks and Shuffle

MAtricks is a tool that can be used to divide a selection of fixtures into sub selections.

The general workflow is that a selection of fixtures is selected, then different MAtricks settings are applied to select fixtures inside the main selection.

For example, ten fixtures are selected and you want to step through these ten fixtures one at a time to do a position correction. MAtricks is the tool used to do this.

The selection can be shuffled using a set of shuffle tools. Read more below.

MAtricks Tools

One of the ways to work with MAtricks is the MAtricks toolbar or window.

The MAtricks window is separated into 3 sections. One for each axis. The X-axis section has a red background, the Y-axis section has a blue background, and the Z-axis section has a green background.

Tap X, Y, or Z in the toolbar on the left side to display or hide the corresponding axis.

Each axis section has its own properties that are grouped together.

Here are the groups and their properties:

  • Grid: Axis (X, Y, Z), Block, Group, Wings, and Width.
  • Layers: Fade From/To, Delay From/To, Speed From/To, and Phase From/To.
  • Shuffle: Shuffle and Shift.

Tap Grid, Layers, or Shuffle in the title bar to display or hide the corresponding group.

MAtricks tools in a window

The above is the MAtricks tools available in a window that can be created like any other window.

There is an overlay version of the window that can be opened by tapping MAtricks in the standard Encoder bar.

The two versions have the exact same buttons and options. Read the next topics for details about the different options.

Dimensions and Selection Grid

The MAtricks toolbar shows that there are a lot of settings that can be applied to X, Y, and Z. These are the three dimensions used by the Selection Grid.

This means that if the fixtures are in a 3-dimensional grid selection, then the MAtricks tool can be used in all three dimensions.

MAtricks Pool

The different settings that can be made in the MAtricks tool can be stored in the MAtricks Pool.

This pool can be created like any other window.

MAtricks pool with some store MAtricks

This pool works just like most pools in the grandMA3. The two most used functions are storing the MAtricks settings and recalling them.

Store a New Pool Object

This is the process for storing a MAtricks pool object.

The easiest way to do this is by long-pressing an empty pool object. This stores the current MAtricks settings (even no settings are stored).

The general syntax uses the Store keyword and the Matricks keyword: Store Matricks [number]

Simple example

This simple example uses ten fixtures.

Select the ten fixtures without any specific grid information. Press Full to turn the intensity on.

This is how it looks in the Selection Grid and the MAtricks window:

Ten fixtures without any MAtricks settings

These ten fixtures are now in one row on the X-axis.

Press Next. This is the same as tapping the + in the X setting.

Hint:
It is also possible to tap, hold, and slide your finger across any value area to change the value.

This is the result:

Ten fixture with X 0

Notice that the MAtricks is now active - the Active button in the title bar is On. This can be used to toggle the MAtricks tool On or Off without resetting the MAtricks settings.

The first fixture is now outputting lights, and the others are not. The selection frame around the first fixture is the usual yellow color. The rest have a darker yellow selection color. This indicates that they are part of the bigger selection and will output again if the MAtricks is turned Off or reset.

Try pressing Next to step through the selection. Pressing Prev (previous) goes through the selection in the opposite direction.

Notice how the X number in the MAtricks tool updates with the key presses. There is no difference between using the - and + buttons in the X-axis in the MAtricks tool or the keys.

A specific X number can be reached using the command line. For instance, if X needs to be 6, then the following command can be used:

User name[Fixture]>MAtricks 'X' 6

When you are comfortable with Next and Prev, then press Set.

The result is the same as tapping Reset in the MAtricks tool title bar and all fixtures again outputting light.

Multiple Selection

Each user profile has two different fixture selections called selection 1 and selection 2.

The current active selection can be seen and changed on the ActiveSel button in the MAtricks tool. Tapping this button changes between the two selections.

The selection can also be changed using the Selection keyword.

For example, the command needed to change to selection 2 is:

User name[Fixture]> Select Selection 2

A selection of fixtures can be copied from one to the other by tapping Copy Sel. It copies the currently active selection to the other.

Values can be cloned from one selection to the other by tapping Copy Values. This applies the values from the currently active selections to the other selection.

A ClearAll command clears both selections. ClearSelection only clears the active selection.

Shuffle Selection

The Shuffle keyword allows shuffling the selection order in a random sort.

By default, Shuffle will randomize the selection order on all 3 axes in the Selection Grid.

Each shuffle setting per axis can be set to a value from 0 (=None) up to 32 767. Each value represents a different shuffled selection order. When selecting the very same amount of fixtures, again and again, the same shuffle value will result in the same shuffled selection order. This can be useful when a specific nice shuffled selection order is desired for the same number of fixtures. In this case, apply the same shuffle value in the MAtricks when having the same number of fixtures selected. The fixtures are then shuffled the exact same way.

Tapping Shuffle in the MAtricks tool shuffles all three axes in the Selection Grid by adding a random number in XShuffle, YShuffle, and ZShuffle.

To shuffle on a single axis, enter a shuffle value for the desired axis in the MAtricks tool or tap the + or - in the axis until there is a wanted shuffle result.

On the right side of the MAtricks tool, there is a Shuffle Mode with three available modes:

  • Auto:
    When doing shuffle only for one dimension, this behaves like Linked. Shuffling on two or three axes behaves like Unlinked.
  • Linked:
    All fixtures that are placed on the same position along the axis that will be shuffled but have a different position on the other axis will keep their alignment along the other axis.
  • Unlinked:
    The fixtures placed on other axes than the axis that will be shuffled but have the same position on the shuffled axis will be shuffled independently.

Tap ShuffleMode to switch between these three modes.

Hint:
When deactivating or resetting the MAtricks, the original selection order will be restored.

Since the shuffle is part of the MAtricks, they are also stored in a MAtricks pool object like any other MAtricks setting.

See shuffle examples in the Shuffle topic.

Shift Selection

The shift setting in the MAtricks tool allows for shifting the current selection within the selection grid positions. This can be done per axis in the grid. Therefore, change the values for XShift, YShift or ZShift.
Positive values shift to the right (x-axis), to the bottom (y-axis), and the front (z-axis). According to this, negative values shift in the opposite direction.

Invert Options

Invert will define on which axis in the selection grid the values should be inverted when turning the encoder or applying a range of values.
The fixtures that will be inverted are displayed with a green font in the fixture sheet, a green body color in the 3D window, and a green border in the layout window and the selection grid window.

The following buttons can be found at the bottom left of the screen:

  • InvertStyle: Defines if Invert shall be applied to Pan, Tilt, Pan and Tilt, or All attributes. 
  • InvertX: Inverts the overall invert of the current individual inverts per MAtrick property on the X axis. 
  • InvertY: Inverts the overall invert of the current individual inverts per MAtrick property on the Y axis.
  • InvertZ: Inverts the overall invert of the current individual inverts per MAtrick property on the Z axis. 

Grid properties can also be inverted by tapping invert.

Hint:
When using Align in combination with Invert, the alignment is still based on the arrangement of fixtures inside the selection grid; however, the aligned values will be inverted.
 
Restriction:
At the moment, Align only works with the X axis.



Sub topics

Select different version