XSI DTS Exporter Beta 2 Download
by Matt Summers · in Artist Corner · 02/02/2009 (10:14 pm) · 333 replies

Whats New:
This is an updated version of the XSI DTS exporter which corrects issues with exported animation transforms, adds support for exporting .DSQ animation files, and fixes several other small bugs. This version of the exporter now also requires adjustment of the bounds axes for proper export. (see basic setup section below for more information)The file download includes the new plugin, 2 sample scenes in XSI 7 and XSI Modtool 6 format, and 2 sample DTS shapes exported from XSI 7 using the exporter for reference.
The 2 sample files that are included with the exporter are the TGE Orc rigged with a simple null based skeleton that will export and work with the default player .DSQ files, and a simple example of an animated object using XSI bones. More sample files are in the works and will be made available as they are completed.
XSI Modtool Support:
The XSI DTS exporter is fully compatible with the latest version of [ XSI Modtool ]. Modtool is lightly stripped down version of Softimage XSI 6.x that is free for non-commercial use. View the full list of Modtool Version Limitations [ here ].
The default UI of Modtool has been setup to be more first time user friendly, but you can also choose to use the stock XSI UI instead by going to the Modes menu and choosing the "XSI default (pro mode)" UI preset.

Basic Scene Setup:
Scene setup needs to be done manually until the exporter UI is completed. This involves creating a DTS shape using nulls, creating a bounds mesh, detail markers, and a mesh object with a detail size number at the end of its name. Scene setup is almost identical to the that of the Max and Maya DTS exporters.Create two null objects named "base01" and "start01" parent them so that "base01" is the parent node and "start01" is the child node. Parent your mesh object to "start01" and then add a bounding box around your object and name it "bounds". The bounds mesh should be either at the scene root or parented to one of the nodes or mesh objects in the scene.
Bounds Axes Orientation
You must also rotate the center of your bounds so that the Z axes points up, the Y axes points forward, and X axes points to the right. Your shape should face forward in the Y axes of your bounds. (as in the image to the right)
Detail Markers
You then need to add a detail marker to the scene named "detail(x)" where (x) = the pixel size value that this detail level should be displayed. The detail maker is just a named null object that is parented to the "base01" node. You will also need to make sure your mesh objects have a detail size at the end of their name. You can then go to file menu / export and choose export DTS.
Example: simple object scene setup
Scene Root
|
+ -bounds {mesh}
|
+ -Base01 {null}
|
+ -Start01 {null}
| |
| + -mesh2 {mesh} (detail size 2)
|
+ -detail2 {null} (detail marker for size 2)[ Orc player scene setup ] | [ Simple bone animation scene setup ]Exporting Animation
To export animation from your scene you must add one or more sequence markers to the root of your scene. A sequence marker is a named null object with a Custom Parameter Set that contains at minimum 2 custom parameters; an integer property named startFrame and an integer property named endFrame.Sequence markers should be named "sequence_" followed by the name you would like to give the animation. (example: sequence_ambient)
If a sequence marker is present in the scene, on export to DTS the named animation sequences will be embeded into the DTS shape. You can optionally click the "export DSQ" button on the exporter window to export the animation(s) seperately as .DSQ files.
Quote:Note: make sure to freeze the transforms on your bounds and mesh objects before exporting. Because the exporter supports scale animation object scale is read by the exporter and as a result if there are scale transforms on the exported shape when the object is loaded as a static shape it will appear at its un-scaled state and If it is loaded as an animated shape it would shrink down to its scaled size.
This build of the XSI DTS exporter is compiled using the XSI 6.x SDK and is compatible with the 32-bit versions of XSI 6.x, 7.x and XSI Modtool version 6.x and 64-bit versions of XSI 7.x.
[ Download The Exporter (Beta 2.5) ]
About the author
#82
An updated DTS Utility is now available. This update includes:
This update also adds 7 new Custom Scripting Commands
This brings the automation level of the Utility to Feature Complete. There are still a few more automation tools I will be adding to the Utility, but everything else from this point is just a bonus.
There is still a lot of testing that needs to be done to make sure that all of the automation tools function properly, but I will be testing every feature and building examples during the documentation phase so it should all work out by then.
So as the automation stage ramps down and the documentation stage ramps up, the utility alone is nearly 3,000 lines of code (it will be over that later today) and took almost a month of developement. I figure it will end up taking about the same amount of time to finish the documentation as well. This is why writing exporters sucks. :)
As before the exporter download has been updated, but you can also download the updated Utility seperately here.
03/28/2009 (1:48 pm)
Updated DTS UtilityAn updated DTS Utility is now available. This update includes:
- Automation for Mesh Sorting (in the details menu)
- Automation for Triggers (in the sequences menu)
- Automation for Visibility Animation (in the sequences menu)
This update also adds 7 new Custom Scripting Commands
- DTS_RemoveBounds
- DTS_AddSort
- DTS_RemoveSort
- DTS_AddVis
- DTS_RemoveVis
- DTS_AddTriggers
- DTS_RemoveTriggers
This brings the automation level of the Utility to Feature Complete. There are still a few more automation tools I will be adding to the Utility, but everything else from this point is just a bonus.
There is still a lot of testing that needs to be done to make sure that all of the automation tools function properly, but I will be testing every feature and building examples during the documentation phase so it should all work out by then.
So as the automation stage ramps down and the documentation stage ramps up, the utility alone is nearly 3,000 lines of code (it will be over that later today) and took almost a month of developement. I figure it will end up taking about the same amount of time to finish the documentation as well. This is why writing exporters sucks. :)
As before the exporter download has been updated, but you can also download the updated Utility seperately here.
#83
How is the Documentation process coming?
Has anyone used this with the new release of ModTool 7.5?
04/19/2009 (11:24 am)
Nice work Matt!!!How is the Documentation process coming?
Has anyone used this with the new release of ModTool 7.5?
#84
The latest build of the exporter and automation tool work with Softimage 6.5, 7.0, 7.5, ModTool 6.x, ModTool 7.5 and ModTool 7.5 Pro.
If you have any problems or questions feel free to post on the forums or contact me directly.
04/19/2009 (1:03 pm)
The Documentation for the exporter is in progress. Another week or 2 and I should have a bunch of it ready for use.The latest build of the exporter and automation tool work with Softimage 6.5, 7.0, 7.5, ModTool 6.x, ModTool 7.5 and ModTool 7.5 Pro.
If you have any problems or questions feel free to post on the forums or contact me directly.
#85
04/21/2009 (6:35 pm)
Will the exporter work with XSI 5.11
#86
I dont have a copy of the XSI 5.x SDK, but as I mentioned before if it were compiled with the XSI 5.x SDK it should work. The current versions are compiled with the XSI 6.x and 7.x SDKs.
04/21/2009 (8:43 pm)
Quote:I am reasonably sure that if it were compiled using the XSI 5.x SDK it would work. It is currently compiled using the 6.x SDK for 32bit and 7.x SDK for 64bit.
The only major SDK dependency in the compiled exporter is the CGeometryAccessor Class, which was added to XSI in version 5.0. The scripted Utility should work in XSI 5.x as well.
You could test parts of the scripted Utility, but keep in mind that the Utility needs the compiled exporter for some of its functionality.
I dont have a copy of the XSI 5.x SDK, but as I mentioned before if it were compiled with the XSI 5.x SDK it should work. The current versions are compiled with the XSI 6.x and 7.x SDKs.
#87
04/21/2009 (9:41 pm)
I just checked Matt and there is a 5.11 for 32bit and 64bit still in the maintenance section I can DL it tomorrow and compile it and send it to you if you like Matt. Shoot me an email tomorrow. If the source I have is still up to date. Which I think that it is.
#88
04/21/2009 (9:58 pm)
Sounds good James, Im sure there are few XSI 5 users that would be very happy if you did so. Let me know if you run into any problems.
#89
04/24/2009 (5:57 pm)
@James B. I was wondering if you were able to compile it
#90
04/28/2009 (10:37 am)
I have not. Been on a project that wraps up this week I will do it then. Been working 16 hour days
#91
' ERROR : 2028 - Invalid argument specified. - [line 1198 in C:\Softimage\Softimage_Mod_Tool_7.5\Application\Plugins\xsi2dtsUtility.js]
' ERROR : 2028-DTS_QuickSetup - Invalid argument specified.
DTS_QuickSetup
I'm sure that I'm making a simple error. Could anyone suggest how I might fix this? It would be great to be able to setup a scene automatically rather than manually.
05/08/2009 (8:18 am)
This is a really cool exporter, and I'm especially excited about the automated setup features. I've started by trying to use these features to set up simple scenes with primitive objects, like a cube or an octahedron. However, each time that I select one of these objects and use any of the automated options from the Torque menu at the top of Softimage Mod Tool, I get the error message "Invalid argument specified." This happens with the Quick Setup, Bounds, Collision, and Detail commands in both Mod Tool 6.0 and 7.5. Specifically, here is the longer version of the error for the quick setup option:' ERROR : 2028 - Invalid argument specified. - [line 1198 in C:\Softimage\Softimage_Mod_Tool_7.5\Application\Plugins\xsi2dtsUtility.js]
' ERROR : 2028-DTS_QuickSetup - Invalid argument specified.
DTS_QuickSetup
I'm sure that I'm making a simple error. Could anyone suggest how I might fix this? It would be great to be able to setup a scene automatically rather than manually.
#92
looks like it is erroring for you because the utility is trying to read the custom preferences for the exporter and can't access them.
The specific line that is erroring for you (line 1198) is trying to get the default name that is used for the start node in the DTS shape.
The first time you open the DTS Menu it should register the custom properties with your Softimage install, you are the second person to have this issue and it seems related to file permissions or installation path.
The work around is to manually add the custom preferences for the exporter to your Softimage Install. Download this file
Place the contents of the zip file in your Softimage preferences directory. For example (C:\Softimage\Softimage_7.5\Data\Preferences\) or in your user preferences directory (C:\Users\[username]\Softimage\XSI_7.0\Data\Preferences\)
Restart Softimage after you install the custom preference file for the exporter and you should be good to go.
05/08/2009 (11:11 am)
@Jeff:looks like it is erroring for you because the utility is trying to read the custom preferences for the exporter and can't access them.
The specific line that is erroring for you (line 1198) is trying to get the default name that is used for the start node in the DTS shape.
The first time you open the DTS Menu it should register the custom properties with your Softimage install, you are the second person to have this issue and it seems related to file permissions or installation path.
The work around is to manually add the custom preferences for the exporter to your Softimage Install. Download this file
Place the contents of the zip file in your Softimage preferences directory. For example (C:\Softimage\Softimage_7.5\Data\Preferences\) or in your user preferences directory (C:\Users\[username]\Softimage\XSI_7.0\Data\Preferences\)
Restart Softimage after you install the custom preference file for the exporter and you should be good to go.
#93
Thanks very much for the workaround and the file. I installed it as you suggested, and the simple scene setup option now works without errors. Much appreciated.
05/08/2009 (11:24 am)
@Matt:Thanks very much for the workaround and the file. I installed it as you suggested, and the simple scene setup option now works without errors. Much appreciated.
#94
The setup issue is now resolved, but I'm running into another problem when I try to export the object. After I do the quick setup and check to make sure that the required nodes are in place, I then choose the Export DTS option from the Torque menu. The progress bar goes about a fourth of the way and says "generating objects," and then Mod Tool crashes and I get an error message that says "failed to save scene before system failure." This happens in both Mod Tool 6.0 and 7.5, and it occurs repeatedly with every model that I've tried.
Do you have any suggestions as to what might be going wrong? The scene setup now works like a charm for me, which is awesome, but it would be great to be able to export these models.
05/08/2009 (12:20 pm)
@Matt:The setup issue is now resolved, but I'm running into another problem when I try to export the object. After I do the quick setup and check to make sure that the required nodes are in place, I then choose the Export DTS option from the Torque menu. The progress bar goes about a fourth of the way and says "generating objects," and then Mod Tool crashes and I get an error message that says "failed to save scene before system failure." This happens in both Mod Tool 6.0 and 7.5, and it occurs repeatedly with every model that I've tried.
Do you have any suggestions as to what might be going wrong? The scene setup now works like a charm for me, which is awesome, but it would be great to be able to export these models.
#95
Are you using the export to DTS option from the Torque menu? or from the Softimage file/export menu?
Also, make sure that in the export window the "Select Root" drop down list is set to "Scene_Root". If the select root option is blank for some reason it could cause the exporter to crash. It should always default to "Scene_Root". If you renamed the scene root to something besides "Scene_Root" that could cause it to crash as well. In one of the next builds I will work on makeing the exporter error more gracefully.
See this post for more info about the select root drop down.
05/08/2009 (12:39 pm)
@Jeff:Are you using the export to DTS option from the Torque menu? or from the Softimage file/export menu?
Also, make sure that in the export window the "Select Root" drop down list is set to "Scene_Root". If the select root option is blank for some reason it could cause the exporter to crash. It should always default to "Scene_Root". If you renamed the scene root to something besides "Scene_Root" that could cause it to crash as well. In one of the next builds I will work on makeing the exporter error more gracefully.
See this post for more info about the select root drop down.
#96
I've been using the export to DTS option from the Torque menu most of the time. I just tried the file/export menu option in response to your post, and I still get the same crash and error message.
I also checked to make sure that the select root drop down list is set to "Scene_Root". It is, and I have not renamed the file.
So those two issues don't seem to be the source of the problem. Do you have any other suggestions as to what might be happening? Is there a console or log I could check that would register an error that caused a crash and might help us to diagnose the problem?
Thanks for your help.
05/08/2009 (12:57 pm)
@Matt:I've been using the export to DTS option from the Torque menu most of the time. I just tried the file/export menu option in response to your post, and I still get the same crash and error message.
I also checked to make sure that the select root drop down list is set to "Scene_Root". It is, and I have not renamed the file.
So those two issues don't seem to be the source of the problem. Do you have any other suggestions as to what might be happening? Is there a console or log I could check that would register an error that caused a crash and might help us to diagnose the problem?
Thanks for your help.
#97
Have you tried exporting either of the sample scenes that are included with the exporter?
05/08/2009 (1:17 pm)
What are you exporting?Have you tried exporting either of the sample scenes that are included with the exporter?
#98
Any luck yet? I am using the exporter with Sotimage 7.0 and 7.5 with no problems, so I would be curious to know what you are exporting that is causing it to crash.
05/09/2009 (8:20 am)
@Jeff:Any luck yet? I am using the exporter with Sotimage 7.0 and 7.5 with no problems, so I would be curious to know what you are exporting that is causing it to crash.
#99
Based on your suggestion, I did try exporting the tge_orc scene that comes with the exporter. When using the export DTS option from the Torque menu, Mod Tool does not crash altogether, but it does not export the model. Instead, I get an error message of "unexpected failure." Here is the complete error message.
ExportDtsCommand
' ERROR : Object doesn't support this property or method - [line 586 in C:\Softimage\XSI_6_Mod_Tool\Application\Plugins\xsi2dtsUtility.js]
' ERROR : 2006-DTS_ExportDTS - Unexpected failure.
DTS_ExportDTS
' ERROR : Object doesn't support this property or method - [line 586 in C:\Softimage\XSI_6_Mod_Tool\Application\Plugins\xsi2dtsUtility.js]
' ERROR : 2006-DTS_ExportDTS - Unexpected failure.
DTS_ExportDTS
I wonder if I have something configured wrongly?
05/09/2009 (11:47 am)
I'm exporting simple objects, such as a sword, a book, and a dodecahedron. None of the items that I'm trying to export have rigging or animation; my items are just low-poly models.Based on your suggestion, I did try exporting the tge_orc scene that comes with the exporter. When using the export DTS option from the Torque menu, Mod Tool does not crash altogether, but it does not export the model. Instead, I get an error message of "unexpected failure." Here is the complete error message.
ExportDtsCommand
' ERROR : Object doesn't support this property or method - [line 586 in C:\Softimage\XSI_6_Mod_Tool\Application\Plugins\xsi2dtsUtility.js]
' ERROR : 2006-DTS_ExportDTS - Unexpected failure.
DTS_ExportDTS
' ERROR : Object doesn't support this property or method - [line 586 in C:\Softimage\XSI_6_Mod_Tool\Application\Plugins\xsi2dtsUtility.js]
' ERROR : 2006-DTS_ExportDTS - Unexpected failure.
DTS_ExportDTS
I wonder if I have something configured wrongly?
#100
05/09/2009 (1:12 pm)
Try exporting from Modtool 7.5 and see if you get any errors.
Associate Matt Summers
Dark Industries
The only major SDK dependency in the compiled exporter is the CGeometryAccessor Class, which was added to XSI in version 5.0. The scripted Utility should work in XSI 5.x as well.
You could test parts of the scripted Utility, but keep in mind that the Utility needs the compiled exporter for some of its functionality.