EXPORTER

Printable Version

I3D Exporter



Table of Contents

  1. Autodesk Maya I3D Exporter
    1. Material Export Options
    2. Manual Installation
  2. Blender I3D Exporter

Autodesk Maya I3D Exporter



To generate i3d files of your 3d-models you can use the exporter plugin for Autodesk Maya. The GIANTS Editor and the GIANTS Engine can only load i3d files. This section of the documentation will show you, how to export i3d files with the I3D exporter plugins in Autodesk Maya.

The first thing you probably want to do is to install the exporter plugins in Autodesk Maya.

Preparing your 3d-model for export

Before you can actually use the exporter, it’s wise to check certain things with your 3d-model in Maya which can cause issues later in the editor or the engine.

In the Channel-Box you see the transformations of your selected object.



The ScaleX, ScaleY and ScaleZ of your object should be 1 1 1.
If you just plan to use this object as a static mesh or with no physics at all you could export it with any scale you want, but if you want to simulate your object in the engine (as a dynamic or kinematic rigid body object) the scale must be 1 1 1 otherwise the physics simulation will produce incorrect results.



If you have an object with scale, you can easily get rid of the scale. Go to the Modify-Panel, and select the option box right of the Freeze Transformations. The Freeze Transformations dialog window opens. You can select the checkbox scale and hit apply.

Note: Please refer to the artwork guide for further information about asset conditioning for the engine.


I3D Exporter Usage

Start the exporter dialog with a click on the I3D exporter icon you have created on your custom shelf (see Installing I3D exporter plugins)



Export Panel
The export panel is quite self-explanatory. In the export options part you can include and exclude parts from exporting (IK, Animation, Shapes, Nurbs Curves, Lights, Cameras, Particle Systems and/or Default Cameras). The Shape Export Subparts section allows you to control which subshape attributes are exported (Normals, vertex Colors, Texture Coordinates and/or Skin Weights).

The miscellaneous section has this options:
  • Verbose, display verbose information in output window during the export
  • Relative Paths, generate relative paths for texture files
  • Float Epsilon, truncate values within epsilon range to zero. Epsilon: [-1e-5, 1e-5]

Buttons
  • Preview, exports whole scene to a temporary file and starts the editor
  • Export All, exports the whole scene
  • Export, exports only currently selected objects

Attributes Panel
In the attributes panel you can load and save attributes of your objects those attributes will be saved into the Maya file and are translated into the correct i3d attributes when you export to a i3d file.



The first thing you have to do here is, that you must press the "Load Current" button at the bottom in order to load the attibutes of your object. Otherwise everything is unchecked and is not showing the attributes that are currently active on you object. So be sure, to hit this button first.

Current Node
Here you can see the name of your current working object.

Rigid Body
This section handles all the attributes regarding to physics rigid bodies.

Joint
Here you can define your joint-attributes in detail. One thing you might miss here are the joint limits, they must be defined within Maya, since your object can have many joints with different limits. You can define the limit of a joint angle by the limit informations of your transform-object.

Rendering
  • Occlusion Culling, Objects that are entirely covered by other objects may be culled and thus not rendered at all. This option can increase the rendering performace in the engine if you have big objects containing much smaller objects, for instance a house. If you activate the occlusion culling on the root-node of the house all its childs are also not rendered, if the house is complete covered behind other objects. However, you should not apply this attribute on too many small objects because it is one more task for the engine.
  • Non Renderable, With this option a objects will not be rendered at any time. Use this option for collision geometry. If you have complex objects with sub-objects attached, be careful with this checkbox since this attribute is also going to affect all the attached children.
  • Clip Distance, This value defines how far the object is still going to be rendered. If you have a large scene and tons of objects this is a powerful method to keep your framerate high.
After you have defined all your attributes, you have to hit the "Save Current" button to save your attributes. If you have lots of objects with the same attributes, you can select them all, and then use apply selected to apply the current settings to all the selected objects. Remove current resets the attributes to the default values and if you want do reset multiple objects, you can select them all and hit "Remove Selected"

Validate Panel
With this panel you can validate if one of your objects have an incorrect pivot. In Maya your pivot can have a local and a world space attribute which you can find in the attribute editor on the right side. The x y and z values of both, local and world-space have to be 0 0 0 otherwise you will get a warning. You can fix incorrect pivots with the FreeezeToPivot option in the tools panel.

Tools
If you have validated your objects and a local pivot was not set to 0 0 0, you can quickly fix affected objects with the FreeezeToPivot button.


Material export options

Mapping between Maya and i3d material attributes



Material Attributes
  • Custom Shader: Use the attribute name 'customShader' with a string type to add a custom shader to the material.
    The value specifies the path of the custom shader xml file relative to the maya file.
  • Custom Shader Parameter: Use the attribute name 'customParameter_<parameterName>' with a string type to specify the value of a custom shader parameter. The values should be space separated.
    <parameterName> is the name of the parameter as specified in the custom shader.
  • Custom Shader Texture:: Use the attribute 'customTexture_<textureName>' with a string type to specify the texture of a custom shader texture.
    The value specifies the path of the texture file relative to the maya file.
    <textureName> is the name of the texture as specified in the custom shader.

Install I3D Exporter Plugin Manually

Step 1
Place the files I3DExportUI.mel and I3DExporter2014-x64.mll into the folder "C:/Documents and Settings/<USERNAME>/My Documents/maya/scripts".

Step 2
Start Maya and open the Script Editor window.



Step 3
Select custom shelf tab

Step 4
Type the following commands in the lower portion of the Script Editor:

loadPlugin -qt "C:/Documents and Settings/<USERNAME>/My Documents/maya/scripts/I3DExporter2014-x64.mll";
source I3DExportUI;
I3DExport;
Highlight the commands, then use the middle mouse button, to drag the highlighted MEL commands to the shelf.

Note:
  • Maya don't like backslashes so replace them with slashes.
  • Replace <USERNAME> with your username.
  • The file path can be different depending on the language of your operating system (eg. C:/Documents and Settings/<USERNAME>/My Documents/maya/scripts/I3DExporter2014-x64.mll)

Step 5
Copy the I3D_icon.bmp into the folder "C:/Documents and Settings/<USERNAME>/My Documents/maya/2014/prefs/icons". Edit shelf to replace the default icon with the one enclosed.




Blender I3D Exporter

Install I3D Exporter Plugin Manually (Windows)

  1. Install Blender 2.6.2 32 or 64bit or higher here: http://www.blender.org/download/get-blender/
  2. Extract the io_scene_i3d folder from the exporter zip archive and place it in your Blender addons folder. Example addons folder path: C:\Program Files\Blender Foundation\Blender\2.62\scripts\addons
  3. Launch Blender and go to "File -> User Preferences...".
  4. Click on "Install Addon..." in the "Addons" section.
  5. Browse to the io_scene_i3d folder previously extracted. Example path: C:\Program Files\Blender Foundation\Blender\2.62\scripts\addons\io_scene_i3d
  6. Select the file __init__.py and click "Install Addon...".
  7. Select and enable the "Import-Export: I3D format" addon in the right list. Hint: Apply the "Community" and "Import-Export" filters on the left for less items to browse.
  8. Click on the "Save as Default" button to automatically load the addon each time you launch Blender.
  9. Now, you can export with "File -> Export" to "GIANTS (.i3d)".





Autodesk 3ds MAX and Autodesk Maya are registered trademarks of the Autodesk Corp.