OniGalore

OBD:CRSA: Difference between revisions

OBD Discussion

OBD:CRSA (view source)

Revision as of 19:49, 23 May 2013

4,831 bytes removed ,  23 May 2013
m
I'm only guessing, but...
m (I'm only guessing, but...)
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
'''[[OBD_Talk:CRSA|ssg's version is here]]'''
{{OBD_File_Header | type=CRSA | prev=CONS | next=DOOR | name=Corpse Array | family=Level | align=center | onistuff=crsa}}
==CRSA - Corpse Array==
Related :
[[OBD:File types|File types]]
[[OBD:File types/Level|Level files]]
[[OBD:Oni Binary Data|Oni Binary Data]]


A '''CRSA''' file consists of
*a 32-byte header that specifies the size ''S'' and the capacity ''C'' of the corpse array
*''S'' corpse chunks with actual corpse data (1100 bytes each)
*(''C'' - ''S'') unused corpse chunks integrally set to 0 (1100 bytes each)
The capacity ''C'' is always 20. The size of a chunk is not specified in the header : it's fixed by the "universal" bone count in Oni (19 bones).
*the resulting file is completed to a 32-byte multiple with the 0xADDE blank filler


Since the capacity of the array is always the same (20 corpses), CRSA files are all the same size (0x5620 bytes) : actual arrays take up 0x5610 bytes, and the last 16 bytes are filled with the blank filler 0xADDE.
The first image shows the header and the beginning of the first element. The second image the end of it.
===Header===
;What's in the header?
*File ID and level ID as usual : 4 bytes each
*A blank field filled with 0xADDE (dead) : 12 bytes
*Array size (number of corpses) duplicated : 2*4 bytes
*Array capacity (maximum number of corpses, always 20) : another 4 bytes
The total size of a header is thus 0x20 = 32 bytes.
;Example:'''00565-.CRSA''' in '''level3_Final.dat'''
{|border=1 cellspacing=0 style="white-space:nowrap;background:#ffeedd" width=100%
|+Header of the Corpse Array file
|-style="background:#ffddbb"
!Offset
!Raw hex/string
!Value
!Meaning
|-align=center
|0x00
| BGCOLOR="#FF0000"|01 35 02 00
|565
|align=left|File ID for 00565-.CRSA
|-align=center
|0x04
| BGCOLOR="#FFFF00" |01 00 00 06
|3
|align=left|Level ID
|-align=center
|0x08<br>0x0C<br>0x010
| BGCOLOR="#00FF00" |AD DE AD DE<br>AD DE AD DE<br>AD DE AD DE
|DEAD
|align=left|blank filler
|-align=center
|0x14
| BGCOLOR="#00FFFF" |11 00 00 00
|17
|align=left|17 corpses (array size)
|-align=center
|0x18
| BGCOLOR="#FF00FF" |11 00 00 00
|17
|align=left|17 corpses (array size again)
|-align=center
|0x1C
| BGCOLOR="#FF8000" |14 00 00 00
|20
|align=left|Room for 20 corpses (array capacity)
|}


===Corpses===
They make up the actual array. They follow the header directly


;What's in a corpse?
[[image:crsa_a.gif]]
*A space for notes (160 bytes) : often the name of the file the corpse was taken from when packing the array.
*A link to the [[OBD:ONCC|ONCC]] (model that should be used for the corpse) : that's 4 bytes as usual.
*Then, 19 bones, each of them defined by absolute orientation and position (unlike in a [[OBD:TRAM/raw0x34|TRAM]], where orientations are relative)<br>Every bone is (3*3 + 3)*4 = 48 bytes, so that's 19*48 = 912 bytes.
*Finally, an axis-aligned bounding box (2*3*4 = 24 bytes)
The total size of a corpse is thus 1100 bytes.


;What's in a bone?:The absolute orientation is defined in a "heavy" way ''via'' an orthonormal trihedron :
:three 3D vectors '''x''', '''y''' and '''z''', each of length 1, at right angles with each other, and ordered "directly"
:(like Oni's world axes : if '''x''' points left and '''y''' points up then '''z''' points to ''front'', not back).
:Each one of those vectors is stored as 3 floats (3*4 bytes), first '''x''', then '''y''', then '''z''' (so 3*3*4 = 36 bytes in total).
:The absolute position '''R''' of a bone (of its parent node, actually) is stored as 3 floats right after the orientation trihedron.
:That's another 12 bytes, so 48 bytes in total.
Reminder : the 2nd coordinate of '''R''' aka ''y'' is the height; same for '''x''', '''y''' and '''z'''.


;Example:first corpse of '''00565-.CRSA''' in '''level3_Final.dat'''.
[[image:crsa_m.gif]]
:Offsets are measured from the start of the corpse chunk : add 0x20 for the offset from the start of file.
{|border=1 cellspacing=0 style="white-space:nowrap;background:#ffeedd" width=100%
|+Notes and ONCC link
|-style="background:#ffddbb"
!Offset
!Raw hex
!Value
!Meaning
|-align=center
|0x00
|colspan=2 BGCOLOR="#FFC8C8"|_lvl_3_Intro_TCL_A_corpse.dat
|align=left|probably the name of the source file
|-align=center
|0xA0
| BGCOLOR="#FFFFC8"|01 36 02 00
|566
|align=left|Link to 00566-TCTF_lite_1.[[OBD:ONCC|ONCC]]
|}




{|border=1 cellspacing=0 style="white-space:nowrap;background:#ffeedd" width=100% BGCOLOR="#FFDDBB"
{{Table}}
|+Bone orientation and position
{{OBDth}}
|-style="background:#ffddbb"
{{OBDtr| 0x000 | res_id  |FF0000| 01 35 02 00 | 565        | 00565-.CRSA }}
!Offset
{{OBDtr| 0x004 | lev_id  |FFFF00| 01 00 00 06 | 3          | level 3 }}
!Bone
{{OBDtr| 0x008 | char[12] |00FF00| AD DE      | dead      | unused }}
!Raw hex
{{OBDtr| 0x014 | int32    |00FFFF| 11 00 00 00 | 17        | number of "fixed" corpses }}
!Value/Meaning
{{OBDtr| 0x018 | int32    |FF00FF| 11 00 00 00 | 17        | number of "used" corpses }}
|-align=center
{{OBDtr| 0x01C | int32    |FF8000| 14 00 00 00 | 20        | array capacity; always the same in original Oni }}
|0xA4<br>0xB0<br>0xBC<br>0xC8
{{OBDtrBK}}
|Pelvis
{{OBDtr2|0x000 | char[32]|FFC8C8| _lvl_3_Intro_TCL_A_corpse.dat| ignored; the name of the source file }}
|BGCOLOR="#C8FFC8"|C1 74 66 3F 00 78 3E 3D 45 AB DD 3E<br>A6 8B 7D 3D 19 73 7F BF EE 67 B0 BC<br>03 AE DC 3E 82 2C 3D 3D 8D B2 66 BF<br>C5 FA E7 41 2E 2B CB C1 58 B4 45 C1
{{OBDtr|0x020 | int[32] |FFC8C8|  |   | runtime only }}
|align=left|'''x''' = (0.900219, 0.046501, 0.432947)<br>'''y''' =  (0.061901, -0.997850, -0.021534)<br>'''z''' = (0.431015, 0.0461850, -0.901162)<br>'''R''' = (28.997446, -25.396084, -12.356529)
{{OBDtr| 0x0A0 | link    |FFFFC8| 01 36 02 00 | 566        | link to 00566-TCTF_lite_1.[[OBD:ONCC|ONCC]] }}
|-align=center
|- ALIGN=CENTER VALIGN=TOP
|0xD4<br>0xE0<br>0xEC<br>0xF8
|0x0A4||matrix||
|Lt Thigh
{|border=1 cellspacing=0 style="white-space:nowrap"
|BGCOLOR="#C8FFFF" |...
|-BGCOLOR="#C8FFC8"
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|C1 74 66 3F||00 78 3E 3D||45 AB DD 3E
|-align=center
|-BGCOLOR="#C8FFC8"
|0x104<br>0x110<br>0x11C<br>0x128
|A6 8B 7D 3D||19 73 7F BF||EE 67 B0 BC
|Lt Calf
|-BGCOLOR="#C8FFC8"
|BGCOLOR="#FFC8FF" |...
|03 AE DC 3E||82 2C 3D 3D||8D B2 66 BF
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-BGCOLOR="#C8FFC8"
|-align=center
|C5 FA E7 41||2E 2B CB C1||58 B4 45 C1
|0x134<br>0x140<br>0x14C<br>0x158
|}
|Lt Foot
|
|BGCOLOR="#FFC800" |...
{|border=1 cellspacing=0 style="white-space:nowrap"
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|0.900219||0.046501||0.432947
|-align=center
|-
|0x164<br>0x170<br>0x17C<br>0x188
|0.061901||-0.997850||0.021534
|Rt Thigh
|-
| BGCOLOR="#C800C8" |...
|0.431015||0.0461850||-0.901162
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-
|-align=center
|28.997446||-25.396084||-12.356529
|0x194<br>0x1A0<br>0x1AC<br>0x1B8
|}
|Rt Calf
|ALIGN=LEFT|transform matrix for the pelvis (in world space)
| BGCOLOR="#C87C64"|...
{{OBDtrBK|0xD4-0x434 : transform matrices for the other 18 bones}}
|align=left|'''x''' = (, , )<br>'''y''' = (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|- ALIGN=CENTER VALIGN=TOP
|-align=center
|0x434||AABB||
|0x1C4<br>0x1D0<br>0x1DC<br>0x1E8
{|border=1 cellspacing=0 style="white-space:nowrap"
|Rt Foot
|-BGCOLOR="#C8FFFF"
| BGCOLOR="#B0C3D4" |...
|D4 22 8C 41||95 50 E9 C1||BC 31 9C C1
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-BGCOLOR="#C8FFFF"
|-align=center
|75 E6 14 42||2E 20 B1 C1||07 B1 D3 C0
|0x1F4<br>0x200<br>0x20C<br>0x218
|}
|Mid
|
| BGCOLOR="#E7CEA5" |...
{|border=1 cellspacing=0 style="white-space:nowrap"
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|17.517006||-29.164347||-19.524284
|-align=center
|-
|0x224<br>0x230<br>0x23C<br>0x248
|37.225056||-22.140713||-6.615360
|Chest
|}
| BGCOLOR="#FFDDDD"|...
|ALIGN=LEFT|bounding box for the whole corpse
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x254<br>0x260<br>0x26C<br>0x278
|Neck
| BGCOLOR="#64AAAA" |...
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x284<br>0x290<br>0x29C<br>0x2A8
|Head
| BGCOLOR="#EBEBEB" |...
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x2B4<br>0x2C0<br>0x2CC<br>0x2D8
|Lt Shoulder
| BGCOLOR="#8C8CCC" |...
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x2E4<br>0x2F0<br>0x2FC<br>0x308
|Lt Arm
| BGCOLOR="#FF00C8"|...
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x314<br>0x320<br>0x32C<br>0x338
|Lt Wrist
| BGCOLOR="#F0F096"|...
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x344<br>0x350<br>0x35C<br>0x368
|Lt Fist
| BGCOLOR="#00C864"|...
|align=left|'''x''' = (, , )<br>'''y''' = (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x374<br>0x380<br>0x38C<br>0x398
|Rt Shoulder
| BGCOLOR="#00C8FF"|...
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x3A4<br>0x3B0<br>0x3BC<br>0x3C8
|Rt Arm
| BGCOLOR="#C80040"|...
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x3D4<br>0x3E0<br>0x3EC<br>0x3F8
|Rt Wrist
| BGCOLOR="#FFCD96"|...
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x404<br>0x410<br>0x41C<br>0x428
|Rt Fist
| BGCOLOR="#C8C864"|...
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|}
|}
;Array capacity
:The array capacity is larger than the number of "fixed"/"used" corpses to allow the engine to store new corpses at runtime. "Fixed" means that those corpses are never overwritten/deleted at runtime, all new corpses are stored after the "fixed" ones. This means that "fixed" <= "used" <= "capacity".


;Bones
:Here is one of the few places where the bone count 19 is apparently hardcoded.
:I.e., custom characters with weird bone counts won't work. See, e.g., [[OBD:TRIA#Bones|TRIA]]


{|border=1 cellspacing=0 style="white-space:nowrap;background:#ffeedd" width=100%
;What's in a bone?
|+Axis-aligned bounding box
:The transformation matrix (3D rotation/scale/shear/mirror and translation)
|-style="background:#ffddbb"
::can be seen as four 3D vectors '''X''', '''Y''', '''Z''', and '''R''' in world space.
!Offset
:If a bone mesh has a vertex at (x, y, z) in its native coordinates,
!Raw hex
::then the actual position of that vertex in the level will be '''R''' + x '''X''' + y '''Y''' + z '''Z'''
!Value
:That's the transformation defined by the 3x4 transform matrix.
!Meaning
Reminder : the 2nd coordinate of '''X''', '''Y''', '''Z''', and '''R''' is the height.
|-align=center
|0x434
| BGCOLOR="#0096C8" |D4 22 8C 41 95 50 E9 C1 BC 31 9C C1
|(17.517006, -29.164347, -19.524284)
|"minimal" corner of the AABB
|-align=center
|0x440
| BGCOLOR="#0096C8"|75 E6 14 42 2E 20 B1 C1 07 B1 D3 C0
|(37.225056, -22.140713, -6.615360)
|"maximal" corner of the AABB
|}
 


----
;Authoring
:The script command [[make_corpse]](filename) creates a separate corpse file in the Oni folder. The pose of this corpse is taken from the player character (the [[Dev Mode]] shortcut Ctrl+F7, "Play dead", would have come in handy here). The format is roughly as above. The contents of the files thus created can then be inserted as elements in a level's CRSA.


==Screenshot==
The example is the same as above : '''00565-.CRSA''' in '''level3_Final.dat'''


The first corpse chunk has been outlined in black.
{{OBD_File_Footer | type=CRSA | prev=CONS | next=DOOR | name=Corpse Array | family=Level}}


http://www6.fh-eberswalde.de/user/dkriesch/onistuff/images/crsa_a.gif
{{OBD}}
Retrieved from "https://wiki.oni2.net/Special:MobileDiff/1707...22589"