grandMA3 User Manual
- Introduction
  - About the manual
  - Symbols used in the manual
  - System requirements grandMA3 onPC
  - Installation of grandMA3 onPC
- Device Overview
  - grandMA3 console
  - grandMA3 replay unit
  - grandMA3 processing units
  - grandMA3 onPC command wing
  - Keys
    - Keys Overview
    - . [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
    - Dual encoders
    - Level wheel
    - Grand master
    - Executor elements
- 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 mouse and USB keyboard
  - Connect DMX
  - Connect Audio In
  - Connect SMPTE (LTC)
  - Connect Ethernet
  - Connect DC Remote In
  - Turn on the console the first time
- Show File Management
- Workspace
  - User interface
    - User-defined area
    - Command line
    - Control bar
    - View buttons
    - Grand master
    - Tables in general
  - Gestures
  - Command section
  - Master controls
  - Playback controls
  - Allocation of displays
  - Encoder bar
    - Feature group control bar
    - Encoder toolbar
  - Calculator
  - Colors
  - Icons
- Command Syntax and Keywords
  - General syntax rules
    - Object keywords
    - Function keywords
    - Helping keywords
  - All keywords
    - / [Slash]
    - . [Dot]
    - .. [DotDot]
    - <<< [GoFastBackward]
    - >>> [GoFastForward]
    - - [Minus]
    - * [Asterisk]
    - % [Percent]
    - + [Plus]
    - Absolute
    - Acceleration
    - Action
    - Align
    - AlignTransition
    - Appearance
    - Assign
    - At
    - Attribute
    - Black
    - Blind
    - BPM
    - Camera
    - ChangeDestination
    - Channel
    - ChannelSet
    - Chat
    - Clear
    - ClearActive
    - ClearAll
    - ClearSelection
    - CmdDelay
    - Configuration
    - Console
    - Copy
    - Cue
    - CueDelay
    - CueFade
    - CueInDelay
    - CueInFade
    - CueOutDelay
    - CueOutFade
    - Cut
    - DataPool
    - Decimal8
    - Decimal24
    - Default
    - Delay
    - Delete
    - DelGlobalVar
    - DelUserVar
    - Dismiss
    - DMXUniverse
    - Down
    - Drive
    - Echo
    - Edit
    - EditOption
    - Eject
    - Effect
    - EndIf
    - Escape
    - Exchange
    - Executor
    - Export
    - Extract
    - FaderMaster
    - FaderRate
    - FaderSpeed
    - FaderTemp
    - FaderX
    - FeatureGroup
    - Filter
    - Fix
    - Fixture
    - Flip
    - Flash
    - Fog
    - Freeze
    - Full
    - Gel
    - GetGlobalVar
    - GetUserVar
    - Global
    - Go-
    - Goto
    - Grid
    - Group
    - Help
    - Hex8
    - Hex24
    - Highlight
    - Houselights
    - Hz
    - If
    - Insert
    - Integrate
    - Interface
    - Invite
    - Join
    - Label
    - Layout
    - Leave
    - Library
    - List
    - ListRef
    - Load
    - Loaded
    - LoadShow
    - Lock
    - Login
    - Logout
    - Macro
    - Master
    - Media
    - Move
    - NewShow
    - Next
    - Node
    - NonDim
    - Normal
    - Off
    - On
    - OnPC
    - OSC
    - Oops
    - Page
    - Part
    - Park
    - Paste
    - Patch
    - Pause
    - Percent
    - PercentFine
    - Phase
    - Physical
    - Plugin
    - Preset
    - Press
    - Previous
    - Programmer
    - PU
    - Pyro
    - Rate1
    - Readout
    - Reboot
    - Recast
    - Relative
    - Release
    - ReloadUI
    - Remove
    - Reset
    - Restart
    - SaveShow
    - Scribble
    - Seconds
    - Select
    - Selection
    - SelFix
    - Sequence
    - SendOSC
    - Set
    - SetGlobalVar
    - SetUserVar
    - Shutdown
    - SnapDelay
    - Solo
    - Station
    - Step
    - Stomp
    - Store
    - Temp
    - Thru
    - Top
    - Transition
    - Unlock
    - Unpark
    - Unpress
    - Up
    - Update
    - User1
    - User2
    - User
    - Version
    - View
    - Width
    - Wing
    - World
    - Zero
- Windows, Views, and Menus
  - Add windows
  - 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
    - Leave a session
    - Invite to a session
    - Dismiss from session
    - Create a custom key
- DMX In and Out
  - DMX port configuration
  - Ethernet DMX
    - Art-Net menu
    - sACN menu
- Single User and Multi User Systems
  - Create User
  - User settings
- Patch and Fixture Setup
  - What are fixtures
  - Add fixtures to the show
  - Live patch
  - DMX sheet
  - Remove fixtures from the show
  - Position fixtures in the 3D space
  - 3D Window
  - Camera Pool
  - Stages
  - Classes and Layers
  - Attribute definitions
    - Activation group
    - Feature group
- Operate Fixtures
  - What is the programmer
  - Fixture sheet
  - Using the color picker
  - Align
  - Selection window
- Scribbles
  - Create scribbles
  - Edit scribbles
  - Assign scribbles
  - Delete scribbles
- Images
  - Screenshots
- Appearance
  - Create appearances
  - Use appearances
  - Delete appearances
- Groups
  - Create groups
  - Edit groups
  - Delete groups
  - Group masters
- Presets
  - Preset pools
  - Create presets
  - Assign input filter
  - Edit presets
  - Update presets
  - Preset pool settings
  - Embedded presets
  - Store values of multi steps
  - Delete presets
- Worlds and Filters
  - At filter
  - Create a world
  - Create a filter
  - Use a world or filter
  - Delete a world
  - Delete a filter
- Cues and Sequences
  - What is tracking
  - Look at cues and sequences
  - Sequence settings
  - Store cues
  - Store options and preferences
  - Play back cues
  - Cue timing
- Executors
  - Assign object to an executor
  - Executor configurations
  - Running playbacks
- Phasers
  - Step bar
  - Phaser editor
  - Create sinus dimmer phaser
- Macros
  - Create macros
  - Edit macros
  - Assign macros to keys and buttons
- Timecode
  - Toggle view mode
  - What are timecode slots
- Layouts
  - Create a layout
  - Layout pool settings
  - Edit layout
  - Layout view settings
  - Edit layout view
  - Edit layout elements
- System Information
  - Date and time
  - Clock
  - System info
- Update the Software
  - Update grandMA3 consoles
  - Update grandMA3 xport nodes
- 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
grandMA3 Quick Manual consoles
grandMA3 Quick Manual processing
grandMA3 Quick Manual nodes
grandMA3 Quick Manual DIN-Rail
grandMA3 Quick Manual onPC solutions
Release Notes

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.0

Macros

Table of contents of this topic

hide

What are Macros
Macro Pool
Elements in a Macro
Import Macro Library

What are Macros

Macros are commands stored in a pool object.

The commands can be simple, very complex, and everything in between.

Macros can make programming faster and more convenient. Macros make it possible to do trivial or complex operations by a push of a button.

See the Examples topic to see what macros can be used for.

Macro Pool

Macros are stored in the Macro Pool but can be assigned to physical keys and view buttons. The macro pool is shared between all users in the show file. This means that if UserA stores a macro on pool object number 10, then it will also be available for UserB as macro number 10.

The Macro Pool could look like this:

Elements in a Macro

A macro consists of one or more rows.

Each row has information about a Command the row executes.

Each row has several fields that specify how the row is handled.

The Wait field can add a wait time before moving to the next row in the macro. This wait time is added after the command in the row is executed. It is relevant if there is more than one row in a macro. The first row will execute, it will wait the specified time and then execute the next row. There are two special wait commands. They are not a time value but a special value.

Follow: This is the same as having a wait time of 0. The next row will be executed as soon as this row has executed the command.
Go: This special value pauses the macro at this row. The macro is paused until it receives a new Go command.

The Enabled field indicates if the row is enabled. This is a Yes or No field. If it is Yes then it is executed when the macro row is triggered.

The AddToCmdline function makes it possible to append the command from the macro line to exiting content in the command line. This is a Yes or No field. If it is Yes then it is appended to the command line.

Execute field defines if the macro row is automatically executed. Yes means that the row is executed (automatic please at the end of the row). No will put the command in the command line ready for user interaction.

Import Macro Library

There is a factory library of macros that can be imported using the import command.

Read more about importing in the Import Keyword topic.