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
  - 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 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
    - /GridMergeMode
    - /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
    - Session master selection
  - 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
  - General parent.child structure
- 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?
  - Handle
  - Functions - Object-Free API
    - BuildDetails
    - CloseUndo
    - Cmd
    - CmdIndirect
    - CmdIndirectWait
    - CmdObj
    - Confirm
    - CreateUndo
    - DataPool
    - DefaultDisplayPositions
    - DeskLocked
    - Echo
    - ErrEcho
    - ErrPrintf
    - Export
    - ExportCSV
    - ExportJson
    - FromAddr
    - GetPath
    - GetShowFileStatus
    - GetSubfixture
    - GetSubfixtureCount
    - HandleToStr
    - HandleToInt
    - HookObjectChange
    - HostOS
    - HostSubType
    - HostType
    - Import
    - IntToHandle
    - MasterPool
    - MessageBox
    - ObjectList
    - Patch
    - PopupInput
    - Printf
    - ProgrammerPart
    - ProgressBar
    - Pult
    - Root
    - SelectedSequence
    - Selection
    - SelectionCount
    - SelectionFirst
    - SelectionNext
    - SerialNumber
    - ShowData
    - StrToHandle
    - ShowSettings
    - TextInput
    - Timer
    - UserVariables
    - Version
  - Functions - Object API
    - Addr
    - AddrNative
    - 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
  - 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
  - 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

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

Trackpad Window

Table of contents of this topic

hide

Mouse Mode
- Trackpad Mouse Cursor
- Trackpad Window Buttons in Mouse Mode
Pan/Tilt Mode

The trackpad window allows precise control of a mouse cursor as well as an alternate method for controlling the position of selected fixtures.

The trackpad window can appear within the user-defined area of screens 1 through 7. Views can store and recall the appearance and settings of the trackpad window. For more information on adding windows to the user-defined area, see the Add windows topic.

Tap the Mode button in the upper-right corner of the trackpad window to toggle between mouse mode and pan/tilt mode, or tap and swipe to see a menu of available modes.

Mouse Mode

Trackpad Mouse Cursor

While in mouse mode, tapping inside the main area of the trackpad window and swiping in any direction presents a dedicated cursor and moves that cursor in the direction of the swipe.

The main cursor in the user interface of the console appears as a black arrow with a white outline. This cursor is not affected by the trackpad window. A separate cursor appears when using the trackpad in mouse mode. The trackpad mouse cursor appears as a white arrow with a light gray outline.

The trackpad cursor initially appears slightly larger than normal. After three seconds, it reverts to its normal size. After five seconds of idle time, the trackpad cursor disappears.

The trackpad mouse cursor can move freely across the user interface of the console within screens 1 through 5. Although the trackpad window can appear on screen 6 and screen 7, the trackpad cursor cannot appear on these screens.

Trackpad Window Buttons in Mouse Mode

The main area of the trackpad window in mouse mode includes two buttons:

Left: Tap for a left mouse click. This selects the item under the point of the trackpad cursor. Tap and hold while swiping in the main area of the trackpad window with a second finger to mimic a 1 finger swipe gesture.
Right: Tap for a right mouse click. This generates the same result as a 2 finger edit gesture.

The title bar of the trackpad in mouse mode includes tools, which control the behavior of the trackpad. These tools include:

Reset Mouse: Tap to respawn the trackpad mouse cursor in the center of screen 1.
Tap for Click: When enabled, tapping anywhere in the main area of the trackpad window, except for the Right button, executes a left mouse click. When disabled, only a tap on the Left button executes a left mouse click.
Resolution: Tap to cycle through the available resolution options for the trackpad mouse, or tap and swipe to see a menu of available resolution options. This resolution setting is separate from the resolution setting in pan/tilt mode.

Pan/Tilt Mode

While in pan/tilt mode, horizontal swipes within the main area of the trackpad window adjust the pan attribute of any selected fixtures. Vertical swipes adjust the tilt attribute. Diagonal and curved swipes adjust both pan and tilt accordingly. The main area of the trackpad window in pan/tilt mode displays a simple grid as a visual guide.

The title bar of the trackpad in pan/tilt mode includes tools, which control the behavior of the trackpad. These tools include:

P/T Mode: Tap to cycle through the available pan/tilt modes, or tap and swipe to see a menu of available pan/tilt mode options. These options include:
- Pan Only: This mode only allows adjustment of the pan attribute, ignoring any vertical movement.
- Tilt Only: This mode only allows adjustment of the tilt attribute, ignoring any horizontal movement.
- Both: This mode allows simultaneous adjustment of both the pan and tilt attributes.
Invert Mode: Tap to cycle through the available invert modes, or tap and swipe to see a menu of available invert mode options. These options include:
- Off: Both pan and tilt are adjusted normally.
- Pan Invert: Pan inputs are interpreted in reverse of the normal direction. Tilt inputs remain normal.
- Tilt Invert: Tilt inputs are interpreted in reverse of the normal direction. Pan inputs remain normal.
- Both: Both pan and tilt inputs are interpreted in reverse of the normal direction.
Resolution: Tap to cycle through the available resolution options for the trackpad control of pan and tilt, or tap and swipe to see a menu of available resolution options. This resolution setting is separate from the resolution setting in mouse mode.

Hint:
The TrackpadMode, Mouse Resolution, P/T Resolution, P/T Invert Mode, and P/T Mode settings are also available in the Trackpad Window Settings pop-up. To open this pop-up, tap MA in the upper-left corner of the Trackpad window.