README

==================================================================

Questions? 

Please feel free to email me at:

frootee@netzero.net

==================================================================


Installation intructions:


Select the directory where you want to Copy the file: OBJImporter.rsx
to your directory of choice. 

A good location would be:

C:\trueSpace76

Run the vcredistx86.exe executable to install additional support files.
These are required in order to install and load the plugin in the package manager. 

After installation, start truespace, and open the Package Manager.

RIght click in an empty line, and Select:

Install New

The Install New Plugin window opens. 

Navigate to the folder where you copied the OBJImporter.rsx file, select the plugin, 
and select: 

Open

Right click on the newly added line in the 
Package Manager, and select:

Load

The obj plugin toolbar will appear in the center of the trueSpace window.
In this default configuration, the OBJ Import icon is on the left (Blue/Grey icon),
and the OBJ Export icon is on the right (Red/Grey icon). 
You can dock the icons to any other toolbar you like by
Ctrl-click dragging each icon onto the toolbar of your choice.

Click the icons to open the OBJ Importer and Exporter dialog windows.

==================================================================

Import Options:

* Preserve Groups
   Choose this option in order to preserve the grouping of the geometry. 
   On import, the model will be composed of a MainOBJ node, which encapsulates 
   all the groups.

* Material Options: Import Materials
   Choose this option if you want the materials applied to your model on import.

* Material Options: DAZ Import
   By default, DAZ models retain their materials in a subfolder called 'Map'.
   Choose this option to import DAZ models which are configured in this fashion. 

* Scale Options: Scale On Import:
   Type in a value to scale your model appropriately on import. 

* Autofacet Options:
   Check the 'Autofacet Normals' and set the autofacet Angle to autogenerate face 
   normals on import. 

*** On import, the status bar will show progress. In addition, text is displayed indicating 
    the progress of the import. 

==================================================================

Export Options: 

* Export selected Object Anim
   Choose this option to export the animated object as a sequence of OBJ files.

* Material Options: Export Alpha
   Choose this option to export the alpha map

* Material Options: Include UV Scale, Offset
   Choose this option to include the UV Scale and Offset parameters in the map descriptors 
   in the MTL file. 
   NOTE: Some 3d applications do not process the scale ( -s ) and offset ( -o ) UV options.
         So, if you choose this option and you do not see the textures applied to your mesh,
         deselect this option and export again. 

*** On export, the status bar will show progress. In addition, text is displayed indicating 
    the progress of the import. 

* Procedural Animation Export
  Insert the OBJProcAnim RsObj into your procedural animation loop. 
  
  IMPORTANT: You must select your object in 3D space prior to running your procedural animation
             loop. Otherwise a message box will be displayed indicating this. 


==================================================================

NOTES/CAVEATS:

   MATERIALS AND GROUPS:

Serialization/deserialization in trueSpace can take a significant 
amount of time to resolve and may make trueSpace appear non-responsive. 

If this happens, try loading your model with 
"Import Materials" option disabled.


   DAZ IMPORT OPTION:

A "DAZ Import" option has been added. Use this option if you are 
importing an OBJ from DAZ. DAZ writes material files to the \Maps directory.
The first character in this path, the backslash, is interpreted as a 'root' 
directory, instead of a 'relative' directory. By selecting the 'DAZ Import'
checkbox, you ensure the Maps subfolder is correctly accessed by the importer. 

==================================================================

END

==================================================================
