OniSplit: Difference between revisions

revising section titles and adding note about extracting whole char. models
(Update Onisplit version)
(revising section titles and adding note about extracting whole char. models)
Line 1: Line 1:
'''OniSplit''', written by Neo, is an integral part of the [[Anniversary Edition]] and an essential modding tool on its own. It does the work of splitting and recombining Oni's data files.  But it also does much more such as extracting and creating [[TXMP]] files and [[M3GM]] files.
'''OniSplit''', written by Neo, is an integral part of the [[Anniversary Edition]] and an essential modding tool on its own. It does the work of splitting and recombining Oni's data files.  But it also does much more such as extracting and creating [[TXMP]] files and [[M3GM]] files.


===Export/Import for [[TXMP]] files===
===Export/Import textures===
To extract all the TXMP files:
To extract all the [[TXMP]] files:
   onisplit -extract:png destination_directory_for_image_files level0_Final.dat
   onisplit -extract:png destination_directory_for_image_files level0_Final.dat
TGA and DDS are also supported using -extract:tga and -extract:dds.
TGA and DDS are also supported using -extract:tga and -extract:dds.
Line 25: Line 25:
For TXMP files that contain envmaps:
For TXMP files that contain envmaps:
   onisplit -create:txmp dest_dir -format:bgra4444 -genmipmaps -envmap:envmapname imagefile.tga
   onisplit -create:txmp dest_dir -format:bgra4444 -genmipmaps -envmap:envmapname imagefile.tga
The envmap name can have the TXMP prefix but it is not required, it is added automatically if missing.
The envmap name can have the TXMP prefix but it is added automatically if missing.


===Export/Import for Wavefront OBJ files===
===Export/Import 3D models===
Named [[M3GM]]s and unnamed M3GM belonging to [[ONWC]] files can be exported to obj file format:
[[M3GM]]s, [[ONWC]]s and, most notably, [[ONCC]]s can all be exported (in OBJ file format):
   onisplit -extract:obj dest_dir M3GMnotfound.oni
   onisplit -extract:obj dest_dir M3GMnotfound.oni
   onisplit -extract:obj dest_dir ONWCw1_tap.oni
   onisplit -extract:obj dest_dir ONWCw1_tap.oni
  onisplit -extract:obj dest_dir ONCCbarabus.oni
Or for a total export:
Or for a total export:
   onisplit -extract:obj dest_dir level0_Final.dat
   onisplit -extract:obj dest_dir level0_Final.dat
Line 40: Line 41:
Note that in both -envmap and -tex cases a .oni file is not created for the specified texture. The .oni file for that texture must be create separately.
Note that in both -envmap and -tex cases a .oni file is not created for the specified texture. The .oni file for that texture must be create separately.


===OniSplit Commands===
===OniSplit commands===
A list of commands can be found be entering OniSplit -help
A list of commands can be found be entering OniSplit -help


Line 71: Line 72:




===Download Links===
===Download links===
* [http://edt.oni2.net/OS/OniSplit_v0.8.18.zip Latest version of OniSplit v0.8.18 ]<br>
* [http://edt.oni2.net/OS/OniSplit_v0.8.18.zip Latest version of OniSplit v0.8.18 ]<br>
* [http://edt.oni2.net/OS/OniSplit_v0.8.18_Full.zip OniSplit v0.8.18 Full (includes source code)]
* [http://edt.oni2.net/OS/OniSplit_v0.8.18_Full.zip OniSplit v0.8.18 Full (includes source code)]