Reference/Import an 3D-file into Smode
Back to
You are here: Features > 3D Layers > Import an FBX/OBJ/3DS/BLEND file into Smode

Reference/Import an 3D-file into Smode

You have the possibility to import or/and refrence various 3D into smode. Smode use the official SDK to load FBX Files and the Open Source library ASSIMP to load OBJ and BLEND files.

  • Be sure to keep only 1 scene and clean all unused materials in your blend/fbx files before trying to import/reference them in smode.
  • Merge all your objects that have the same materials to increase the rendering performances.
  • Smode should also load .3DS, .DXF, .LWO, .STL and .PLY but theses files are not officially supported in smode.


  • Animations/Skeletons are not imported (there is no skeleton system is smode).
  • Files with packed textures doesn't import the texture (but if the name of the texture correspond to a file in the media directory smode will automatically make the link).
  • Files with multiples layers (UV or others) only import the first layer.
  • Materials parameters (diffuse, specular, etc) are not imported.

How to reference a 3D File

To import a 3D File simply drag and drop from the media directory to the compo tree and select Reference.

By default the whole model is referenced but you can select the sub-model to reference in the Sub Geometry To Use. Be carefull using this option ! Renaming the model in your 3D editor will break the link so I highly recommend to work with seperate files for each object that should move seperatetly.

Once you select your sub model the model position is not changed and is relative to file position. So each time you modify the position in your 3D modeler it will update in smode (automatically if you checked the option

Auto Reload

). To avoid that you can tell smode to place the 3D model relative to the used sub-geometry transform using the Use Local Placement option. Then you will have to place manually the model.


  • The materials and textures are not imported or referenced.
  • You can replace an existing Node Generator by drag and drop the file on the generator maintaining the alt key pressed, it will keep all the modifiers, materials, etc.

How to Import a 3D File

Importing a 3D File is now basically the same as referencing. It give the possibility to the user to automatically generate a tree configurating references by:

  • Linking the diffuse and normals textures to material if they are present in the media directory
  • Setting Sub Geometry To Use for each branch of the tree
  • Create a lights and camera at correct placements (theses are not referenced)
  • Setting all the references placements of the 3D file with Use Local Placement
There are some options availables:
  • Hierarchy:
    • Raw: Import the tree as it appear to us when loading the file.
    • Optimized: same a Raw but avoid create extra 3D group and use the generator placement instead if possible.
    • Flattened: Import all references but without creating a tree (only grouping all the refrences).
  • Import as References: I highly recommend to keep this option checked (else you will need to reimport each you modify your geometry).
  • Discard Materials: Don't link diffuse or/and normals textures to models.