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
    - 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
  - Clean start
- 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
  - All keywords
    - ; [Semicolon]
    - / [Slash]
    - . [Dot]
    - .. [DotDot]
    - = [Equal]
    - <<< [GoFastBackward]
    - >>> [GoFastForward]
    - - [Minus]
    - * [Asterisk]
    - % [Percent]
    - + [Plus]
    - Absolute
    - Acceleration
    - Action
    - ActivationGroup
    - Align
    - AlignTransition
    - Appearance
    - Assign
    - At
    - Attribute
    - Black
    - Blind
    - Block
    - BPM
    - Call
    - Camera
    - Capture
    - Certificate
    - ChangeDestination
    - Channel
    - ChannelSet
    - Chat
    - Cleanup
    - Clear
    - ClearActive
    - ClearAll
    - ClearSelection
    - Clone
    - CmdDelay
    - ColorTheme
    - Configuration
    - Console
    - Cook
    - Copy
    - Cue
    - CueAbs
    - CueDelay
    - CueFade
    - CueInDelay
    - CueInFade
    - CueOutDelay
    - CueOutFade
    - CueRel
    - CurrentUser
    - CurrentUserProfile
    - Cut
    - DataPool
    - Deceleration
    - Decimal8
    - Decimal16
    - Decimal24
    - Default
    - Delay
    - Delete
    - DelGlobalVar
    - DelUserVar
    - Dismiss
    - Display
    - DMXAddress
    - DMXReadout
    - DMXUniverse
    - Down
    - Drive
    - Echo
    - Edit
    - EditSetting
    - Eject
    - Effect
    - EndIf
    - Exchange
    - Executor
    - Export
    - Extract
    - Extension
    - Fade
    - Fader
    - FaderHighlight
    - FaderLowlight
    - FaderMaster
    - FaderRate
    - FaderSolo
    - FaderSpeed
    - FaderTemp
    - FaderTime
    - FaderX
    - FaderXA
    - FaderXB
    - FeatureGroup
    - Filter
    - Fix
    - Fixture
    - FixtureType
    - Flip
    - Flash
    - Fog
    - Font
    - Freeze
    - Full
    - Gel
    - GetGlobalVar
    - GetUserVar
    - Universal
    - Go+
    - GoStep
    - Go-
    - Goto
    - Grid
    - Group
    - 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
    - LearnRate
    - LearnSpeed
    - LeaveSession
    - Library
    - List
    - ListOwner
    - ListRef
    - Load
    - Loaded
    - LoadShow
    - Lock
    - Login
    - Logout
    - Lowlight
    - Lua
    - LuaFile
    - Macro
    - Master
    - MAtricks
    - Media
    - Menu
    - Mesh3DS
    - MessageCenter
    - Monitor
    - Move
    - MyRunningMacro
    - MyRunningSequence
    - NewShow
    - Next
    - Node
    - NonDim
    - Normal
    - Off
    - On
    - OnPC
    - OSC
    - Oops
    - Output
    - OutputLayer
    - Page
    - Part
    - Park
    - Paste
    - Patch
    - Pause
    - Percent
    - PercentFine
    - Phase
    - Physical
    - Plugin
    - Preset
    - PresetUpdate
    - Press
    - Preview
    - Previous
    - Programmer
    - Property
    - PU
    - Pyro
    - Rate1
    - Readout
    - Reboot
    - Recast
    - Relation
    - Relative
    - Release
    - ReloadPlugins
    - ReloadUI
    - Remote
    - RemoteHID
    - RemoteCommand
    - Remove
    - Reset
    - Restart
    - Root
    - RTChannel
    - RunningMacro
    - RunningSequence
    - SaveShow
    - ScreenConfig
    - ScreenContent
    - Scribble
    - Seconds
    - Select
    - Selection
    - SelFix
    - Sequence
    - SendOSC
    - Set
    - SetGlobalVar
    - SetUserVar
    - Shuffle
    - Shutdown
    - SnapDelay
    - SoftwareUpdate
    - SoundChannel
    - Solo
    - SpecialExecutor
    - Speed
    - Speed1
    - Stage
    - Station
    - Step
    - Stomp
    - Store
    - Temp
    - Texture
    - Thru
    - Time
    - Timecode
    - TimecodeSlot
    - Toggle
    - Top
    - Transition
    - Type
    - UIChannel
    - UiGridSelection
    - Unblock
    - Unlock
    - Unpark
    - Unpress
    - Up
    - Update
    - UpdateContent
    - User1
    - User2
    - User
    - UserProfile
    - Video
    - Version
    - View
    - ViewButton
    - Width
    - World
    - Xkeys
    - Zero
  - 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
  - SFTP connection
- 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
  - MVR
  - Live patch
  - DMX sheet
  - DMX universes
  - Remove fixtures from the show
  - Position fixtures in the 3D space
  - Marker fixture
  - 3D window
  - Camera Pool
  - Stages
  - Classes and Layers
  - Attribute definitions
    - Activation group
    - Feature group
  - Parameter list
  - DMX curves
- Operate Fixtures
  - What is the programmer
  - Fixture sheet
  - Encoder resolution
  - Using the color picker
  - Selection bar
  - Align
  - Selection Grid
  - Smart view
- Scribbles
  - Create scribbles
  - Edit scribbles
  - Assign scribbles
  - Delete scribbles
- Images
  - Screenshots
- 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
- Cues and Sequences
  - What is tracking
  - Look at cues and sequences
  - 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
- Phasers
  - Step bar
  - Phaser editor
  - Create sinus dimmer phaser
  - Create circle phaser
  - Create circle phaser around position
  - Create color rainbow phaser
- Macros
  - Create macros
  - Edit macros
  - Assign macros to keys and buttons
  - Examples
- Agenda
  - Agenda modes
  - Create an agenda entry
  - Edit an agenda entry
  - Agenda toolbar
  - Agenda edit menu
- 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
  - Edit layout
  - Layout view settings
  - Edit layout view
  - Edit layout elements
  - Layout encoder bar
- Plugins
  - What is Lua?
  - Lua functions
    - Object-Free API
      - Cmd
      - CmdIndirect
      - CmdIndirectWait
      - CmdObj
      - Confirm
      - DataPool
      - Echo
      - ErrPrintf
      - ErrEcho
      - Export
      - GetPath
      - GetShowFileStatus
      - GetSubfixture
      - GetSubfixtureCount
      - HookObjectChange
      - HostOS
      - HostSubType
      - HostType
      - Import
      - MessageBox
      - ObjectList
      - PopupInput
      - Printf
      - ProgressBar
      - SelectedSequence
      - SelectionCount
      - SelectionFirst
      - SerialNumber
      - SelectionNext
      - TextInput
      - Timer
      - UserVariables
      - Version
    - Object API
      - Children
      - Export
      - HasActivePlayback
      - Import
      - ToAddr
- Data Pools
- System
  - Date and time
  - Clock
  - Desk lights
  - System information
  - System monitor
  - Info Window
- 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
  - 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
  - Import / Export Menu
  - Folder Structure
- Shut down the System
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.6

Import GDTF

Table of contents of this topic

hide

Import GDTF in the grandMA3 Console
Import GDTF in the grandMA3 onPC

In grandMA3, it is possible to import a GDTF file (General Device Type Format) that contains the description of a fixture type.

The GDTF file is a zip file containing:

Description
Geometry data
Gobo images

For a detailed description of GDTF, see this tutorial gdtf-share.com/wiki/GDTF_File_Tutorial and gdtf-share.com/wiki/GDTF_File_Description.

Import GDTF in the grandMA3 Console

Download the GDTF file on www.gdtf-share.com.
The file is located in the download folder.
Copy the GDTF file to a USB flash drive. The default path for GDTF fixture types is: /grandMA3/gma3_library/fixturetypes/gdtf
Insert the USB flash drive into the console.
Open the patch dialog and tap Fixture Types.
Tap Import.
The Select Fixture Type to Import pop-up opens.

Tap the library button GDTF.
The button is highlighted in yellow.
In the upper right corner of the title bar, select the USB flash drive that contains the GDTF files.
Select the fixture type you wish to import.
Tap Import.

The fixture is imported to the fixture type list and can now be patched.

For more information on how to patch, see Add Fixtures to the Show.

To learn how to import fixtures from the online garandMA3 Fixture Share and the GDTF Share libraries, see Import GDTF.

Hint:
You can proceed the same way to import a GDTF file to grandMA3 onPC if you insert a USB flash drive in the computer running the grandMA3 onPC software. If you want to import GDTF files to your computer's hard drive, see the following topic Import GDTF in grandMA3 onPC.

Import GDTF in the grandMA3 onPC

Follow steps 1 and 2 described in Import GDTF in the grandMA3 Console.
Copy the GDTF file to the appropriate folder on the hard drive. The default GDTF folder is found along the following path from the main MALightingTechnology folder: MALightingTechnology/gma3_library/fixturetypes/gdtf
For more information on the default folder structure and where to find the main MALightingTechnology folder, see the Folder Structure topic.
Open the patch dialog.
Tap Fixture Types.
Tap Import.
Select Fixture Type to Import pop-up opens.

Select Internal in the upper right corner of the title bar.
Select a fixture type and tap Import.

The fixture is imported to the fixture type list and can now be patched.