OniGalore

OBD:CRSA: Difference between revisions

OBD Discussion

OBD:CRSA (view source)

Revision as of 03:36, 12 May 2025

5,074 bytes removed ,  12 May
m
...
mNo edit summary
m (...)
 
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{OBD_File_Header|type=CRSA|prev=CONS|next=DOOR|name=Corpse Array|family=Level|extra=[http://www6.fh-eberswalde.de/user/dkriesch/onistuff/oni_crsa.htm Overview @ Oni Stuff]}}
{{OBD_File_Header | type=CRSA | prev=CONS | next=DOOR | name=Corpse Array | family=Level | align=center | onistuff=crsa}}




'''[[OBD_Talk:CRSA|ssg's version is here]]'''
The first image shows the header and the beginning of the first element. The second image the end of it.




==CRSA - Corpse Array==
[[image:crsa_a.gif]]
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.
[[image:crsa_m.gif]]
===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?
{{Table}}
*A space for notes (160 bytes) : often the name of the file the corpse was taken from when packing the array.
{{OBDth}}
*A link to the [[OBD:ONCC|ONCC]] (model that should be used for the corpse) : that's 4 bytes as usual.
{{OBDtr| 0x000 | res_id  |FF0000| 01 35 02 00 | 565        | 00565-.CRSA }}
*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.
{{OBDtr| 0x004 | lev_id  |FFFF00| 01 00 00 06 | 3          | level 3 }}
*Finally, an axis-aligned bounding box (2*3*4 = 24 bytes)
{{OBDtr| 0x008 | char[12] |00FF00| AD DE      | dead      | padding }}
The total size of a corpse is thus 1100 bytes.
{{OBDtr| 0x014 | uint32    |00FFFF| 11 00 00 00 | 17        | number of "fixed" corpses }}
 
{{OBDtr| 0x018 | uint32    |FF00FF| 11 00 00 00 | 17        | number of "used" corpses }}
;What's in a bone?:The absolute orientation is defined in a "heavy" way ''via'' an orthonormal trihedron :
{{OBDtr| 0x01C | uint32    |FF8000| 14 00 00 00 | 20        | array capacity; always the same in original Oni }}
:three 3D vectors '''x''', '''y''' and '''z''', each of length 1, at right angles with each other, and ordered "directly"
{{OBDtrBK}}
:(like Oni's world axes : if '''x''' points left and '''y''' points up then '''z''' points to ''front'', not back).
{{OBDtr2|0x000 | char[32]|FFC8C8| _lvl_3_Intro_TCL_A_corpse.dat| ignored; the name of the source file }}
: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).
{{OBDtr|0x020 | uint[32] |FFC8C8|  |  | node list; runtime only }}
:The absolute position '''R''' of a bone (of its parent node, actually) is stored as 3 floats right after the orientation trihedron.
{{OBDtr| 0x0A0 | link    |FFFFC8| 01 36 02 00 | 566        | link to 00566-TCTF_lite_1.[[OBD:ONCC|ONCC]] }}
:That's another 12 bytes, so 48 bytes in total.
|- ALIGN=CENTER VALIGN=TOP
Reminder : the 2nd coordinate of '''R''' aka ''y'' is the height; same for '''x''', '''y''' and '''z'''.
|0x0A4||matrix||
 
{|border=1 cellspacing=0 style="white-space:nowrap"
;Example:first corpse of '''00565-.CRSA''' in '''level3_Final.dat'''.
|-BGCOLOR="#C8FFC8"
:Offsets are measured from the start of the corpse chunk : add 0x20 for the offset from the start of file.
|C1 74 66 3F||00 78 3E 3D||45 AB DD 3E
{|border=1 cellspacing=0 style="white-space:nowrap;background:#ffeedd" width=100%
|-BGCOLOR="#C8FFC8"
|+Notes and ONCC link
|A6 8B 7D 3D||19 73 7F BF||EE 67 B0 BC
|-style="background:#ffddbb"
|-BGCOLOR="#C8FFC8"
!Offset
|03 AE DC 3E||82 2C 3D 3D||8D B2 66 BF
!Raw hex
|-BGCOLOR="#C8FFC8"
!Value
|C5 FA E7 41||2E 2B CB C1||58 B4 45 C1
!Meaning
|}
|-align=center
|
|0x00
{|border=1 cellspacing=0 style="white-space:nowrap"
|colspan=2 BGCOLOR="#FFC8C8"|_lvl_3_Intro_TCL_A_corpse.dat
|0.900219||0.046501||0.432947
|align=left|probably the name of the source file
|-
|-align=center
|0.061901||-0.997850||0.021534
|0xA0
|-
| BGCOLOR="#FFFFC8"|01 36 02 00
|0.431015||0.0461850||-0.901162
|566
|-
|align=left|Link to 00566-TCTF_lite_1.[[OBD:ONCC|ONCC]]
|28.997446||-25.396084||-12.356529
|}
|ALIGN=LEFT|transform matrix for the pelvis (in world space)
{{OBDtrBK|0xD4-0x434 : transform matrices for the other 18 bones}}
|- ALIGN=CENTER VALIGN=TOP
|0x434||AABB||
{|border=1 cellspacing=0 style="white-space:nowrap"
|-BGCOLOR="#C8FFFF"
|D4 22 8C 41||95 50 E9 C1||BC 31 9C C1
|-BGCOLOR="#C8FFFF"
|75 E6 14 42||2E 20 B1 C1||07 B1 D3 C0
|}
|}
 
|
 
{|border=1 cellspacing=0 style="white-space:nowrap"
{|border=1 cellspacing=0 style="white-space:nowrap;background:#ffeedd" width=100% BGCOLOR="#FFDDBB"
|17.517006||-29.164347||-19.524284
|+Bone orientation and position
|-
|-style="background:#ffddbb"
|37.225056||-22.140713||-6.615360
!Offset
!Bone
!Raw hex
!Value/Meaning
|-align=center
|0xA4<br>0xB0<br>0xBC<br>0xC8
|Pelvis
|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
|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)
|-align=center
|0xD4<br>0xE0<br>0xEC<br>0xF8
|Lt Thigh
|BGCOLOR="#C8FFFF" |...
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x104<br>0x110<br>0x11C<br>0x128
|Lt Calf
|BGCOLOR="#FFC8FF" |...
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x134<br>0x140<br>0x14C<br>0x158
|Lt Foot
|BGCOLOR="#FFC800" |...
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x164<br>0x170<br>0x17C<br>0x188
|Rt Thigh
| BGCOLOR="#C800C8" |...
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x194<br>0x1A0<br>0x1AC<br>0x1B8
|Rt Calf
| BGCOLOR="#C87C64"|...
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x1C4<br>0x1D0<br>0x1DC<br>0x1E8
|Rt Foot
| BGCOLOR="#B0C3D4" |...
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x1F4<br>0x200<br>0x20C<br>0x218
|Mid
| BGCOLOR="#E7CEA5" |...
|align=left|'''x''' = (, , )<br>'''y''' =  (, , )<br>'''z''' = (, , )<br>'''R''' = (, , )
|-align=center
|0x224<br>0x230<br>0x23C<br>0x248
|Chest
| BGCOLOR="#FFDDDD"|...
|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''' = (, , )
|}
|}
 
|ALIGN=LEFT|bounding box for the whole corpse
 
{|border=1 cellspacing=0 style="white-space:nowrap;background:#ffeedd" width=100%
|+Axis-aligned bounding box
|-style="background:#ffddbb"
!Offset
!Raw hex
!Value
!Meaning
|-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
|}
|}
;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]]


----
;What's in a bone?
 
:The transformation matrix (3D rotation/scale/shear/mirror and translation)
==Screenshot==
::can be seen as four 3D vectors '''X''', '''Y''', '''Z''', and '''R''' in world space.
The example is the same as above : '''00565-.CRSA''' in '''level3_Final.dat'''
:If a bone mesh has a vertex at (x, y, z) in its native coordinates,
::then the actual position of that vertex in the level will be '''R''' + x '''X''' + y '''Y''' + z '''Z'''
:That's the transformation defined by the 3x4 transform matrix.
Reminder : the 2nd coordinate of '''X''', '''Y''', '''Z''', and '''R''' is the height.


The first corpse chunk has been outlined in black.
;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.


http://www6.fh-eberswalde.de/user/dkriesch/onistuff/images/crsa_a.gif


{{OBD_File_Footer | type=CRSA | prev=CONS | next=DOOR | name=Corpse Array | family=Level}}


----
{{OBD}}
----
{{OBD_File_Footer|type=CRSA|prev=CONS|next=DOOR|name=Corpse Array}}
Mai X
281

edits

Retrieved from "https://wiki.oni2.net/Special:MobileDiff/1717...45143"