5,389
edits
OBD:Oni2AS: Difference between revisions
m
OK, section editing is officially buggy as hell
No edit summary |
m (OK, section editing is officially buggy as hell) |
||
| (9 intermediate revisions by 2 users not shown) | |||
| Line 5: | Line 5: | ||
*the three "binary data" files '''BANKS.DAT''', '''RB.DAT''' and '''STREAMS.DAT''' | *the three "binary data" files '''BANKS.DAT''', '''RB.DAT''' and '''STREAMS.DAT''' | ||
:"RB" possibly stands for "Rebirth", one of Oni2's working (sub)titles. | :"RB" possibly stands for "Rebirth", one of Oni2's working (sub)titles. | ||
:"DAT" probably does ''not'' stand for "Death and Taxes", another of Oni2's working (sub)titles. ^_^ | |||
==DAT file format (file table)== | ==DAT file format (file table)== | ||
| Line 79: | Line 80: | ||
Some of the files in '''RB.DAT''' are either in plain text or in otherwise widely known formats that can be opened by third-party programs. Here is the list of such commonplace formats used in Oni 2. | Some of the files in '''RB.DAT''' are either in plain text or in otherwise widely known formats that can be opened by third-party programs. Here is the list of such commonplace formats used in Oni 2. | ||
*'''*.txt''' : [[wp:Text_file|Text file]]s. Some in Windows format (CR+LF at EOL), some in Unix format (only LF at EOL) | *'''*.txt''' : [[wp:Text_file|Text file]]s. Some in Windows format (CR+LF at EOL), some in Unix format (only LF at EOL) | ||
*'''*.mb''' : | *'''*.mb''' : Binary file used by Maya 3D program (work-in-progress models of some characters and props) | ||
*'''*.mb.swatches''' : Maya swatches, whatever they are. There are also '''*.mel''' files (plain text) | *'''*.mb.swatches''' : Maya swatches, whatever they are. There are also '''*.mel''' files (plain text) | ||
*'''*.wav''' : [[wp:WAV|WAV]]. | *'''*.wav''' : [[wp:WAV|WAV]]. A common format for the uncompressed storage of sounds (through pulse-code modulation) | ||
*'''*.tga''' : [[wp:Truevision_TGA|Targa]]. | *'''*.tga''' : [[wp:Truevision_TGA|Targa]]. A versatile texture format that supports RLE compression, MIP map storage, indexed as well as RGB color schemes, and transparency (and therefore is widely used in games). | ||
*'''*.xml''' : [[wp:XML|XML]]. | *'''*.xml''' : [[wp:XML|XML]]. | ||
*'''*.cue''' : [[wp:Cue_sheet_(computing)|Cue sheet]]. Occurs only once, as '''rb.cue''' at the root of '''RB.DAT''' | *'''*.cue''' : [[wp:Cue_sheet_(computing)|Cue sheet]]. Occurs only once, as '''rb.cue''' at the root of '''RB.DAT''' | ||
| Line 89: | Line 90: | ||
*'''*.xls''' : Microsoft Excel file | *'''*.xls''' : Microsoft Excel file | ||
*'''*.psd''' : Adobe Photoshop file | *'''*.psd''' : Adobe Photoshop file | ||
*'''*.tif''' : [[wp:TIFF]] image file | *'''*.tif''' : [[wp:TIFF|TIFF]] image file | ||
*'''*.lnk''' : Microsoft shortcut | *'''*.lnk''' : Microsoft shortcut | ||
| Line 191: | Line 192: | ||
'''"attr" and "geom" -''' only occur as '''Entity/proxy/exportTMP/exportTmp/set_temp1.attr''' and '''Entity/proxy/exportTMP/exportTmp/static.geom''' | '''"attr" and "geom" -''' only occur as '''Entity/proxy/exportTMP/exportTmp/set_temp1.attr''' and '''Entity/proxy/exportTMP/exportTmp/static.geom''' | ||
... | Some plain-text files do not have an "extension". Usually those are either empty files, or dummy files of an identifiable type. Examples are '''tim_atk_FCH1_rht_pch_uprcutreadme''' (a plain-text "readme" file), '''trashpath''' and '''guardpos''' (unused stubs of '''.oni'''-like scripts), '''ack''' (some kind of skeleton data for Konoko) and '''pants''' | ||
==STM file format (sound stream)== | ==STM file format (sound stream)== | ||
There are some regular WAV files in '''Audio/banks/wav/ ''' [and some audio streams encoded in the ''*.bd''' files, not yet reverse engineered at the time of writing [[User:Geyser|geyser]] ([[User talk:Geyser|talk]]) 01:40, 6 February 2018 (CET) ], but there is also a WAV-like format called STM (unrelated to the MIDI-like STM file mentioned on Wikipedia). | There are some regular WAV files in '''Audio/banks/wav/ ''' [and some audio streams encoded in the ''*.bd''' files, not yet reverse engineered at the time of writing [[User:Geyser|geyser]] ([[User talk:Geyser|talk]]) 01:40, 6 February 2018 (CET) ], but there is also a WAV-like format called STM (unrelated to the MIDI-like STM file mentioned on Wikipedia). | ||
... | To be documented later. The WAV files obtained after conversion can be found [http://geyser.oni2.net/STM2WAV.ZIP HERE] | ||
==TEX file format (texture)== | ==TEX file format (texture)== | ||
A texture format similar to Oni's [[TXMP]]. | A texture format similar to Oni's [[TXMP]]. | ||
... | To be documented later. The TGA images obtained after conversion can be found [http://geyser.oni2.net/TEX2TGA.ZIP HERE] | ||
Some of the textures are temporary or alternative copies, and so their filenames don't end in '''.tex''' but '''.tex.old''' or '''.tex.highRes''' | |||
==MOD file format (plain text)== | ==MOD file format (plain text)== | ||
| Line 212: | Line 215: | ||
... | ... | ||
==SNE file format (binary)== | |||
... | |||
==HD and BD file format (binary)== | |||
... | |||
==ANIM file format== | ==ANIM file format== | ||
All of the '''.anim''' files in Oni2 are uncompressed, and store translation, rotation and scaling values as regular IEEE floats. The meaning of each float (whether it is a translation, a rotation or a scaling, what its axis is, and which bone it corresponds to) is described in the '''.skel''' file (skeleton) of the mesh: the transforms are parsed in the same order as they appear in the '''.skel''' file. The link between the skeleton and the animation is established at the level of the "entity", and is not detailed here. | |||
For rotations, most commonly the full triplet of Euler angles is stored, and for translations the full position vector. For a few UI elements the pose is limited to a rotation around 1 axis (indicated in the '''.skel''' file), and therefore a single float is enough to describe the pose. Sometimes a rotation axis is present in the '''.skel''' but locked at a fixed value - in that case the keyable values are reduced to the remaining rotation axes. Scaling triplets are present, e.g., for the "Buco" robots. | |||
There is no time compression. The complete pose (i.e., all the keyable translations/rotations/scalings listed in the '''.skel''') is stored for each consecutive frame in the animation (i.e., if the transformation for a bone does not change at all for a certain time range, or during the whole animation, it is stored for each frame anyway). The frame rate is 30 fps. | |||
Apart from the floats (translations and rotations for each pose/frame), each '''.anim''' file has a header, which announces, among other things, the number of transforms per frame and the number of frames. The header can be of the following three types: | |||
{{table}} | |||
{{OBDth}} | |||
{{OBDtr| 0x00 | 4CC | FF0000 | 41 4E 49 31 | "ANI1" | animation type "ANI1" (example file: kno_atk_comb_bak_bakkckCH.anim) }} | |||
{{OBDtr| 0x04 | bitset | FFFF00 | 00 00 00 80 | 0, 0, 0, 128 | flags; the following bits occur in the original files (values in hex): | |||
:0x'''01''' 00 00 00 - unknown | |||
:0x00 00 00 '''80''' - has detailed (per-frame) root motion data | |||
}} | |||
{{OBDtr| 0x08 | int32 | 00FF00 | 21 00 00 00 | 33 | number of frames }} | |||
{{OBDtr| 0x0C | int32 | 00FFFF | 78 00 00 00 | 120 | number of transforms per frame (must be consistent with the number of keyable values in the .skel file). In this example the skeleton is kno.skel, which has 39 bones; all bones have an XYZ rotation triplet (Euler angles), and the root bone also has an XYZ translation triplet; hence there will be 120 values in total (plus the detailed root motion). | |||
}} | |||
{{OBDtr| 0x10 | float | 00FF00 | BD 97 4D BD | -0.0502 | total root motion along X (matches the cumulated X values of the detailed root motion track, if any) }} | |||
{{OBDtr| 0x14 | float | 00FF00 | 00 00 00 00 | 0.0 | total root motion along Y (matches the cumulated Y values of the detailed root motion track, if any) }} | |||
{{OBDtr| 0x18 | float | 00FF00 | 63 A7 03 BF | -0.514 | total root motion along Z (matches the cumulated Z values of the detailed root motion track, if any) }} | |||
|} | |||
---- | |||
{{table}} | |||
{{OBDth}} | |||
{{OBDtr| 0x00 | 4CC | FF0000 | 61 6E 69 00 | "ani"+null | animation type "ani" (example file: kno_atk_BLH1_lft_punch.anim) }} | |||
{{OBDtr| 0x04 | bitset | FFFF00 | 01 00 00 00 | 1, 0, 0, 0 | flag(s); the following bits occur in the original files (values in hex): | |||
:0x'''01''' 00 00 00 - unknown | |||
}} | |||
{{OBDtr| 0x08 | int32 | 00FF00 | 51 00 00 00 | 81 | number of frames }} | |||
{{OBDtr| 0x0C | int32 | 00FFFF | A2 00 00 00 | 162 | number of transforms per frame (must be consistent with the number of keyable values in the .skel file). In this example the skeleton is the (missing) xkno.skel, which has 53 bones; all bones have an XYZ rotation triplet (Euler angles), and the root bone also has an XYZ translation triplet; hence there will be 162 values in total. | |||
}} | |||
{{OBDtr| 0x10 | float | 00FF00 | 7D 18 7D BD | -0.0618 | total root motion along X (matches the keyed motion of the root bone) }} | |||
{{OBDtr| 0x14 | float | 00FF00 | 00 00 00 00 | 0.0 | total root motion along Y (matches the keyed motion of the root bone) }} | |||
{{OBDtr| 0x18 | float | 00FF00 | 00 00 00 00 | 0.0 | total root motion along Z (matches the keyed motion of the root bone) }} | |||
{{OBDtr| 0x1C | byte | 00FF00 | 01 | 1 | flag(s); the following bits occur in the original files (values in hex): | |||
:0x'''01''' 00 00 00 - unknown | |||
}} | |||
|} | |||
---- | |||
{{table}} | |||
{{OBDth}} | |||
{{OBDtr| 0x00 | 4CC | FF0000 | 00 00 00 00 | null chars | "short" animation type (example file: kno_BR2H1_HighPunchBackRight.anim) }} | |||
{{OBDtr| 0x04 | int32 | 00FF00 | 51 00 00 00 | 81 | number of frames }} | |||
{{OBDtr| 0x08 | int32 | 00FFFF | A2 00 00 00 | 162 | number of transforms per frame (must be consistent with the number of keyable values in the .skel file). In this example the skeleton is the (missing) xkno.skel, which has 53 bones; all bones have an XYZ rotation triplet (Euler angles), and the root bone also has an XYZ translation triplet; hence there will be 162 values in total. | |||
}} | |||
{{OBDtr| 0x0C | float | 00FF00 | AA 9D 00 3E | 0.126 | unknown }} | |||
{{OBDtr| 0x10 | byte | FFFF00 | 01 | 1 | flag(s); the following bits occur in the original files (values in hex): | |||
:0x'''01''' 00 00 00 - unknown | |||
}} | |||
|} | |||
Immediately after the header begin the keyed values (floats), grouped by frame: first all the keyed values for frame 0, then for frame 1, etc. | |||
For each frame, the keyed values correspond to the ones listed in the '''.skel''' and occur in the same order. The typical order is: | |||
:X translation of "root"; Y translation of "root"; Z translation of "root" | |||
:X rotation of "root"; Y rotation of "root"; Z rotation of "root" | |||
:X rotation of 1st child of "root", typically "spine_01"; Y rotation of "spine_01"; Z rotation of "spine_01" | |||
::... XYZ rotation for all the children of "spine_01", in hierarchical order (same as in the '''.skel''') | |||
:X rotation of 2nd child of "root", typically "pelvis"; Y rotation of "pelvis"; Z rotation of "pelvis" | |||
::... XYZ rotation for all the children of "pelvis", in hierarchical order (same as in the '''.skel''') | |||
:Detailed XYZ root motion (if any; can only occur in ANI1 type animation). Stored as single-frame increments. | |||
Rotations are stored as XZY Euler angles (first rotation is around bone's Y, then around the new Z, and finally around the latest X). Angle values are in radians. | |||
[[Category:Modding information]] | |||
[[Category:Modding information]] | [[Category:Modding information]] | ||