21
edits
m (/cat; the "tools" categories are for community-made tools; adding {{finish}} since I see some "..."s) |
(Update notice w/ summary) Tags: Mobile edit Mobile web edit |
||
(40 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
{{update|This article contains links to the now defunct Oni Central Forum. Sections: Selected Wisdom}} | |||
Autodesk's Mod Tool used to be the main choice for modders when working on level and character models (at least in Windows, since it's Windows-only). It was a free and accessible program, but has long since been discontinued. Nowadays, modders are encouraged to use [[Blender]] instead. | |||
{| class="wikitable" style="float:right;" | {| class="wikitable" style="float:right;" | ||
|width="200px"| | |width="200px"| | ||
Line 9: | Line 10: | ||
|} | |} | ||
==Installation== | |||
Full name: "Autodesk Softimage Mod Tool". Usually we just call it "Mod Tool" or "XSI", the old name of the program. | |||
'''Download''' | |||
* '''Get it from [https://www.moddb.com/downloads/autodesk-softimage-mod-tool-75 Mod DB].''' | |||
* It's no longer possible to download Softimage from Autodesk because the [https://www.autodesk.com/products/softimage/overview software was discontinued] by Autodesk in favor of their major software packages Maya and 3ds Max. | |||
'''Newer Windows installations usually require .NET 2.0 to be installed before the XSI installer can fully run.''' | |||
: | : Downloading and installing .Net 2.0 manually from the internet might not work. | ||
: | : '''Therefore use the Windows search and look for "features".''' (Enable/disable Windows features.) | ||
: From the Windows feature page install '''".NET framework 3.5 (includes .NET 2.0 and 3.0)"'''. | |||
There are various ways to extend Mod Tool's range of functions: scripts (.vbs, .js), toolbars (.xsitb) and addons (.xsiaddon). They can be created on one's own and also shared with other users. | |||
===Extensions=== | |||
==Extensions== | |||
'''links''' | '''links''' | ||
* [ | * [https://www.si-community.com/community/viewtopic.php?f=35&t=796 "Roadkill" UV Tool] | ||
* [http://www.xsidatabase.com/content/drag_and_drop_obj_files_jscript drag and drop support for OBJ files] | * [http://web.archive.org/web/20121001104022/http://www.xsidatabase.com:80/content/drag_and_drop_obj_files_jscript drag and drop support for OBJ files] | ||
* [ | * [https://www.si-community.com/community/viewtopic.php?f=35&t=797 OBJ exporter] | ||
* [http://mods.oni2.net/node/210 OBJ + OFGA exporter] for Oni | * [http://mods.oni2.net/node/210 OBJ + OFGA exporter] for Oni | ||
** might need the regular OBJ exporter to be installed first | ** might need the regular OBJ exporter to be installed first | ||
* [http://mods.oni2.net/node/210 adjusting existing fw throws] [ | * [http://mods.oni2.net/node/210 adjusting existing fw throws] [https://www.youtube.com/watch?v=vDTPYfvMf4M (instructions)] | ||
Line 67: | Line 58: | ||
''' | '''building add-ons (<nowiki>http://softimage.wiki.softimage.com/sdkdocs/cus_addons_WalkthroughBuildinganAddon.htm</nowiki>, dead link)''' | ||
* Building an add-on file needs more effort than the other 'extensions' but for the end user it's best because it can hold all other files: toolbars, plugins (scripts), etc. | * Building an add-on file needs more effort than the other 'extensions' but for the end user it's best because it can hold all other files: toolbars, plugins (scripts), etc. | ||
** The user can install a newer version of the addon by repeating the installation with the new file: it's unnecessary to remove the old version. | ** The user can install a newer version of the addon by repeating the installation with the new file: it's unnecessary to remove the old version. | ||
Line 159: | Line 150: | ||
end if | end if | ||
end function | end function | ||
==Selected wisdom== | ==Selected wisdom== | ||
We've also a [http://oni.bungie.org | We've also a [http://oni.bungie.org/forum/viewtopic.php?id=1229 tutorial thread on OCF.] | ||
Hotkey list can be found [http://www.keyxl.com/aaacbe0/415/SoftImage-XSI-keyboard-shortcuts.htm here]. | Hotkey list can be found [http://www.keyxl.com/aaacbe0/415/SoftImage-XSI-keyboard-shortcuts.htm here]. | ||
Line 202: | Line 192: | ||
** B) goto Model > Modify > Poly. Mesh > Bridge Boundary Points/Edges (if blue lines appear try to disable the checkbox "Angle > 90") | ** B) goto Model > Modify > Poly. Mesh > Bridge Boundary Points/Edges (if blue lines appear try to disable the checkbox "Angle > 90") | ||
* merging two objects at blue lines: merge the objects at first, then proceed with the point above "filling a hole" | * merging two objects at blue lines: merge the objects at first, then proceed with the point above "filling a hole" | ||
* '''merging two objects with UVs''': Create > Poly. Mesh > [http://cryrid.com/images/temp/XSI/merge_materials.jpg Merge] | * '''merging two objects with UVs''': Create > Poly. Mesh > [https://web.archive.org/web/20160225163131/http://cryrid.com/images/temp/XSI/merge_materials.jpg Merge] | ||
** extracted Oni characters have their materials and hence textures directly grouped under the mesh (see Explorer) | ** extracted Oni characters have their materials and hence textures directly grouped under the mesh (see Explorer) | ||
** when adding (merging) a new part to the existing mesh, the materials/textures will be grouped under (Explorer again) mesh > Polygon Mesh > Clusters > ... | ** when adding (merging) a new part to the existing mesh, the materials/textures will be grouped under (Explorer again) mesh > Polygon Mesh > Clusters > ... | ||
** Samer reported that saving the file via fbx solves a problem when trying to convert TRBS | ** Samer reported that saving the file via fbx solves a problem when trying to convert TRBS | ||
** one would need to | ** one would need to move the content by hand in the explorer to bypass the fbx | ||
* hiding some objects/polygons: select object/polygon and hit [H], use [Control] + [H] to unhide all | * hiding some objects/polygons: select object/polygon and hit [H], use [Control] + [H] to unhide all | ||
* mirroring an object: select object, Modify > Poly. Mesh > Symmetrize Polygons | * mirroring an object: select object, Modify > Poly. Mesh > Symmetrize Polygons | ||
Line 294: | Line 284: | ||
Things to test: | Things to test: | ||
* | * https://vimeo.com/67783125 | ||
===Rendering=== | |||
Rendering doesn't work well on my PCs.--[[User:Paradox-01|paradox-01]] ([[User talk:Paradox-01|talk]]) 01:09, 9 March 2016 (CET) | |||
Especially PNG, it works one time. But as soon as I import another dae the next render will fail. | |||
So, for creating a object library we might use blender. Nice thing is, it can also render in the background when called from CMD. This means you could keep working in XSI and render images in blender at the same time. | |||
example of a batch file: | |||
cd C:\Program Files\Blender Foundation\Blender | |||
blender -b --python C:\Users\Paradox-01\Desktop\blender-out\pythonScript.py | |||
example of a render script: | |||
import bpy | |||
# delete blender default cube object | |||
bpy.ops.object.mode_set(mode='OBJECT') | |||
bpy.ops.object.select_by_type(type='MESH') | |||
bpy.ops.object.delete(use_global=False) | |||
# load new object | |||
bpy.ops.wm.collada_import(filepath = "C:/Oni/r.dae") | |||
# render settings | |||
bpy.data.scenes['Scene'].render.resolution_x = 900 | |||
bpy.data.scenes['Scene'].render.resolution_y = 900 | |||
# default resolution percentage seems to be 50 | |||
bpy.data.scenes['Scene'].render.resolution_percentage = 100 | |||
bpy.data.scenes['Scene'].render.use_antialiasing = True | |||
# 5 | 8 | 11 | 16 | |||
bpy.data.scenes['Scene'].render.antialiasing_samples = "8" | |||
#TGA IRIS JPEG MOVIE IRIZ RAWTGA | |||
#AVIRAW AVIJPEG PNG BMP FRAMESERVER | |||
#no gif ? could be created by more code, maybe merging single frames of jpgs | |||
bpy.data.scenes['Scene'].render.image_settings.file_format = 'JPEG' | |||
bpy.data.scenes['Scene'].render.image_settings.quality = 100 | |||
# file suffix is overwritten by file_formate | |||
#bpy.data.scenes['Scene'].render.filepath = 'C:/Oni/renders/test.jpg' | |||
bpy.data.scenes['Scene'].render.filepath = 'C:/Oni/renders/test' | |||
# start render | |||
bpy.ops.render.render( write_still=True ) | |||
Line 388: | Line 426: | ||
Open the animation mixer with [Alt]+[0]. | Open the animation mixer with [Alt]+[0]. | ||
Further information over [http://softimage.wiki.softimage.com/xsidocs/nla_mixer.htm#Rdw10200 HERE.] | Further information over [http://web.archive.org/web/20170103065301/http://softimage.wiki.softimage.com/xsidocs/nla_mixer.htm#Rdw10200 HERE.] | ||
Here are a few videos: | Here are a few videos: | ||
* ''' | * '''https://www.youtube.com/watch?v=-xC31Q7zpM0''' | ||
* | * https://www.youtube.com/watch?v=njLrAIpDOFU | ||
* | * https://www.youtube.com/watch?v=PRDZaEo5CGo | ||
Line 399: | Line 437: | ||
Within the animation mixer also sounds can be added. | Within the animation mixer also sounds can be added. | ||
Further information over [http://softimage.wiki.softimage.com/xsidocs/audio_LoadingAudioFilesintheAnimationMixer.htm#Rdy36984 HERE.] | Further information over [http://web.archive.org/web/20170102120711/http://softimage.wiki.softimage.com/xsidocs/audio_LoadingAudioFilesintheAnimationMixer.htm#Rdy36984 HERE.] | ||
This could be used to synchronize sounds effect with physical actions in the scene. | This could be used to synchronize sounds effect with physical actions in the scene. | ||
Line 419: | Line 457: | ||
'''Links''' | '''Links''' | ||
* [http://softimage.wiki.softimage.com/index.php?title=Scripting_Tips_and_Tricks_%28XSISDK%29 xsi wiki page about scripting] | * [http://web.archive.org/web/20160803061035/http://softimage.wiki.softimage.com/index.php?title=Scripting_Tips_and_Tricks_%28XSISDK%29 xsi wiki page about scripting] | ||
* '''[http://softimage.wiki.softimage.com/sdkdocs/scriptsdb/scriptsdb/scrdb_vbscript.htm many vbscript examples]''' | * '''[http://web.archive.org/web/20170616035120/http://softimage.wiki.softimage.com/sdkdocs/scriptsdb/scriptsdb/scrdb_vbscript.htm many vbscript examples]''' | ||
* '''[ | * '''[https://ss64.com/vb/ vbs commands]''' | ||
* [ | * [https://web.archive.org/web/20070510173452/https://www.activexperts.com/activmonitor/windowsmanagement/adminscripts/filesfolders/files/ objFSO/objWSHShell: Scripts to manage Files] (replace "Wscript.Echo" with "logmessage") | ||
* [http://activexperts.com/activmonitor/windowsmanagement/adminscripts/other/textfiles/ objFSO/objWSHShell: Scripts to manage Text Files] | * [https://web.archive.org/web/20150504221146/http://activexperts.com/activmonitor/windowsmanagement/adminscripts/other/textfiles/ objFSO/objWSHShell: Scripts to manage Text Files] | ||
* [http://www.kxcad.net/ | * [http://web.archive.org/web/20080905102848/http://www.kxcad.net/softimage_xsi/Softimage_XSI_Documentation/script_basics_IncludingExternalScripts.htm using external scripts] | ||
* [ | * [https://download.autodesk.com/global/docs/softimage2013/en_us/sdkguide/index.html?url=si_om/XSIUIToolkit.html,topicNumber=si_om_XSIUIToolkit_html progress bar and open file dialog<!-- (hm, InitialDirectory code for quick save idea ?)-->] | ||
<!--* [http://download.autodesk.com/global/docs/softimage2013/en_us/sdkguide/index.html?url=files/cus_ppg_FileBrowserWidget.htm,topicNumber=d30e11980,hash=WS34BA39B437A993419C80CAB58E3BEFA1-0059 text box]--> | <!--* [http://download.autodesk.com/global/docs/softimage2013/en_us/sdkguide/index.html?url=files/cus_ppg_FileBrowserWidget.htm,topicNumber=d30e11980,hash=WS34BA39B437A993419C80CAB58E3BEFA1-0059 text box]--> | ||
Line 445: | Line 483: | ||
* The commands are not case-sensitive, e.g. you can write "LogMessage" or "logmessage". | * The commands are not case-sensitive, e.g. you can write "LogMessage" or "logmessage". | ||
* Vbs functions can be found [ | * Vbs functions can be found [https://web.archive.org/web/20150707131602/https://www.w3schools.com/vbscript/vbscript_ref_functions.asp HERE.] | ||
' while it is possible to use + in strings, | ' while it is possible to use + in strings, | ||
Line 545: | Line 583: | ||
: ToggleSelection "grid2,grid3" | : ToggleSelection "grid2,grid3" | ||
|- | |- | ||
|valign=top| [ | |valign=top| [https://download.autodesk.com/global/docs/softimage2013/en_us/sdkguide/index.html?url=si_cmds/SelectAllUsingFilter.html,topicNumber=si_cmds_SelectAllUsingFilter_html SelectAllUsingFilter] <nowiki>[SelFilter], [CheckComponentVisibility], [AffectSelectionList], [CheckObjectSelectability]</nowiki> | ||
|Selects everything that matches the filter and other options. Example: | |Selects everything that matches the filter and other options. Example: | ||
: SelectAllUsingFilter "object", siCheckComponentVisibility | : SelectAllUsingFilter "object", siCheckComponentVisibility | ||
Line 563: | Line 601: | ||
| Makes all changes final. But saving those changes is still necessary. (Click on key symbol so it gets red.) | | Makes all changes final. But saving those changes is still necessary. (Click on key symbol so it gets red.) | ||
|- | |- | ||
| [ | | [https://download.autodesk.com/global/docs/softimage2013/en_us/sdkguide/index.html?url=si_cmds/Translate.html,topicNumber=si_cmds_Translate_html Translate] <nowiki>[InputObjs], [X], [Y], [Z], [Delta], [RefMode], [Center], [AxesFilter], [Snap], [SnapReference], [SnapFilter], [SplitLocalComponents], [PropTagOnly], [Pivot], [PivotX], [PivotY], [PivotZ], [ConstructionMode], [SlideComponents]</nowiki> | ||
| see link | | see link | ||
|- | |- | ||
| [ | | [https://download.autodesk.com/global/docs/softimage2013/en_us/sdkguide/index.html?url=si_cmds/Rotate.html,topicNumber=si_cmds_Rotate_html Rotate] <nowiki>[InputObjs], [X], [Y], [Z], [Delta], [RefMode], [Center], [AxesFilter], [Reference], [SplitLocalComponents], [PropTagOnly], [Pivot], [PivotX], [PivotY], [PivotZ], [ConstructionMode], [SlideComponents]</nowiki> | ||
| see link | | see link | ||
|} | |} | ||
Line 897: | Line 935: | ||
' '''[8] message box''' | ' '''[8] message box''' | ||
[ | [https://download.autodesk.com/global/docs/softimage2013/en_us/sdkguide/index.html?url=si_om/XSIUIToolkit.MsgBox.html,topicNumber=si_om_XSIUIToolkit_MsgBox_html msgbox] "message", , "title" | ||
Line 936: | Line 974: | ||
' '''[13] reading out environment variables''' | ' '''[13] reading out environment variables''' | ||
' some infos about env vars: [http://softimage.wiki.softimage.com/xsidocs/config_envirovars.htm (1)], [http://softimage.wiki.softimage.com/xsidocs/EnvVars_SettingandUsingEnvironmentVariables.htm (2)], [http://softimage.wiki.softimage.com/xsidocs/EnvVars_EnvironmentVariableReference.htm (3)] | ' some infos about env vars: [http://web.archive.org/web/20170309190841/http://softimage.wiki.softimage.com/xsidocs/config_envirovars.htm (1)], [http://web.archive.org/web/20180416194626/http://softimage.wiki.softimage.com/xsidocs/EnvVars_SettingandUsingEnvironmentVariables.htm (2)], [http://web.archive.org/web/20170617095054/http://softimage.wiki.softimage.com/xsidocs/EnvVars_EnvironmentVariableReference.htm (3)] | ||
' those variables are stored inside the setenv.bat, two disadvantages: | ' those variables are stored inside the setenv.bat, two disadvantages: | ||
' adding or editing those vars appears to not work in vbs or I just did it wrong | ' adding or editing those vars appears to not work in vbs or I just did it wrong | ||
' anyway, new vars can only be read out after app restart | ' anyway, new vars can only be read out after app restart | ||
' therefore let's concentrate on reading out existing ones and then how to create our own via txt files (example: | ' therefore let's concentrate on reading out existing ones and then how to create our own via txt files (example: <nowiki>https://dl.dropbox.com/u/139715/OniGalore/ModToolScript/Oni_env_vars.txt Oni_env_vars.txt</nowiki> (dead link)) | ||
' code for reading out: | ' code for reading out: | ||
logmessage XSIUtils.ResolvePath("$SI_HOME/") | logmessage XSIUtils.ResolvePath("$SI_HOME/") | ||
Line 1,229: | Line 1,267: | ||
' alternative to cmd: call onisplit via winmgmts | ' alternative to cmd: call onisplit via winmgmts | ||
' slightly modified code from [ | ' slightly modified code from [https://devblogs.microsoft.com/scripting/how-can-i-start-a-process-and-then-wait-for-the-process-to-end-before-terminating-the-script/ that site] | ||
' ''logmessage "onisplit finished."'' will be executed after the conversion finished, there should be also an delay of 3 seconds to support very slow computers | ' ''logmessage "onisplit finished."'' will be executed after the conversion finished, there should be also an delay of 3 seconds to support very slow computers | ||
' if you are going to use this method consider to extent the code to check if input file and output directory exist | ' if you are going to use this method consider to extent the code to check if input file and output directory exist | ||
Line 1,258: | Line 1,296: | ||
[[Image:XSI_Mod_Tool_PPG.png|thumb]] | |||
' '''[23] building a form (PPG)''' | ' '''[23] building a form (PPG)''' | ||
Line 1,339: | Line 1,375: | ||
[[Image:XSI_Mod_Tool_UserDataBlob.png|thumb]] | |||
' '''[24] UserDataBlob''' | ' '''[24] UserDataBlob''' | ||
Line 1,559: | Line 1,593: | ||
' '''[33] getting bounding box values''' | ' '''[33] getting bounding box values''' | ||
' this could be useful to create a bounding box for [[ | ' this could be useful to create a bounding box for [[XML:OFGA|OFGA files]] | ||
' let's get the bounding box of a simple cylinder | ' let's get the bounding box of a simple cylinder | ||
Line 1,582: | Line 1,616: | ||
' this could be used open an output folder ... | ' this could be used open an output folder ... | ||
strPath = "[http://support.microsoft.com/kb/152457 explorer.exe /e]," & XSIUtils.ResolvePath("$SI_HOME/") | strPath = "[http://web.archive.org/web/20150212074443/http://support.microsoft.com/kb/152457 explorer.exe /e]," & XSIUtils.ResolvePath("$SI_HOME/") | ||
Set objShell = CreateObject("Wscript.Shell") | Set objShell = CreateObject("Wscript.Shell") | ||
objShell.Run strPath | objShell.Run strPath | ||
Line 1,590: | Line 1,624: | ||
[[Image:XSI_Mod_Tool_SelectNeighborObj_obj_5.png|thumb|SelectNeighborObj obj 5]] | |||
| SelectNeighborObj obj 5 | |||
' '''[35] working with hierarchies''' | ' '''[35] working with hierarchies''' | ||
Line 1,701: | Line 1,733: | ||
logmessage XSIUtils.ResolvePath("$XSI_HOME/") & "Application\DSScripts\Model.vbs" | logmessage XSIUtils.ResolvePath("$XSI_HOME/") & "Application\DSScripts\Model.vbs" | ||
' C:\Softimage\Softimage_Mod_Tool_7.5\Application\DSScripts\'''Model.vbs''' | ' C:\Softimage\Softimage_Mod_Tool_7.5\Application\DSScripts\'''Model.vbs''' | ||
A backup of the original file can be found ''' | A backup of the original file can be found here: '''<nowiki>https://dl.dropboxusercontent.com/u/139715/OniGalore/ModToolScript/Model.vbs</nowiki> (dead link)''' | ||
There are two issues that can be fixed by modifying this file. | There are two issues that can be fixed by modifying this file. | ||
Line 1,954: | Line 1,986: | ||
'''tutorials:''' | '''tutorials:''' | ||
* | * https://www.youtube.com/watch?v=ioMQ2rBVO4g | ||
* http://dot3d.blogspot. | * http://dot3d.blogspot.com/2009/10/softimage-ice-tree-building-step-by.html | ||
* [ | * [https://www.si-community.com/community/viewtopic.php?f=41&t=1707 an ICE tutorial thread] | ||
* [ | * [https://download.autodesk.com/global/docs/softimage2013/en_us/userguide/index.html?url=files/ICE_trees_DebuggingICETrees.htm,topicNumber=d30e269791 ICE trees Debugging] | ||
* https://support.solidangle.com/display/SItoAUG/ICE | * <nowiki>https://support.solidangle.com/display/SItoAUG/ICE</nowiki> (dead link) | ||
==Wanted knowledge== | |||
* How to set up particles in Mod Tool? We still need an Oni particle editor! | |||
* How to rig models and then extract the animation data? | |||
* How to make complex new UV maps? | |||
[[Category:Modding tutorials]] | [[Category:Modding tutorials]][[Category:Outdated modding tools]][[Category:Windows-only modding tools]] |
edits