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

Create Macros

Table of contents of this topic

Macros are created using the GUI editor or the command line. Please read the Macros topic for a better understanding of macros.

 

Create from GUI (Pool)

Creating a macro using the GUI is very similar to editing the macros.

Requirement:

  • Have a Macro Pool visible on one of the screens.

This is the creation process:

  1. Edit an empty pool object - this automatically creates a new macro and opens the Editor.
  2. Tap the Insert New MacroLine button to add a row in the macro.
  3. Edit the Command field in the new row - this opens a text input pop-up.
  4. Write the command the macro row should perform.
  5. Edit the other fields in the row to match the needs (read the Macro topic for explanations).
  6. Repeat steps 2 through 5 to add several rows with commands to the macro.
  7. Close the editor when done.

There are several buttons at the bottom of the editor. This is a short explanation of the special buttons for this editor:

  • Name:
    Tap this to label a macro. Please read about label further down this topic.
  • Appearance:
    Tap this to add an appearance to the macro.
  • Scribble:
    Tap this to add a scribble to the macro.
  • Go:
    Tapping this executes the macro.
  • List References:
    Tapping this opens a pop-up with a list of objects that reference and depend on the macro.

The new macro pool object can be tapped to execute the macro.

The editor could look like this (the macro is the "World is Selection" macro from the library):

Macro editor with multi row macro

Create from Command Line

Macros can be added using the command line. This is relevant when the GUI is not available for instance when the software is accessed via command line only - for instance, using the terminal window.

To see the result in the command line feedback use the List command any time during the create process.

Requirement:

  • The command line feedback needs to be visible.

This is the creation process:

  1. Navigate to the macro part of the software:

User name[Fixture]>ChangeDestination Macro
  1. List the existing macros to see empty macro objects:

User name@ShowData/DataPools/Default/Macros>List
  1. Locate an available number (one that is not listed).
  2. Store a macro with the number:

User name@ShowData/DataPools/Default/Macros>Store [available_number]
  1. Navigate into the new macro:
User name@ShowData/DataPools/Default/Macros>ChangeDestination [available_number]
  1. Insert a line into the macro:
User name@ShowData/DataPools/Default/Macros/Macro #>Insert
  1. Add the command to the text field line number using the Set command:
User name@ShowData/DataPools/Default/Macros/Macro #>Set [line_number] Command "command inside quotations"
  1. The wait time can be set in the same manner as the text:
User name@ShowData/DataPools/Default/Macros/Macro #>Set [line_number] Wait "wait time"
Hint:
The wait time can be entered as a number in seconds without the quotation marks or as text with the quotation marks. The two special times called Follow and Go can be entered without the quotation marks, but the software will add the marks. They are case sensitive. Typing "go" gives an error. Typing "Go" works.
  1. Add more macro lines by repeating steps 6 through 8, but remember to use the correct line number with the Set command.
  2. Return to the root of the command line:
User name@ShowData/DataPools/Default/Macros/Macro #>ChangeDestination Root

Now there is a new macro that can be used.

Label a Macro

Macro pool objects are labeled like any pool object. Read more in the Label Pool Objects topic.

Remember that using unique names makes it possible to run the macros using their names.


Select different version