• grandMA2 User Manual
  • grandMA2 Quick Start Guide
  • MA 3D
    • Help from MA technical support
    • Symbols used
    • Introduction
    • Install and Uninstall
      • System Requirements
      • Installation
      • Uninstall MA 3D
    • First Steps
      • Hardware connection
      • Start MA 3D
      • Create a Session
    • Data Management
      • Master/Slave
      • Coordinate system
    • Program Surface
      • Menu Bar
        • Menu Bar - File Menu
        • Settings
        • Edit
        • Functions
        • Tools
        • View
        • Help
      • Tool Bar
      • Main Windows
        • Stage View
        • Mouse + Keyboard Actions
        • Arrangement of Objects (Align Objects)
        • Duplicate (copy 3D Objects)
        • 3D Objects
      • Assets (Information Window)
      • Properties
      • Media Database
      • Materials
      • Video Player
      • Moving Paths
      • Sessions
      • Status Bar
      • Windows Layout
    • Fixture Types
    • 3D Modeling and Import
      • Workflow
      • 3D Modeling Principles
      • Creation of a 3D Model
      • Creation of a 3D Fixture Model
      • Import 3D Model to MA 3D
      • Assigning of 3D Models to Fixture Types
      • Checklist for 3D Modeling
      • Automated import
      • Parameters
        • Axes
        • Rotation Axes
        • Linear Axes
        • Beam of Light (Cone)
    • Keyboard Shortcuts
    • MA 3D FAQ
  • MA VPU
  • Release Notes
Select different version
 
Hint:
New help version
The help version you selected belongs to an older software version. You may want to view the latest help version.
Version 3.3

Automated Import

Table of contents of this topic

hide

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 it does not exist.
Note: If you use “%o.png” instead of the file name the .png file is generated with the right name.
[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.
Borders are cut automatically when the thumbnails are created.

 

Example for an '*.import.xml’ file:

<?xml version="1.0"?> 
<GrandMA3DImportSettings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.malighting.de/GrandMA3D/GrandMA3DImportSettings/1.0"> 
     <Name>Generic - Head Mover</Name> 
     <Category>Fixtures/Head Mover</Category> 
     <ModelKey>cc6464b5-c992-4b9e-8a96-31691d9cdd90</ModelKey> 
     <DeviceManufacturer>*</DeviceManufacturer> 
     <DeviceName>*</DeviceName> 
     <DeviceClass>Headmover</DeviceClass> 
     <ModelPriority>-100000</ModelPriority> 
     <ModelManufacturer>MA Lighting</ModelManufacturer> 
     <Description>Default Head Mover Model</Description> 
     <Scale>0.01</Scale> 
     <Move>MoveBottomToZ0</Move> 
     <AmbientFlare>0.02</AmbientFlare> 
</GrandMA3DImportSettings>
Hint:
This file is created once the import is initiated.
If the file already exists, the importer uses the data from this file to fill out the fields like <Category>Fixtures/Head Mover</Category>.
So, these entries need not to be done twice if the model is corrected and imported again.

 

Overview of possible fields

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 Assigning of Models to Fixture Types
DeviceManufacturer see Assigning of Models to Fixture Types
DeviceName see Assigning of Models to Fixture Types
DeviceClass

see Assigning of Models to Fixture Types
Possible values:

  • None
  • Mirror
  • Headmover
  • Conventional
  • LED
  • MovingPath 
ModelPriority see 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.
Possible values:
  • None: No movement
  • MoveBottomToZ0: Model is placed on XY plane Z = 0​
  • MoveCenterToZ0: Center of the object is placed to Z = 0 
AmbientFlare Clarification grade of the fixture environment.
DoubleAllFaces

Possible values:

 

  • true: sets both sides of all planes to visible
  • false: (default setting) only the sides with the normals are visible

Can be set to true if the normals are not set correctly.
Note: This will let to performance penalties because there will be created unnecessary faces/vertices.

 

Hint:
Fields that are not used can be omitted.

Select different version