Version 4 (modified by martin, 9 years ago)


Using the OSG Exporter Plugin

From within 3D Studio you can use several ways to start the plugin;

  1. Select 'More...' on the 'Utility'-pane and choose the 'OSG Export toolbar'. The toolbar will appear and the export function are available through it
  2. Choose 'Export...' from the 'File'-menu and choose *.IVE, *.OSG as file type (typing the extension specifies which one will be used). This will open a dialog box with the options;
  3. The Helpers are available from the 'Helpers'-section on the 'Create'-pane.

The OSG Exporter Toolbar

Export the whole scene and preview it in Max
Export the selected objects and preview in Max
Export the file as an .OSG-file (to default export-folder)
Export the file as an .IVE-file (to default export-folder)
Set the options for exporting
About the plugin

Exporting files

%red% Warning: When you work with Groups in MAX, make sure they are all closed before you export, otherwise these objects will not appear in the .OSG/.IVE-file! %%

.IVE vs. .OSG

You can export a 3D Studio file without changing anything by simply exporting it to OSG or IVE. IVE-files tend load quicker. They are however more prone to errors (this is a binary file format). The OSG-files will usually load up to 20 times slower than the IVE-files, but are more robust.


Not everything modelled in 3D Studio can be exported flawlessly to an OSG-file. Below is a list of things that might prove impossible to export and some suggesting to make them work anyway.

  • Animated modifiers: use an OSG Sequence Helper to make this work. Otherwise the animation behaviour of the objects may be unpredictable.
  • Some Space Warps
  • Particle Systems?: only simple ones can be exported without a problem. For complex Particle Systems? the use of an {{OSG Sequence}} could also be an option.
  • The AEC Exteneded geometrical object could pose a problem. So far it turns out that the Foliage-objects (trees, shrubs and other items) are not exported very well, supposedly due to the large number of very small objects which the viewer will cull.

Export options

When you've selected a file type you will be presented with a large dialog box:

Note: this dialog can be accessed directly form the OSG Exporter Toolbar

  1. Output:
    • Save File: if you uncheck this option, no copy of your file will be saved to disk. This can be useful if you only want to Quick View your scene.
    • Save Texture Images: When exporting to a .ive-file the textures will be stored in the file. When exporting to .osg files, this should also be checked; the images will be saved in an “images” directory in the same directory as the exported file is saved.
    • Quick View Scene: This will create a small preview window within 3D Studio MAX. Take care when selecting these options, since it might cause some unstability and you might have to reset 3D Studio wink
  2. Optimize:
    • Tri Strip Geometry:
    • Merge Geometry:
    • Flatten Static Transform:
    • Share Duplicate States:
    • Spatialize Groups:
  3. Export to Scene: lets you select which part of your scene you wish to export.
  4. Error reporting: turn this on the get some feedback about the conversion progress.
  5. Node Mask: The Default Node Mask value lets you specify a certain Nodemask-value to all objects for which no value is specified (for instance in a {{OSG Nodemask}} Helper.
  6. Geometry State
    • Texture coordinates:
    • Vertex Normals:
    • Vertex Colors:
    • Use indices:
    • Normalize normals:
    • Turn off Lighting:
  7. Material State
    • Diffuse Color:
    • Self-Illumination:
  8. Texture State:
    • Texture Format:
    • Texture Compression: determines the file-format the textures will be saved in and which compression algorithm will be used. It's safe to leave these at the defaults.

Using the OSG Helpers

The OSG Exporter comes with 9 Helper-objects.

# {{OSG BillBoard?}} # {{OSG LOD}} # {{OSG NodeMask?}} # {{OSG Impostor}} # {{OSG Visibility Group}} # {{OSG StateSet?}} # {{OSG Sequence}} # {{OSG Switch}} # {{OSG Occluder}}