grandMA 3D is a unique new user interface, created for the visualization of three dimensional stage layouts to be utilized in conjunction with the grandMA product range. Series I and series II desks are supported.

The software is designed as a pre-programming tool for light designers. It simplifies the process of creating shows to save time and money.

grandMA 3D includes a library of basic graphical elements. Multiple windows with front/side/top view can be opened and updated at the same time. All the stage elements can be positioned in x/y/z directions and may also be rotated around the various axes. Custom textures for the surface of these elements can be imported in a bitmap format or may be chosen from a library.

The setup of lanterns, luminaries or moving lights can be simply retrieved from the grandMA console’s or grandMA onPC show file per electronic transfer. There is no need to set DMX lines, DMX addresses or operation modes for the single fixtures, as these details are already pre-adjusted in the grandMA.

When switching to 3D rendering mode, the grandMA 3D software becomes an extremely powerful visualizer with real time rendering facilities. All drawing elements, fixtures and lanterns are shown with surface textures, as a kind of virtual reality. All functions of the installed lights are remotely controlled by a connected grandMA desk and onPC and displayed with realistic movements, colors and images. At the same time the viewing angle can be changed by just moving the virtual camera around with full control of zoom, position and rotation. Or just switch to another pre-defined camera position and start a new movement from there.

Several optical fixture parameters, like beam angle, color (even color mixing) and gobos can be displayed. Custom gobos can be inserted by simply assigning a color bitmap file to the gobo position of the related fixture.

All the show data can later be received "online" from the grandMA desk or onPC and displayed in real time rendering. It may also be recorded live and converted into one of the standard video compression formats. These files can be easily viewed on any personal computer or MAC with standard media player software and may even be sent by e-mail.

Go to the next chapter:

• System Requirements

• ­­IBM® compatible PC or notebook with 2GHz processor with at least 1 GB RAM
• Ethernet card
• High-speed 3D graphics card with hardware acceleration:
  • at least 512 MB video memory e.g. NVIDEA 9800 GTX
  • vertex shader >= 3.0
  • pixel shader >= 3.0
• 1024x768 pixel resolution or above
• 500 MB available disk space on hard disk
• Microsoft Windows® XP (recommended) or Windows Vista® operation system with latest service pack
• Microsoft DirectX® version 9 or above
• grandMA console or grandMA onPC (both series 1 or 2 are supported)

Go to the next chapter:

• Installation

The actual version of the application can be downloaded from the MA Lighting support site:

http://www.malighting.de

Please extract the downloaded file into a temporary folder and run the 'Setup’ (gMA3D_xxx.exe) program.

See Chapter:

• Version of grandMA desk or grandMA on PC
• IP Addresses
• Connection with the grandMA desk
• grandMA 1 or grandMA 2 mode

Go to the next chapter:

• Data Management

You can determine by means of the version number of grandMA 3D if the software version of the visualizer fits to the software version of the desk or off-line.

grandMA 3D version number can be determined via:

• Filename of the setup:

  gMA3D_[{GMA2-Streaming}][{GMA1-Streaming}]_v{3D-Version}

• Splash screen (apperars while startup)
• Info box (Menu - Help - Info)
• Version info of '.exe’ file (right click on grandMA3D.exe - Version - Comment)

Example: grandMA3D_[1][6.0]_v6.1.0.0

.

1	.	.	GMA2-Streaming Version	.	.	This number should correspond to the grandMA 2 onPC streaming version
.	.	.	.	.	.	.
6.0	.	.	GMA1-Streaming Version	.	.	This number should correspond to the grandMA 1 onPC streaming version
.	.	.	.	.	.	.
v6.1.0.0	.	.	Version of grandMA 3D	.	.	.

.

The grandMA onPC software can run on the same PC or on an external PC connected via Ethernet.

Go back to chapter:

• Installation

Go to following chapter:

• IP Addresses
• Connection with the grandMA desk
• grandMA 1 or grandMA 2 mode

IP addresses are what allow the internet and most modern networks to work. It’s a way of identifying a computer by a unique set of numbers (an IP address). An IP address is made up of a set of four numbers. Each number can have a value between 0 and 255. IP adresses can be set via the network settings of the Windows system settings.grandMA 3D has to be restarted if the settings are changed. New adresses are read with the restart of grandMA 3D.

Your PC and the console must have their respective IP addresses set up correctly.

The first three sets of numbers must be the same and the last set must be different.

Example:

Go back to chapter:

• Installation
• Version of grandMA desk or grandMA on PC

Go to following chapter:

• Connection with the grandMA desk
• grandMA 1 or grandMA 2 mode

Please make sure, that the program version of the grandMA desk meets the specifications described in: Version of grandMA desk or grandMA onPC.

For communication you have to connect the PC with the grand MA console or another PC running the grandMA onPC.

You can do this directly with a patch crossover cable with two RJ-45 connectors or via a network switch.

grandMA II Console	RJ 45 Cable or Switch	grandMA 3D Computer

If you use a network with a switch, connect the PC with a regular patch network cable to the switch.

• Connect the cable to the desk.
• Start the desk and load a show
• Start a new session at the desk
• Start the grandMA 3D application and join the session or invite the 3D from the desk

The application connects to the desk and receives the data of the current show. The received show will be visualized.If you do not get a connection to the desk, make sure that grandMA 3D has the right IP address as described in 'IP Addresses’ and that the corresponding mode: grandMA 1 or grandMA 2 set accurate.

Go back to chapter:

• Installation
• Version of grandMA desk or grandMA PC
• IP Addresses

Go to following chapter:

• grandMA 1 or grandMA 2 mode

grandMA 3D supports series 1 and series 2 consoles. To switch between these modes it has to be restarted in the desired mode. This can be done via the menu entry 'File - Restart in series x Mode’. The actual mode is displayed in the Stage view, the session window and the Info Box (Menu - Help - Info).

Go back to chapter:

• Installation
• Version of grandMA desk or grandMA PC
• IP Addresses
• Connection with the grandMA desk

Go to the next chapter:

• Data Management

This section describes how data is managed by the desk and the 3D visualizer.Desk and visualizer software can work independently. Each package can be operated standalone. If they are connected in a MA network session the desk gets the master and 3D becomes the slave of a session. Data changed within 3D is transferred to the desk and vice versa. 3D and the desk use the same file format for show files (.gz files) in grandMA 2 mode.

.

See Chapter:

• Master/Slave
• Coordinate system

Go to the next chapter:

• Quick Start

The MA console or onPC is always the master of a session.Only if 3D is started as standalone it will be the master. If a desk is connected and a session is started within the 3D the 3D show file will be transferred to the desk and then this becomes the master. So the synchronization of desk and 3D data is guaranteed.The three possible states of the connection are indicated by the heart in the status bar. The blinking of the heart indicates the communication between the desk and grandMA 3D.

	Heart is broken and red: No connection to a session established
.	.
	Heart is blinking green: grandMA 3D has joined a session as slave
.	.
	Heart is blinking blue: GrandMA 3D has the Master function of a session. The creation of a session with grandMA 3D can be used to transfer all data of a show to a desk or onPC. If the loading is completed, the desk automatic becomes the master and grandMA 3D gets the slave.

ATTENTION: With the start of a new session (Create) the session founder overwrites all data of the other members. I.e. if a new session is founded by the grandMA 3D all data in the desk will be overwritten!Because the 3D file contains all data it may be helpful to use the 3D as backup. Therefore the 3D is started with the backup show as master and the desk is invited to the session.

Go back to chapter:

• Data Management

Go to following chapter:

• Coordinate System

GrandMA 3D geometric system lets you define and manipulate objects in 3D space. It features a geometric system architecture that defines the X-Y plane as the ground area with the height as Z -axis. All objects can be moved or rotated along the world- or their own object axis (if the object has been rotated) as described in chapter Stage View. You can switch between the world or object axis via a toolbar button or the keyboard as shown in the following list:

Operating Elements	Symbols in 3D View		Description
World axis or Ctrl + W			Objects can be moved along the world axis.
.			Objects can be rotated along the world axis.
.	.	.	.
Object axis or Ctrl +O			Objects can be moved along the object axis.
.			Objects can be rotated along the object axis.

Go back to chapter:

• Data Management
• Master/Slave

Go to the next chapter:

• Quick Start

This chapter is a quick tutorial how to start a session at the desk and connect the 3D.

Coming soon.

Go to the next chapter:

• Program Surface

After starting the program the following screen appears. Normally the windows are arranged in the following layout:

.	Menu Bar | Tool Bar
Main Windows 3D Objects Stage Views		Tool Windows Assets Cameras…Property Window
.	Tool Windows Media Database Materials …Status Bar	.
.	.	.

	To arrange your own layout select the window and drag it while holding the left mouse button. A 'guide diamond’ appears. The arrows of the diamond show the possible positions. Move the pointer to the desired new position of the 'guide diamond’ and release the mouse button.You can save or load these settings in a separate file via the menu entry: 'View - Window Layout - Save… / Load…’.The menu entry: 'View - Window Layout - Reset Window Layout’ resets all windows to their default positions.
	When not in use you can 'Auto Hide’ a Window via the pushpin.

See Chapter:

• Menu Bar
• Tool Bar
• Main Windows
• Assets (Information Window)
• Properties
• Media Database
• Materials
• Moving Pathes
• Sessions
• Status Bar

Go to the next chapter:

• Fixture Types

Underlined characters mark the keyboard shortcuts pressed simultaneously with the 'Alt’ key.

	Description
New Show	A new show will be created.
.	.
Load Show...	Load an existing show from file e.g. 'showname.gz’.
.	.
Save Show	Saves the current show with the given filename.
.	.
Save Show as…...	Save the current show with a new filename.
.	.
Import... …	Import a 3D model. This model for example a venue will be added to the showfile. At the moment the .3ds format (3ds Max known as 3D Studio Max) is supported. See: 3D Modeling and Import.
.	.
Settings…	Opens the grandMA 3D Settings dialog.Within this dialog you can vary the settings for the several output modes and get information about the used plugins.Also you can change the IP address of the 3D.	.
.	.	.
Restart with grandMA1 Network	Restarts grandMA 3D in MA1 mode to connect with a grandMA 1
.	.
Restart with grandMA2 Network	Restarts grandMA 3D in MA2 mode.
.	.
Exit	Leave the grandMA 3D program.
.	.
.	.

		Description
Oops: (Undo)	.	Last action is undone.
.	.	.
Cut	.	Cuts the selected object (to clipboard).
.	.	.
Copy	.	Copies the selected object to clipboard (expect 3D objects).
.	.	.
Paste	.	Pastes the object from clipboard into the view.
.	.	.
Delete: selected elements	.	Deletes the actual selected elements.
.	.	.
Reset selected Objects	.	Sets the selected elements to the origin, 0,0,0.
.	.	.
Select All	.	Selects all objects in view.
.	.	.
Select Parent	.	Selects the parent object.
.	.	.
Select Children	.	Selects only the children of the selected object.
.	.	.
Select Next Object	.	Select the next object.
.	.	.
Select Previous Object	.	Selects the previous object.
.	.	.
Simple Duplicate	.	Makes a simple duplicate of the selected object.
.	.	.
Add Group Object	.	Adds a new object to build a group.
.	.	.
Group Selected Objects	.	Creates a new object and adds all selected objects.
.	.	.
Rename	.	Rename the selected object.
.	.	.
Move (Mode)	.	Switch to move mode.
.	.	.
Rotate (Mode)	.	Switch to rotation mode.
.	.	.
Follow (Mode)	.	Switch to follow spot mode
.	.	.
Object Axis (Mode)	.	Move or rotate along the axis of the object.
.	.	.
World Axis (Mode)	.	Move or rotate along the world axis.
.	.	.
Previous	.	Selects the previous selected object.
.	.	.
Next	.	If Previous was pressed the next object will be selected.
.	.	.
.	.	.

		Description
Arrangement	.	Opens the arrangement window to arrange objects in several orders as described in chapter: '4.3.3 Arrangement of Objects (Align Objects)’.
.	.	.
Duplicate	.	Opens the duplicate window to clone objects as described in chapter: '4.3.4 Duplicate (copy 3D Objects)’.
.	.	.
Change Model…	.	Opens a dialog to change an existing 3D model.
.	.	.
.	.	.

		Description
Change user	.	Opens a dialog to change the user of the session.
.	.	.
Create Session	.	Creates a new session in MA network.
.	.	.
Join Session	.	Joins to a session in MA network.The session has to be selected in the 'Sessions’ window described in '4.8 Sessions’
.	.	.
Leave Session	.	Leaves the running session in MA network.
.	.	.
Allow Invite	.	Allows the master of the MA session to do an automatic invitation of the 3D to the session.
.	.	.
Sync Selection	.	If this function is switched on, the selection of fixtures between desk and 3D is synchronized. I.e. if fixtures are selected within 3D the selection is also highlighted at the desk and vice versa.
.	.	.
Follow Into Blind	.	If selected 3D follows into the blind mode.
.	.	.
Take Simple Screenshot…	.	Opens a dialog to take a screenshot of the Stage View.Images can be saved as .png files.
.	.	.
Diagnostics	.	Several diagnostic options if problems occur.You can save the diagnostics output and mail it to the MA customer support to solve the problems.
Diagnostics Window	.	.
Save Diagnostics As…	.	.
Mail Diagnostics	.	.
Refresh Diagnostics	.	.
.	.	.
.	.	.

		Description
Fullscreen	.	Switch to the full screen view (Toggle with 'Alt + Enter’)
.	.	.
Open New Stage View	.	Opens a new view for a stage window
.	.	.
Assets Window	.	Opens the Assets Window (tree view of objects)
.	.	.
3D Objects Window	.	Switch to the 3D Objects window
.	.	.
Materials Window	.	Opens the Materials window
.	.	.
Media Database Window	.	Opens the Materials window
.	.	.
Cameras	.	Several options for camera settings to:
Add Front Camera	.	- Add new 3D cameras
Add…	.	- Same with other camera…
Add Front 2D View (2D)	.	- Add new 2D cameras
Add at Current Position	.	- Add new camera at the current position
Use Selected	.	- Switch to the currently selected camera
Cameras Visible	.	- Make the cameras visible as 3D objects
Camera Spanning	.	- Span cameras in Stage Views see: chapter 4.2 Tool Bar - Camera Spanning
Cameras Window	.	- Open a property window for the cameras
.	.	.
Properties Window	.	Opens Property windows for Assets, Cameras etc..
.	.	.
Sessions Window	.	Opens Session window.
.	.	.
Diagnostics Window	.	Opens Diagnostics window to analyze problems.
.	.	.
Screenshots	.	Opens a window to take screenshots.
.	.	.
Open GMA2 Commandline	.	Opens a window to enter desk commands via command line.
.	.	.
Render Info	.	Switches the render information in the Stage View on/off
.	.	.
Help Elements Visible	.	Help elements in Stage View like X,Y,Z axis on/off
.	.	.
Window Layout	.	Load or save a personalized window layout from / to fileor reset the layout to the default setting.
Load Window Layout…	.	.
Save Window Layout…	.	.
Reset Window Layout	.	.
.	.	.
Optimize Columns	.	Set the columns in the 3D Objects grid to optimal size.
.	.	.
Units	.	Sizes of elements can be displayed with their dimensions e.g. x = 1.00 meter or x = 1° (means 100 % of original value)
Size as Dimensions	.	Sizes are scaled in meter, inch etc.
Size as Scaling Factor	.	Sizes are scaled in % of the original size.
.	.	.
Lock	.	Lock / unlock the current window
.	.	.
Refresh Element	.	Refresh the elements in the view.
.	.	.
Go To	.	Select the previous (last selected) or next (if previous was selected before) element.
Previous	.	.
Next	.	.

		Description
Documentation	.	Opens a document with the help file.
Release Notes	.	Opens a document with the actual release notes.
Info	.	Opens an information window with version numbers of 3D and desk streaming version.
.	.	.

Go back to chapter:

• Program Surface

Go to following Chapter:

• Tool Bar
• Main Windows
• Assets (Information Window)
• Properties
• Media Database
• Materials
• Moving Pathes
• Sessions
• Status Bar

	Previous, Next	.	Select the previous or next object.
.	.	.	.
	Load Show	.	Open a dialog to load a new show.
.	.	.	.
	Save Show	.	Saves the current show with the given filename.
.	.	.	.
	Oops	.	(Undo, Redo) Recovers the previous action or vice versa
.	.	.	.
	Fullscreen	.	Switch to the full screen view. Toggle with 'Alt + Enter’ key.
.	.	.	.
	New Stage Window	.	Opens a new Stage View window.
.	.	.	.
	Camera Visible	.	Sets the cameras to visible in the 3D view.

	Camera Spanning	Span the camera view over several Stage View windows. So you can space a view from one camera on several monitors.
.	.	.
	Rendering	Settings for 3D renderings: Set the parameters for the 3D rendering output.Choose your preferred settings by shifting the sliders. The results can be checked immediately in the Stage View window.

Go back to chapter:

• Program Surface
• Menu Bar

Go to following Chapter:

• Main Windows
• Assets (Information Windows)
• Properties
• Media Database
• Materials
• Moving Pathes
• Sessions
• Status Bar

Main windows are represented as tabbed windows:

Go back to chapter:

• Program Surface
• Menu Bar
• Tool Bar

View subchapter:

• Stage View
• Mouse + Keyboard Actions
• Arrangement of Objects (Align Objects)
• Duplicate (Copy 3D Objects)
• 3D Objects

Go to following chapter:

• Assets (Information Window)
• Properties
• Media Database
• Materials
• Moving Pathes
• Sessions
• Status Bar

The Stage View Window offers a photorealistic view from any camera perspectiveor a 2D draft view:

Stage View 3D	Stage View2D
.	.

	If the menu entry 'View - Render Info’ is selected information about the frame rate (in Frames Per Second), the window size (in pixels) and the selected camera are shown.
.	.
.	.

Go to following subchapter:

• Mouse + Keyboard Actions
• Arrangement of Objects (Align Objects)
• Duplicate (copy 3D Objects)
• 3D Objects

Back to the mainchapter:

• Main Windows

	Generally:
+	left mouse button actions for objects,
	right mouse button actions for camera
.	.

	Left Mouse Button: Moving and Rotating of Objects
.	.
.	.

World axis Ctrl + W	.	Object Axis Ctrl + O	.	Objects can be moved or rotated along the world-or their own axis. Hold the left mouse button down to change between Move and Rotate and vice versa.
	.		.	- Select the object
.	.	.	.	- Move ore rotate it along the selected axis

			Left mouse button down to move object along world or object axis
			Left mouse button down to rotate objectaround world or object axis

	Right Mouse Button: Context Menu + Camera Actions

	Short right mouse click Menu for selecting, renaming deleting duplicating or grouping selected object
	Right mouse button down Select action with scroll wheel or 'Shift + Ctrl’

	Middle Mouse Button: Select Camera or Zoom

	Mouse wheel click After that Set camera for this view via the mouse wheel turn or keyboard space or 1…9..0 button
.	Mouse wheel turnZoom in or out
.	.
.	.

Back to subchapter:

• Stage View

Go to subchapter:

• Arrangement of Objects (Align Objects)
• Duplicate (Copy 3D Objects)
• 3D Objects

Back to the mainchapter:

• Main Windows

grandMA 3D allows automatic arrangement of 3D objects. Therefore select the objects to arrange via 'Ctrl + mouse click’ or multiple selections in the assets tree. Via the menu entry 'Functions - Arrangement’ the Arrangement Window opens:

	Objects can be arranged in several ways like:- Moved along the X,Y,Z axis- Moved along a circle line in X,Y,Z space- Arrange in a 2D matrixCorresponding to the desk alignment function objects can be arranged in relation to the origin object like:- <, >, ><, and <>If the 'Relative’ flag is set every push of the 'Apply’ button increments the arrangement by the given value. Note: The origin is 0,0,0 if the 'Relative’ flag is off. Otherwise it is the own position
	Example:Several objects inserted into the Stage Viewat the origin (0,0,0).
	Objects aligned via 'Move’ and 'Align <’ function along the X-axis.
	Objects aligned as a matrix via 'Matrix (2D)’ function.
.	.
.	.

Back to subchapter:

• Stage View
• Mouse + Keyboard Actions

go to following subchapter:

• Duplicate (copy 3D Objects)
• 3D Objects

Back to the mainchapter:

• Main Windows

You can duplicate objects via a mechanism in a comfortably way. Therefore do a multi selection in any view via left mouse button + 'Ctrl or Shift’ and select the menu entry 'Functions - Duplicate’. The Duplicate window appears:

You can set the number of desired copies.If the objects contain sub-objects select if these are copied too. Note:It is not possible to create new fixtures within grandMA 3D!If fixtures are selected to duplicate it is possible to select 'Use other Fixtures’. Select the 'First Destination Fixture’ inside the list box. After pressing the 'Duplicate’ button the 'First Destination Fixture’ will be moved to the X,Y,Z position of the source fixture and so on.This mechanism is useful to create symmetrical stage sets. For example you have to setup the number of all used fixtures inside the set. Do the setup for the left side of trusses and lanterns. After that you can duplicate the left side and mirror it to the right side.

Back to subchapter:

• Stage View
• Mouse + Keyboard Actions
• Arrangement of Objects (Align Objects)

Go to following subchapter:

• 3D Objects

Go back to the mainchapter:

• Main Windows

	This view offers information about all used objects in a grid view.All used 3D objects and fixtures are listed in this grid. Single or multiple objects can be selected for manipulation or duplicating.The objects can be sorted by a left mouse click into the headline of a column.

The symbols inside the grid have the following meanings:

Name		Meaning
	.	3D object
	.	Fixture object
	.	Grouping object

Property		Meaning
	.	Object is visible or hidden in Stage View
	.	Sunshade is on or off
	.	Followspot is active or inactive on object surface
.	.	.
.	.	.

Back to subchapter:

• Stage View
• Mouse + Keyboard Actions
• Arrangement of Objects (Align Objects)
• Duplicate (copy 3D Objects)

Go back to the mainchapter:

• Main Windows

Go to the following mainchapter:

• Assets (Information Window)

	The Assets window lists all used objects and fixtures in a tree. Select an object in the tree and the object will be marked in the Stage View and 3D Object grid too and vice versa. Additionally the properties of the object are shown in the Property window if this is switched on.
.	You can build groups of objects by meaning of the toolbar buttons.
.	The followspot icon informs if Followspot is activated for the object.
.	The visible icon shows if the object is visible in the Stage view.
.	Object is selectable or not.(click through)
	grandMA1/2: Desk properties likeMA Net settings Follow spot from deskUnits (change units from meter to inch etc.)
.	.

Go back to chapter:

• Program Surface
• Menu Bar
• Tool Bar
• Main Windows

Go to following chapter:

• Properties
• Media Database
• Materials
• Moving Pathes
• Sessions
• Status Bar

	The Property window informs about the properties of the actual selected object like fixtures or 3D objects.If several objects are selected e.g. via 'Ctrl + mouse’ only the fields with equal information are filled, other fields are cross striped.You can change the settings of one or all selected objects here.
	Numerical values can be in- or decremented via the mouse wheel (+Ctrl or +Shift) if the field is selected. Units can be changed in the Assets tree at 'Ma Net’ see above. Also the sizes can be changed absolute or as scaling factor. This can be done via the menu entry 'View - Units’
.	.
.	.

Go back to chapter:

• Program Surface
• Menu Bar
• Tool Bar
• Main Windows
• Assets (Information Window)

Go to following chapter:

• Media Database
• Materials
• Moving Pathes
• Sessions
• Status Bar

	The Media Database offers lots of 3D objects ordered by their type in a tree view. You can drag the objects from the database with the left mouse button into the Stage View window and place it to the desired position. All objects are scalable and the properties of the different materials can be changed in the Materials window if the object is selected.If the showfile is stored the 3D objects are included in the showfile.
.	.
.	.
.	.

Go back to chapter:

• Program Surface
• Menu Bar
• Tool Bar
• Assets (Information Window)
• Properties

Go to following chapter:

• Materials
• Moving Pathes
• Sessions
• Status Bar

		If an object is selected the Materials window shows all used materials (texture images) of the object. Select the material in the Material window and you can change its properties (diffuse color, emissive color, specular power, texture) in the property window. The results can be viewed directly in the Stage View window.
.	.	.
.	.	.
.	.	.

Go back to chapter:

• Program Surface
• Menu Bar
• Tool Bar
• Main Windows
• Assets (Information Window)
• Properties
• Media Database

Go to following chapter:

• Moving Pathes
• Sessions
• Status Bar

Moving Pathes allow the movement of objects like trusses with their attached sub objects like fixtures, trusses etc..

Moving Pathes are managed like fixture types in the desk. To setup a Moving Path, create a new fixture in the desk from the library. Choose the Manufacturer 'MA Lighting’ and the type 'Moving Path…’. There are several types of Moving Pathes. The type (Rotate, Scale…) specifies the parameters controlled by the desk:

	The object rotates once around the axes of the Moving Path.
	The object is scaled in X,Y and Z dimensions.
	The object rotates continuously around the axes of the Moving Path.The rotation speed can be set in rotations per minute at the desk.
	The object can be moved in X, Y and Z direction.
	Combined Moving Path of Translation, Rotation and Scale.This type is more easy to use instead of concatenating the single types.

Controlling of the position is always done relative to the origin coordinates. I.e. if an object with moving pathes is moved manually, the tracks of the Moving Pathes are always moved parallel to the new object coordinates.

	You can attach an object to a Moving Path via dragging the object in the tree. Drop it onto the desired Moving Path.The pictured example shows a truss with 4 moving head fixtures (1000A 1…4) mounted on a truss (FS34-400 1…2).
.	.
	The example shows a 'Translation’ Moving Path controlled in Z-direction.The truss moves up and down controlled by the desk.
.	.
.	.

Go back to chapter:

• Program Surface
• Menu Bar
• Tool Bar
• Main Windows
• Assets (Information Window)
• Properties
• Media Database
• Materials

Go to following chapter:

• Sessions
• Status Bar

	The Session window gives an overview about all running sessions in MA net. Name, ID and the state of the sessions are displayed. The streaming version is important for the compatibility.
.	.

See chapter: Version of grandMA desk or grandMA on PC

Go back to chapter:

• Program Surface
• Menu Bar
• Tool Bar
• Main Windows
• Assets (Information Window)
• Properties
• Media Database
• Materials
• Moving Pathes

Go to following chapter:

• Status Bar

The Status Bar informs about the actual Network Type (grandMA1 or grandMA2 net), the Connection State (Master, Slave or Sniffer) and the name of the session. Also the name of the show file and the number of selected items are displayed:

.	.
.	.

Go back to chapter:

• Program Surface
• Menu Bar
• Tool Bar
• Main Windows
• Assets (Information Window)
• Properties
• Media Database
• Materials
• Moving Pathes
• Sessions

Go to next Chapter:

• Fixture Types

Axis (axis of fixtures or moving pathes)

Effect in grandMA 3D		Description		grandMA Series 1		grandMA Series 2		Physical Value in Function Set		Phys. Example
	.		.	Suggested Attribute || Visualizer Effect/Sub function	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.	.
Pan	.	Pan-axis of fixtures	.	Pan/Tilt » Pan/Tilt » Pan || Pan	.		.	Angle range in degrees	.	-180 thru 180
.	.	.	.	.	.	.	.	.	.	.
Tilt	.	Tilt-axis of fixtures	.	Pan/Tilt » Pan/Tilt Tilt || Tilt	.		.	Angle range in degrees	.	-80 thru 80
.	.	.	.	.	.	.	.		.	.
Roll	.	Roll-axis of fixtures	.	Pan/Tilt » Pan/Tilt Roll || Roll	.		.	Angle range in degrees	.	-80 thru 80
.	.	.	.	.	.	.	.	.	.	.
Translation X | Translation Y | Translation Z	.	Translation in x-, | y- or z-direction, | e.g. for moving pathes	.	Control MP Trans » X || Position/X | Control » MP Trans » Y || Position/Y | Control » MP Trans Z || Position/Z	.		.	Translation range in meter	.	-5 thru 5
.	.	.	.	.	.	.	.	.	.	.
Scaling X |Scaling Y |Scaling Z	.	Scaling of objects in x-, | y- or z-direction, | e.g. for moving pathes	.	Control » MP Scale » X || Scale/X | Control » MP Scale » Y || Scale/Y | Control » MP Scale Z || Scale/Z	.	.	.	Scaling factor (must be >0!)	.	-0.1 thru 2
.	.	.	.	.	.	.	.	.	.	.
Rotation X |Rotation Y |Rotation Z	.	Rotation around x-, | y- or z-axis, | e.g. for moving pathes	.	Control » MP Rot » X || Rotation/X | Control » MP Rot » Y ||Rotation/Y | Control » MP Rot Z || Rotation/Z	.	.	.	Angle range in degrees	.	-180 thru 180
.	.	.	.	.	.	.	.	.	.	.
Spin X |Spin Y |Spin Z	.	Continuous rotation around x-, | y- or z-axis	.	Control » MP Spin » X || Rotate Animation/X | Control » MP Spin » Y || Rotate Animation/Y | Control » MP Spin Z || Rotate Animation/Z	.	.	.	Rotation speed in rotations per minute (rpm)	.	-15 thru 15
.	.	.	.	.	.	.	.	.	.	.
Clamp	.	Pitch of the clamp	.	Control » MP Rot Clamp || Clamp	.	.	.	Angle range in degrees	.	-90 thru 90
.	.	.	.	.	.	.	.	.	.	.
Barndoor 1 | Barndoor 2 | Barndoor 3 | Barndoor 4 |	.	Pitch of barndoors in front of the lens	.	Shaper » Barndoor » DB1 || Barndoor/Barndoor1| Shaper » Barndoor » DB2 || Barndoor/Barndoor2| Shaper » Barndoor » DB3 || Barndoor/Barndoor3| Shaper » Barndoor DB4 || Barndoor/Barndoor4|	.	.	.	Angle range in degrees0° = barndoor is in same position like in model> 0° = close barndoor	.	0 thru 90
.	.	.	.	.	.	.	.	.	.	.
Shaper Rotation	.	Rotation of visible blades in front of the lens e.g. barndoors	.	Shapers » Shaper2 Shaper Rot || Shaper Rotation	.	.	.	Angle range in degrees	.	-90 thru 90
.	.	.	.	.	.	.	.	.	.	.

Light Output

Effect in grandMA 3D		Description		grandMA Series 1		grandMA Series 2		Physical Value in Function Set		Phys. Example
.	.	.	.	Suggested Attribute || Visualizer Effect/Sub function	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.	.
Shutter	.	.	.	Dimmer » Strobe || Strobe/Strobe	.	.	.	grandMA1:0 = Shutter closed65535 = Shutter opened	.	.
.	.	.	.	.	.	.	.	.	.	.
Strobe/Strobe Frequency	.	Strobe effects with random and soft opening/closing option	.	Dimmer Strobe || Strobe/Strobe | Strobe/Random | Strobe/Pulse |Strobe/Pulse Open | Strobe/Pulse Close | Strobe/Pulse Random |Strobe/Pulse Random Open | Strobe/Pulse Random Close	.	.	.	Strobe frequency in Hz (bigger than 0)	.	0.5 thru 10
.	.	.	.	.	.	.	.	.	.	.
Strobe Ratio	.	.	.	Beam » Beam1 Strobe R || Strobe/Ratio	.	.	.	Slice of 1.0.5 means that the shutter is opened half the strobe interval.	.	0.2 thru 0.8
.	.	.	.	.	.	.	.	.	.	.
Dimmer		Intensity of the light source	.	Dimmer Dim || Dimmer	.	.	.	Factor on the fixture type intensity0.0 = off1.0 = maximum	.	0.0 throw 1.0
.	.	.	.	.	.	.	.	.	.	.

Light Effects

Effect in grandMA 3D		Description		grandMA Series 1		grandMA Series 2		Physical Value in Function Set		Phys. Example
.	.	.	.	Suggested Attribute || Visualizer Effect/Sub function	.	.	.	.	.	.
.	.		.	.	.	.	.	.	.	.
Color	.	Color of beam or led surfaces	.	Color Color1 » C1 |Color » Color2 » C2 |Color » Color3 » C3 |Color » Color Mix » [Color] |Color » RGB [Color] || Color WheelColor Mix/[Color]	.	.	.	Color	.	/
.	.	.	.	.	.	.	.	.	.	.
Color Wheel Rotate	.	[Not yet implemented] Continuous rotation of the color wheel	.	Color » Color1 » C1 rot || Color Rotate/Wheel 1 |Color » Color2 » C2 rot || Color Rotate/Wheel 2Color » Color3 C3 rot || Color Rotate/Wheel 3	.	.	.	Rotation speed in rotations per minute (rpm)	.	-15 thru 15
.	.	.	.	.	.	.	.	.	.	.
Zoom	.	.	.	Focus Zoom || Zoom	.	.	.	Factor on the beam angle range of the fixture type0.0 = Beam has the minimum beam angle of the fixture type.1.0 = Beam has the maximum beam angle of the fixture type.	.	0 thru 1
.	.	.	.	.	.	.	.	.	.	.
Iris	.	.	.	Beam » Beam1 Iris || Iris	.	.	.	Factor0.0 = iris completely closed1.0 = iris opened	.	0.2 thru 1.0
.	.	.	.	.	.	.	.	.	.	.
Prism	.	.	.	Beam » Beam1 » P1 || Prism/2 Beams |Prism/3 Beams |Prism/4 Beams |Prism/5 Beams	.	.	.	Prism angle in degrees (angle between center of beam without prism and center of beam with prism)	.	30
.	.	.	.	.	.	.	.	.	.	.
Prism Position	.	Rotation of the prism	.	Beam » Beam1 P1 Pos || Prism Position	.	.	.	Angle range in degrees	.	-180 thru 180
.	.	.	.	.	.	.	.	.	.	.
Prism Rotation	.	continuous rotation of the prism	.	Beam Beam1 » P1 Rot || Prism Rotation	.	.	.	Rotation speed in rotations per minute (rpm)	.	-15 thru 15
.	.	.	.	.	.	.	.	.	.	.
Frost	.	.	.	Focus Frost || Frost	.	.	.	0.0 = no frost1.0 = maximum	.	0.0 thru 1.0
.	.	.	.	.	.	.	.	.	.	.

Gobo (3 Wheels Maximum)

Effect in grandMA 3D		Description		grandMA Series 1		grandMA Series 2		Physical Value in Function Set		Phys. Example
.	.	.	.	Suggested Attribute || Visualizer Effect/Sub function	.	.	.	.	.	.
.	.	.	.		.	.	.	.	.	.
Gobo X (Wheel Position)	.	Selects gobo from values inside functional block	.	Gobo » Gobo » G1 || Gobo Wheel/Wheel 1 |Gobo » Gobo » G2 || Gobo Wheel/Wheel 2 |Gobo » Gobo G3 || Gobo Wheel/Wheel 3 |	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.	.
Gobo X - Wheel Rotation	.	Continuous rotation of the gobo wheel	.	Gobo » Gobo » G1 Wheel Rot || Gobo Wheel Rotate/Wheel 1 |Gobo » Gobo » G2 Wheel Rot || Gobo Wheel Rotate/Wheel 2 | Gobo » Gobo G3 Wheel Rot || Gobo Wheel Rotate/Wheel 3 |	.	.	.	Rotation speed in rotations per minute (rpm)	.	-15 thru 15
.	.	.	.	.	.	.	.	.	.	.
Gobo X - Position	.	Rotation of the current gobo	.	Gobo » G-Rot. » G1 Pos || Gobo Angle/Wheel 1 | Gobo » G-Rot. » G2 Pos || Gobo Angle/Wheel 2 | Gobo » G-Rot. G3 Pos ||Gobo Angle/Wheel3 |	.	.	.	Angle range in degrees	.	-180 thru 180
.	.	.	.	.	.	.	.	.	.	.
Gobo X - Rotation	.	Continuous rotation of the current gobo	.	Gobo » G-Rot. » G1 Rot || Gobo Rotate/Wheel 1 |Gobo » G-Rot. » G2 Rot || Gobo Rotate/Wheel 2 |Gobo » G-Rot. G3 Rot || Gobo Rotate/Wheel 3 |	.	.	.	Rotation speed in rotations per minute (rpm)	.	-15 thru 15
.	.	.	.	.	.	.	.	.	.	.

Blades (4 Blades Maximum)

Effect in grandMA 3D		Description		grandMA Series 1		grandMA Series 2		Physical Value in Function Set		Phys. Example
.	.	.	.	Suggested Attribute || Visualizer Effect/Sub function	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.	.
Blade X - Insertion (A)	.	Insertion of the Blade into the beam This Attribute must be present to visualize any blade.	.	Shapers » Shaper1 » 1A || Shutter/Blade 1A | Shapers » Shaper1 » 2A || Shutter/Blade 2A | Shapers » Shaper1 » 3A || Shutter/Blade 3A | Shapers » Shaper1 4A || Shutter/Blade 4A |	.	.	.	0.0 = no insertion1.0 = full covering	.	0.0 thru 0.5
.	.	.	.	.	.	.	.	.	.	.
Blade X - Insertion (B)	.	Second insertion range for every blade for rotating If this option is used you must not use the "Blade X - Rotation"-option.	.	Shapers » Shaper1 » 1B || Shutter/Blade 1B | Shapers » Shaper1 » 2B || Shutter/Blade 2B | Shapers » Shaper1 » 3B || Shutter/Blade 3B | Shapers » Shaper1 4B || Shutter/Blade 4B |	.	.	.	0.0 = no insertion1.0 = full covering	.	0.0 thru 0.5
.	.	.	.	.	.	.	.	.	.	.
Blade X - Rotation	.	Rotation of the blade If this option is used you must not use the "Blade X - Insertion (B)"-option.	.	Shapers » Shaper1 » 1B || Shutter/Blade 1 Angle |Shapers » Shaper1 » 2B || Shutter/Blade 2 Angle |Shapers » Shaper1 » 3B || Shutter/Blade 3 Angle |Shapers » Shaper1 4B || Shutter/Blade 4 Angle |	.	.	.	Angle range in degrees	.	-45 thru 45
.	.	.	.	.	.	.	.	.	.	.
Blade X - Rotation around Beam	.	Rotation of a blade around the beam	.	[must be defined by user] || Shutter/Blade 1 Rot | Shutter/Blade 2 Rot | Shutter/Blade 3 Rot | Shutter/Blade 4 Rot |	.	.	.	Angle range in degrees	.	-180 thru 180
.	.	.	.	.	.	.	.	.	.	.
Rotation of all Blades	.	.	.	Shapers » Shaper2 Sh Rot || Shaper Rotation	.	.	.	Angle range in degrees	.	-180 thru 180
.	.	.	.	.	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.	.

Go to the next chapter:

• 3D Modeling and Import

3D models created with 3D design programs like 'Cinema 4D’ can be imported via the import tool. The import tool can be found via the menu entry: 'File - Import - Import 3D Model…’. Single files as well as complete directories can be imported.

The imported model can be viewed in the 'Model Test Area’ window that can be operated similar to the 3D 'Stage View’. Properties like 'Name’; 'Category’ etc. can be edited. After that the model can be stored in the media database and is ready to be used in grandMA 3D.

See chapter:

• 3D Models Principles
• Parameters

Go to the next chapter:

• Video Creation

The import tool offers no functionality to edit the 3D-Model afterwards. So the imported 3D model must contain all information.

To avoid the determination on a specific modeling tool we choose the '3DS’ file format that can be exported by most applications.

All parameters can be referred to by the names of the simple objects.

Important restrictions for 3D objects:

• Names of objects max. 8 characters (incl. parameter)
• No special characters allowed
• Names must be unique, each object must have a unique name.

  Note:

  Note that some modeling applications shorten names while exporting to 3ds. The name must stay unique after exporting.

• All objects must consist of triangles

  (e.g. Cinema 4D 'Functions - Make Editable’ & 'Functions - Triangulate’)

• Only one material can be assigned to an object
• Only one texture can be assigned to a material

These limitations must be abided even in future when other file formats are allowed.Furthermore 3D objects should consist of as few triangles as possible. Curves can be pictured realistically with little triangles if the normals simulate this (Cinema 4D: 'Phong Tag’).

Go back to chapter:

• 3D Modeling and Import

Go to following chapter:

• Parameters

Parameters can be added to the names of objects to set further properties of the object.

Example: The object name ‚Test_XAP' is a pan-axis.

A parameter block must start with '_X’ followed by the (sub) parameters without separators as shown in the following table:

Parameter		Sub-Parameter		Description
V	.	-	.	Available for user The Object can be manipulated by the user. Per default the top object in the tree structure can always be manipulated by the user, sub objects not.
.	.	.	.	.
N	.	-	.	Not available for the user. Object cannot be manipulated by the user. (Can only be used for sub objects.)
.	.	.	.	.
D	.	-	.	Delete Object will not be imported.
.	.	.	.	.
A	.	-	.	Axis (also see: Axes) Object will be transformed to a movement axis.The parameter is only valid in association with one of the following sub parameters. The sub parameter specifies the type of axis.
.	.	.	.	.
.	.	P	.	Pan axis
.	.	.	.	.
.	.	T	.	Tilt axis
.	.	.	.	.
.	.	R	.	Roll
.	.	.	.	.
	.	X	.	Shift (X axis)
.	.	.	.	.
.	.	Y	.	Shift (Y axis)
.	.	.	.	.
.	.	Z	.	Shift (Z axis)
.	.	.	.	.
.	.	U	.	Scale (X axis)
.	.	.	.	.
.	.	V	.	Scale (Y axis)
.	.	.	.	.
.	.	W	.	Scale (Z axis)
.	.	.	.	.
.	.	J	.	Rotation (round X axis)
.	.	.	.	.
.	.	K	.	Rotation (round Y axis)
.	.	.	.	.
.	.	L	.	Rotation (round Z axis)
.	.	.	.	.
.	.	1	.	Axis of 1. barndoor
.	.	.	.	.
.	.	2	.	Axis of 2. barndoor
.	.	.	.	.
.	.	3	.	Axis of 3. barndoor
.	.	.	.	.
.	.	4	.	Axis of 4. barndoor
.	.	.	.	.
.	.	G	.	Continuous rotation round (X axis)
.	.	.	.	.
.	.	H	.	Continuous rotation round (Y axis)
.	.	.	.	.
.	.	I	.	Continuous rotation round (Z axis)
.	.	.	.	.
.	.	C	.	Clamp Rotation axis of the clamp
.	.	.	.	.
.	.	.	.	.
S	.	.	.	Sunshade type Specifies how the object casts a shadow or how gobos are shown on the object.
.	.	.	.	.
.	.	N	.	None Has no influence on the object. Neither the beam is affected nor gobos are projected on the object.For example the object is a lens of a fixture. The lens does not balk the beam, and no gobos are projected on the lens.The lens is fixed in the case so it doesn’t cast a shadow if it is hit by an external beam.
.	.	.	.	.
.	.	R	.	Regular The object casts a shadow and gobos are projected on the object.Default setting if nothing else is parameterized
.	.	.	.	.
.	.	X	.	Exclude own beam Compared to other fixtures the object behaves like option ‚R' and compared to the own source of light like option 'N’.This parameter should be set for example for the body of moving heads and the clamp, meaning the parts that are never lighted by the own beam.This simplifies the rendering and avoids the casting of a shadow by the own beam.
.	.	.	.	.
.	.	G	.	Ghost (Currently not implemented) The object casts a shadow and gobos are projected on the object.The object itself is not visible, only if it is hit by a beam.For example an LED panel consisting of several LEDs with one body.The LEDs can be excluded from the shadow via parameter 'N’.The body for the LEDs has the parameter 'G’ for the common shadow.Note that color mixing will only work correctly if the diffuse color of the ghost object and of the covered objects is the same.
.	.	.	.	.
B	.	.	.	Beam Marks the origin of the beam. (See: Beam of Light)
.	.	.	.	.
I	.	.	.	Diffuse Inking * Extension parameter for other materials.The color specifies the ratio of the diffuse color to the fixture color.White means: the diffuse color gets brighter by 100% of the fixture color.
.	.	.	.	.
E	.	.	.	Emissive Color * Extension parameter for other materials.Specifies the color/texture of the object’s self shine.
.	.	.	.	.
J	.	.	.	Emissive Inking* Extension parameter for other materials.The color specifies the ratio of the emissive color to the fixture color.White means that the emissive color gets 100% brighter with the fixture color.
.	.	.	.	.
C	.	.	.	Children Sub controls, to be placed in grandMA 3D below the object of a model.Other sub objects in grandMA 3D will be inserted below this item.Used for moving paths to create sub objects below an axis.
.	.	.	.	.
.	.	.	.	.

* This parameter can be used only for materials. The material with the parameter extends the other material.

For example 'Lens_XJ’ describes the emissive inking color for the material (without parameter) with the same name 'Lens’. The extended material must not be assigned to an object. This detour is necessary because the modeling software does support this functionality.

Go back to chapter:

• 3D Modeling and Import
• 3D Models Principles

View subchapter:

• Axes
• Rotation Axes
• Linear Axes
• Beam of Light
• Automated Import
• Assigning of Models to Fixture Types
• Checklist for 3D Modeling
• Creation of a 3D Model

Objects can be configurated with movement axes. The position of the axis is marked with an auxiliary object.

Objects ordered below the auxiliary object in the tree structure can be moved in the appropriate manner:

	The image shows an object tree of a moving head fixture. The object 'VL1000’ is the root of the fixture.'_XAP’ is the pan axis of the model.All objects below are rotated around this axis.
.	.
.	.

Go to the following subchapter:

• Rotation Axes
• Linear Axes
• Beam of Light
• Automated Import
• Assigning of Models to Fixture Types
• Checklist for 3D Modeling
• Creation of a 3D Model

Back to the mainchapter:

• Parameters

Rotation axes are marked with a square (consisting of two triangles). The name of this object must contain the appropriate parameter for the desired axis see Parameter. Furthermore all normals of this object should point in the same direction.

When importing the object it is converted into an axis. It is aligned along the direction of the normals (vertical on the square) positioned in the center of the square.

In case of movement the right-hand rule is applicable: Thumb shows into direction of normals, objects will rotate into the direction of the fingers (with positive values).

	The image shows the tilt axis of a moving head fixture.The normals of the square show to the left direction.The lens will move away from the viewer if the tilt axis is driven with values bigger than 0°.
.	.
.	.

Go back to subchapter:

• Axes

Go to following subchapter:

• Linear Axes
• Beam of Light
• Automated Import
• Assigning of Models to Fixture Types
• Checklist for 3D Modeling
• Creation of a 3D Model

Back to the mainchapter:

• Parameters

Linear axes are marked in the same manner as rotation axes.

The normal of the square shows the direction of movement.

Go back to subchapter:

• Axes
• Rotation Axes

Go to follwowing subchpater:

• Beam of Light
• Automated Import
• Assigning of Models to Fixture Types
• Checklist for 3D Modeling
• Creation of a 3D Model

Back to the mainchapter:

• Parameters

Similar to the rotation axes the position of the beam (cone) is marked with a square. The center of the square marks the origin of the cone. The normals mark the direction.

The position inside the fixture body can be determined with an auxiliary cone that is placed temporarily into the body

The radius (r) of the cone can be calculated with the following formula:

r = tan([max. open radius / 2]) * [height of the cone]

Normally the cone uses the complete lens hole of the fixture. The square is placed at the top of the cone:

	.	.	.	.	.
.	.	.	.	.	.	.
Placement of the cone 2D	.	.	.	.	.	Placement of the cone 2D
.	.	.	.	.	.	.
.	.	.	.	.	.	.

Go back to subchapter:

• Axes
• Rotation Axes
• Linear Axes

Go to follwowing subchpater:

• Automated Import
• Assigning of Models to Fixture Types
• Checklist for 3D Modeling
• Creation of a 3D Model

Back to the mainchapter:

• Parameters

Meta data of a 3D model can be left appropriately for the import. Later editing with the import tool is not required.

The placeholder [file] stands for the filename (without extension) that has to be imported. For example if the file 'test.3ds’ has to be imported, '[file] stands for 'test’:

File				Description
.	.	.	.	.
_global.import.xml	.	.	.	Global import setting valid for the complete directory. Structure like [file].import.xml.
.	.	.	.	.
[file].import.xml	.	.	.	XML file with meta data for the model. If this file does not exist, it will be created automatically to store the model key.
.	.	.	.	.
[file].import.png	.	.	.	Preview image of the model. Size is 32x32 pixel (32 Bit RGBA).Will be created if not exists.
.	.	.	.	.
[file].png [file].tif [file].bmp [file].jpg	.	.	.	If no preview image exists the import tool tries to create it. It searches in the given order on the side.The image should be exempted via alpha channel.Boarders are cut automatically when the thumbnails are created.
.	.	.	.	.

Field					Description
.	.	.	.	.	.
Name	.	.	.	.	Name of the model'/filename' will be replaced with the filename of the import file (without extension)
.	.	.	.	.	.
Category	.	.	.	.	Category in the 'Media Database’Sub categories can be separated with a '/’.e.g. 'Fixtures/Head Mover’
.	.	.	.	.	.
ModelKey	.	.	.	.	[see: 7.4 Assigning of Models to Fixture Types]
.	.	.	.	.	.
DeviceManufacturer	.	.	.	.	[see: 7.4 Assigning of Models to Fixture Types]
.	.	.	.	.	.
DeviceName	.	.	.	.	[see: 7.4 Assigning of Models to Fixture Types]
.	.	.	.	.	.
DeviceClass	.	.	.	.	[see: 7.4 Assigning of Models to Fixture Types]Possible values:None, Mirror, Headmover, Conventional, LED, MovingPath
.	.	.	.	.	.
ModelPriority			.		[see: 7.4 Assigning of Models to Fixture Types]
.	.	.	.	.	.
ModelManufacturer	.	.	.	.	Designer of the model.
.	.	.	.	.	.
Description	.	.	.	.	Short description.
.	.	.	.	.	.
Scale	.	.	.	.	Object will be scaled by this factor.
.	.	.	.	.	.
Move	.	.	.	.	Moves the object after the import.None: No movementMoveBottomToZ0: Model is placed on XY plane Z = 0MoveCenterToZ0: Center of the object is placed to Z = 0
.	.	.	.	.	.
AmbientFlare	.	.	.	.	Clarification grade of the fixture environment.
.	.	.	.	.	.

Go back to subchapter:

• Axes
• Rotation Axes
• Linear Axes
• Beam of Light

Go to following subchapter:

• Assigning of Models to Fixture Types
• Checklist for 3D Modeling
• Creation of a 3D Model

Back to the mainchapter:

• Parameters

Field				Description
.	.	.	.	.
ModelKey	.	.	.	Unique key of the model. This key is created with the first importing of the model and saved in the XML file (*.ImportSettings.xml). The key identifies exactly the model. If the model is imported again the same key will be used from the XML file.
.	.	.	.	.
DeviceManufacturer	.	.	.	Manufacturer of the fixture that is represented by the model.
.	.	.	.	.
DeviceName	.	.	.	Name of the fixture that is represented by the model.
.	.	.	.	.
DeviceClass	.	.	.	Type of the model if it represents a fixture. E.g. 'Headmover’
.	.	.	.	.
ModelPriority	.	.	.	Priority for selecting this model. High numbers are more probable. The standard value '0’ should only be used if the meaning is clear, see description below.
.	.	.	.	.

At best the fixture type of a device is left in the data base. If the very same type is found by grandMA 3D (ModelKey == Model.ModelKey) it will be used without any validation. In this case a fixture type always will be assigned to the same model.

If no model key is found the application searches for a more suitable model, like same 'DeviceManufacturer’ , 'DeviceName’ etc..

Possible placeholders:

*				0-n any characters
.	.	.	.	.
+	.	.	.	1-n any characters
.	.	.	.	.
?	.	.	.	0-1 any characters
.	.	.	.	.
#	.	.	.	1 arbitrary character
	.	.	.	.

Often there are several variants of fixture types in a model range. So the attachment of a '*’ is recommended - for example: 'VL1000*’. The spelling is not case sensitive.

If a special 3D object shall be used for a model even though a model with the notation exists the 'ModelPriority’ can be increased (in steps of 100). For example a 'VL1000AS’ with the priority of 100 would be preferred instead of 'VL1000*’ with a standard priority of 0.

grandMA 3D is delivered with standard models for every 'DeviceClass’ type. The standard model has the following setting: DeviceManufacturer = ’*’, DeviceName = '*’ and ModelPriority = -100000. These models have a low priority and are used only if no other model with higher priority is found.

Go back to subchapter:

• Axes
• Rotation Axes
• Linear Axes
• Beam of Light
• Automated Import

Go to following subchapter:

• Checklist for 3D Modeling
• Creation of a 3D Model

Back to the mainchapter:

• Parameters

• Sunshade type settings for all objects are correct?

  For example shadow calculations for the own source of light of the fixture body, clamp and head are excluded?

• Names of objects don’t exceed 8 characters (.3ds files)?

• Names of object are unique?

• Objects exclusively are composed of triangles?

• No information has been lost while exporting? To check this, open the exported file with the modeling tool.

Go back to subchapter:

• Axes
• Rotation Axes
• Linear Axes
• Beam of Light
• Automated Import
• Assigning of Models to Fixture Types

Go to following subchapter:

• Creation of a 3D Model

Back to the mainchapter:

• Parameters

3D objects can be created with 3D CAD programs. Please note, that the amount of polygons affects the performance because for each polygon the projection has to be calculated. The lower the number of polygons the better is the frame rate.

grandMA 3D supports the following formats for 3D objects:

Note the following regulations:

The following example shows the creation of a halved cylinder, created with'Cinema 4D’:

.	.
	Insert an object of type 'Cylinder’
.	.
	Set the orientation to 'Y+’. For a correct visualization in grandMA 3D is the depth, Y the vertical and X the horizontal axis
.	.
	Make the object editable
.	.
	Select not used polygons…
.	.
	and delete them.
.	.
	Set the visibility of normal on.
.	.
	The next copy steps are only necessary if the object should be visible from both sides. Therefore it is duplicated and the normals are set in both directions.Copy the object…
.	.
	And reverse the normals of the copy.
.	.
	Select both cylinder objects and connect them to one new cylinder.
.	.
	The old cylinder objects can be deleted.
.	.
	Now you can see two objects with normals in both directions
.	.
	Check the orientation of the resulting object.
.	.
	Insert a new material for the texturing.
.	.
	Assign an image to the texture and the material to the object.(Mind the restriction of max. 8 characters + extension for the image name!)
.	.
	Adjust the texture mapping parameter.
.	.
	Assign the UV coordinates for the texture mapping.
.	.
	Export the object to 3D Studio format (.3ds).Objects created in this way can be added via the import tool.
.	.
	The resulting 3D Object looks like this.
.	.
.	.
.	.

Go back to subchapter:

• Axes
• Rotation Axes
• Linear Axes
• Beam of Light
• Automated Import
• Assigning of Models to Fixture Types
• Checklist for 3D Modeling

Go to the next chapter:

• Video Creation

Back to the mainchapter:

• Parameters

Will come soon.

Go to the next chapter:

• FAQ

Question									Answer
.	.	.	.	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.	.
	.	.	.	.	.	.	.	.	.

Go to the next chapter:

• Keyboard Shortcuts

Many functions that can be reached via the menu entry are listed directly in the menu. Underlined characters in the menu mark the shortcuts that can be reached by pressing the 'Alt’ + 'underlined character’ simultaneously.

Depending on the window the keyboard shortcuts have different effects:

Shortcut				Window				Effect
	.	.	.	Stage View	.	.	.
Shift + Ctrl + right mouse	.	.	.	::	.	.	.	Several combinations of camera movements while mouse button is pressed
.	.	.	.	.	.	.	.	.
Ctrl+ left mouse	.	.	.	::	.	.	.	Move or rotate object with left mouse button
.	.	.	.	.	.	.	.	.
Esc	.	.	.	::	.	.	.	Deselect objects
.	.	.	.	.	.	.	.	.
Arrows or Page up-down	.	.	.	::	.	.	.	Move camera or + 'Ctrl’ turn camera + 'Shift’ faster
.	.	.	.	.	.	.	.	.
Middle mouse button- Mouse wheel	.	.	.	::	.	.	.	Wheel menu on/offIf menu is on: - select entry via mouse wheel - 1…9…0 select menu entry - 'Space’ next menu entry- 'Shift + Space’ one menu entry back
.	.	.	.	.	.	.	.	.
Ctrl + 1…9…0	.	.	.	All views	.	.	.	Change to camera 1…9…0If focus is in Stage View no 'Ctrl’ necessary
.	.	.	.	.	.	.	.	.
Ctrl + Space	.	.	.	::	.	.	.	Next camera.If focus is in Stage View no 'Ctrl’ necessary
.	.	.	.	.	.	.	.	.
Ctrl + change camera with mouse	.	.	.	::	.	.	.	No soft camera changing
.	.	.	.	.	.	.	.	.
Shift + camera change	.	.	.	::	.	.	.	Spanning windows will not change their camera
.	.	.	.	.	.	.	.	.
Ctrl + Return	.	.	.	::	.	.	.	Switch to fullscreen or leave fullscreen view
	.	.	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.
.	.	.	.	.	.	.	.	.

Go to the next chapter:

• Index

.

• .3D1.....................................................Data Management
• .3ds file.................................................grandMA 1 or grandMA 2 mode
• .gz........................................................Data Management
• .gz files.................................................Data Management
• .png files...............................................Menu Bar [Tools]
• .sl_files.................................................grandMA 1 or grandMa2 mode

3

• 3D Modeling.........................................Menu Bar [File] | 3D Modeling and Import | Checklist for 3D Modeling
• 3D Objects...........................................3D Objects

A

• Align Objects........................................Menu Bar [Functions] | Arragement of Objects
• arrange windows...................................Program Surface
• Arrangement of Objects.........................Menu Bar [Functions] | Arrangement of Objects
• Assets.................................................Assets (Information Window)
• Assigning of Models to Fixture Types........Assigning of Models to Fixture Types
• Automated Import.................................Automated Import

B

• backup................................................Master / Slave
• blind mode..........................................Menu Bar [Tools]

C

• Camera Spanning.................................Tool Bar
• Change Model......................................Menu Bar [Functions]
• Change user.........................................Menu Bar [Tools]
• Commandline.......................................Menu Bar [View]
• Connection with the grandMA desk..........Connection with the grandMA desk
• Coordinate system................................Coordinate system
• copy 3D Objects...................................Menu Bar [Functions]
• Creation of a 3D Model..........................Creation of a 3D Model

D

• Data Management...............................Data Management
• Duplicate objects + fixtures..................Menu Bar [Functions] | Duplicate (copy 3D Objects)

F

• Fixture Types......................................Fixture Types
• Frame rate..........................................Stage View
• fullscreen...........................................Keyboard Shortcuts
• Fullscreen..........................................Tool Bar

G

• grandMA I or grandMA II mode.............grandMA 1 or grandMA 2 mode

I

• Import...............................................3D Modeling and Import
• Import a 3D model..............................Menu Bar [File]
• Installation.........................................Installation
• IP address..........................................IP addresses | Menu Bar [File]

K

• Keyboard Actions................................Mouse + Keyboard Actions
• Keyboard Shortcuts.............................Keyboard Shortcuts

M

• MA1 mode..........................................Menu Bar [File]
• Master................................................Data Management | Master / Slave
• Materials............................................Media Database | Materials
• Matrix................................................Arragement of Objects
• Media Database...................................Media Database
• Menu Bar............................................Menu Bar
• Modelling............................................Menu Bar [File] | 3D Modeling and Import | 3D Models Principles
• Mouse Actions.....................................Mouse + Keyboard Actions
• Moving Pathes.....................................Moving Pathes

P

• Program Surface..................................Program Surface
• Properties...........................................Properies | Media Database | Materials

R

• Rendering...........................................Tool Bar
• Reset Window Layout............................Program Surface

S

• Screenshot.........................................Menu Bar [Tools]
• Slave.................................................Data Management | Master / Slave
• Status Bar...........................................Status Bar
• System Requirements..........................System Requirements

U

• Units....................................................Properties | Assets

V

• Version of grandMA desk or off-line.......Version of grandMA desk or grandMA onPC | Connection with the grandMA desk

W

• Window layout....................................Program Surface

X

• xml file..............................................Automated Import