Getting Started
Migrating to UNIGINE 2.0
C++ API Migration
UnigineScript
The Language
Core Library
Engine Library
Node-Related Classes
GUI-Related Classes
Plugins Library
High-Level Systems
Samples
Usage Examples
C++ API
API Reference
Integration Samples
Usage Examples
C++ Plugins

Plugins for 3ds Max

Manual Installation

If Unigine plugins were not installed automatically, do the following:

  1. Go to the Unigine SDK folder, plugins/Max/ directory and choose the plugin depending on the installed version of 3ds Max.
  2. Copy the UnigineMesh.dle and UniginePath.dle files into the 3ds Max plugins folder: for example, 3ds Max 2013/plugins.
  3. Restart 3ds Max to get plugins ready to work.

How to Use the Plugin

You should enable the Unigine mesh exporter on the Utilities panel:

  1. Go to Utilities panel (click the tab on the right-hand column) and click More....

  2. Choose UnigineMesh Utility in the list that appears and click OK.

    The UnigineMesh panel appears in the right-hand column:

To export 3ds Max models, use the following options:

  • Export As... enables to choose the file to which the model should be exported.
  • Export saves the model into the same file (as previously specified in the Export As... option).

For other export options, see below.

Export Static Geometry or Animated Object into Mesh

To export static geometry or an animated object into the *.mesh file:

  1. Select models to be exported.
  2. Do one of the following:
    • On the UnigineMesh panel:
      1. Set up the export options.
      2. Click the Export as.. or Export (to export the whole scene).
      3. On the window that opens, choose the *.mesh format, specify a name and click the Save.
    • In the File menu option:
      1. Choose the Export -> Export selected or Export (to export the whole scene).
      2. On the window that opens, choose the *.mesh format, specify a name and click the Save.
      3. Set up the export options and click OK.

The window with export information opens if the export is done successfully:

Notice
The exported surfaces and animations will be sorted alphabetically.

By using the way described above, you can export animated (skinned) object baked together with its animation in one file (*.mesh).

It is also possible to export only the bind pose of the model (and after that, use it in the engine with separately exported animations, see details below). To export only the bind pose, specify the 0 for the From Frame and To Frame options when setting up the export options:

From Frame = 0; To Frame = 0
Notice
For skinned mesh:
  • The maximum number of bones per surface is equal to 128. If the number exceeds this limit, small child bones will be simply ignored by export.
  • Each vertex can have up to 4 bones assigned to it.

Mesh Export Options

Export into a mesh from 3ds Max

Export of the static geometry or animated object (into MESH format)
Flip Y/Z AxesThis option flips the Y and Z axes and inverts the Y axis. You can export a mesh with a proper orientation even if World Up Vector is set to the Y axis.
Flip Tangent SpaceFlips the sign of the binormal component of the tangent space.
Split By MaterialsIf Multi-materials are used, polygons with the same sub-material assigned are exported as a separate surface.
  • Sub-materials are considered the same if they have the same name.
  • Exported surfaces will be named after names of sub-materials (<objectName>_<materialName>_<submaterialName>).
Export MorphingExports the morph controller.
Export SkinningExports the skin controller.
AlignmentSets a point that will be used as the origin of coordinates:
  • World — use the origin of world coordinates.
  • Pivot — use the pivot coordinates.
    Notice
    When exporting relative to the pivot, the value of the Scale option is ignored. It is reset to the default 100 %.
  • Center — use the center of the model's bounding sphere.
  • Bottom — use the bottom of the model's bounding sphere.
  • Top — use the top of the model's bounding sphere.
ScaleA scaling ratio. This value scales the size of a mesh (static or skinned).
Channel 1UVW channel that should be copied into the 1st UV channel of the exported file. Enter 0 to fill the channel with zeros.
Channel 2UVW channel that should be copied into the 2nd UV channel of the exported file. Enter 0 to fill the channel with zeros.
From FrameStart animation time. You can specify the -1 to use the start time of the current viewport configuration.
To FrameEnd animation time. You can specify the -1 to use the end time of the current viewport configuration.

Export Only Animation of Skinned Mesh

You can export only animation (bones transformations) of a skinned mesh to a separate file. This way, you can have only one mesh and choose what animations to set for it.

To export only animation into *.anim file:

  1. Select a skinned mesh which animation is going to be exported.
  2. On the UnigineMesh panel set up the export options.
  3. Click the Export as.. or Export (to export the whole scene).
  4. On the window that opens, choose the *.anim format, specify a name and click the Save.

The window with export information opens if the export is done successfully:

Notice
The exported animations will be sorted alphabetically.

Export Path Transformation

You can export a spline (a line or other shape) along which object movement is constrained (via Animation -> Constraints -> Path Constraint in 3ds Max) to a *.path file (a native Unigine path).

Notice
A path will be exported only if both the UnigineMesh.dle and UniginePath.dle files are located in the 3ds Max plugins folder.

To export a spline to the *.path file:

  1. Select an object which movement is restricted along a spline.
  2. On the main menu, select -> Export -> Export Selected.
    Notice
    You can export only one path at a time.
  3. On the window that opens, choose the *.PATH format, specify a name and click Save.
  4. Set up the export options and click OK.

The window with export information opens if the export is done successfully:

You can create, for example, a frame-based succession of transformations from the exported path (an instance of the WorldTransformPath class).

Path Export Options

Flip Y/Z AxesFlips the Y and Z axes and inverts the Y axis. You can export a path with a proper orientation even if World Up Vector is set to the Y axis.
ScaleA scaling ratio. This value scales the size of a path.
From FrameStart animation time. You can specify the -1 to use the start time of the current viewport configuration.
To FrameEnd animation time. You can specify the -1 to use the end time of the current viewport configuration.

Import of Unigine Mesh or Skinned Mesh

To import the native Unigine mesh of skinned mesh (*.mesh file) into 3ds Max:

  1. On the main menu, select File -> Import.
  2. Choose a *.mesh file and click the Open.
  3. Specify the import options and click OK.

Notice
The old formats *.mesh and *.smesh can also be imported.

Mesh Import Options

Flip Y/Z AxesFlips the Y and Z axes and inverts the Y axis. You can export a mesh with a proper orientation even if World Up Vector is set to the Y axis.
Import MorphingImports the morph controller.
Import SkinningImports the skin controller.
ScaleA scaling ratio. This value scales the size of a mesh (static or skinned).

Import of Unigine Skinned Mesh Animation

To import the animation of Unigine skinned mesh (*.anim file ) into 3ds Max:

  1. On the main menu, select File -> Import.
  2. Choose an *.anim file and click the Open.
  3. Specify the import options and click OK.

Notice
The *.sanim format can also be imported.
Last update: 2017-07-03