OBD:OBAN: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
m (changed family) |
||
| (9 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
{{OBD_File_Header | type=OBAN | prev=Mtrl | next=OBDC | name=Object Animation | family= | {{OBD_File_Header | type=OBAN | prev=Mtrl | next=OBDC | name=Object Animation | family=General | desc='''OBAN'''s are arrays for storing keyframes in an object or camera animation, as well as basic info like whether the animation loops, and how it does so. | align=center}} | ||
[[ | [[Image:oban_a.gif]] | ||
| Line 14: | Line 14: | ||
:0x'''02''' 00 00 00 - loop animation back to back | :0x'''02''' 00 00 00 - loop animation back to back | ||
:0x'''04''' 00 00 00 - select start frame randomly | :0x'''04''' 00 00 00 - select start frame randomly | ||
:0x'''10''' 00 00 00 - | :0x'''08''' 00 00 00 - autostart animation (after an animated object is created) | ||
:0x'''10''' 00 00 00 - local animation; this animation does not contain world positioning information, the object position is determined by the origin matrix in [[OBOA]]; local animations also use a Z-up coordinate system | |||
}} | }} | ||
|- ALIGN=CENTER VALIGN=TOP | |- ALIGN=CENTER VALIGN=TOP | ||
| Line 62: | Line 63: | ||
|} | |} | ||
| ALIGN=LEFT | fixed transform matrix | | ALIGN=LEFT | fixed transform matrix | ||
{{OBDtr|0x78|int16|B0C3D4|50 00|80 | fubared animation frame length; does not work}} | {{OBDtr|0x78|int16|B0C3D4|50 00|80 | fubared animation frame length (in 1/60 seconds); does not work}} | ||
{{OBDtr|0x7A|int16|E7CEA5|F5 01|501 | animation length in frames}} | {{OBDtr|0x7A|int16|E7CEA5|F5 01|501 | animation length in frames}} | ||
{{OBDtr|0x7C|int16|FFDDDD|00 00|0 | stop frame for the first "half" of the animation; used by door animations to distinguish between open and close sequences }} | {{OBDtr|0x7C|int16|FFDDDD|00 00|0 | stop frame for the first "half" of the animation; used by door animations to distinguish between open and close sequences }} | ||
{{OBDtr|0x7E|int16|64AAAA|65 00| | {{OBDtr|0x7E|int16|64AAAA|65 00|101 | 101 keyframes in array}} | ||
{{OBDtrBK|First keyframe (black outline)}} | {{OBDtrBK|First keyframe (black outline)}} | ||
|- ALIGN=CENTER VALIGN=TOP | |- ALIGN=CENTER VALIGN=TOP | ||
| Line 91: | Line 92: | ||
{{OBDtr|0x1C|int32|FF00C8|00 00 00 00 |0 |elapsed time in frames}} | {{OBDtr|0x1C|int32|FF00C8|00 00 00 00 |0 |elapsed time in frames}} | ||
|} | |} | ||
Object animations are used to animate [[OBD:OBOA|objects]] (doors included), [[OBD:TRIG|triggers]], cameras and characters. Object animations may be referenced from OBOA but they can also be set using env_setanim script command. Camera animations are never referenced from data files, they're started from script using cm_anim/cm_interpolate. Because of this the only way to tell if an animation is intended for camera or for an object is to look at the level scripts. | |||
Characters can have an object animation applied to them by using chr_envanim/chr_envanim_block. The object animation controls the movement of the character and it's normally used together with a [[OBD:TRAM|Totoro animation]] that has the 'real world' flag set. This can be used to make the character appear attached to another animated object, for example the motorcycle in the opening of Lab level. | |||
;Transform matrices | ;Transform matrices | ||
:Like all matrices in Oni, they are composed of 3 vectors defining rotation/scaling/shearing and a 4th vector defining a translation. | :Like all matrices in Oni, they are composed of 3 vectors defining rotation/scaling/shearing and a 4th vector defining a translation. | ||
:In the above table the 4 vectors are presented as rows ([[ | :In the above table the 4 vectors are presented as rows ([[wp:Row-_and_column-major_order|Direct 3D convention]]), although OpenGL and Oni use them as columns. | ||
:[[ | :[[wp:Transformation_matrix#Affine_transformations|Affine transformations]] use a 4x4 matrix with 4 extra coefficients (in the presentation above, one would add one column on the right): | ||
::three [[ | ::three [[wp:3D_projection|projection transform]] coefficients (all of them are zero here); one final coefficient (always 1.0 for an affine transform matrix). | ||
:Alternatively, one can think of the 3x4 matrix as a 3x3 rotation/scaling matrix and a position vector | :Alternatively, one can think of the 3x4 matrix as a 3x3 rotation/scaling matrix and a position vector | ||
::*Let X=(x, y, z) be the position of a vertex in the M3GM | ::*Let X=(x, y, z) be the position of a vertex in the M3GM | ||
| Line 104: | Line 109: | ||
::(left multiplication is used because of the row-major notation above) | ::(left multiplication is used because of the row-major notation above) | ||
;Initial transform matrix | ;Initial transform matrix | ||
:It is used to position the object in the environment before the animation is played. | :It is used to position the object in the environment before the animation is played, it coresponds to the first animation frame. | ||
:When the animation is played, they use the fixed transform matrix and a quaternion. | :When the animation is played, they use the fixed transform matrix and a quaternion. | ||
;Fixed transform matrix | ;Fixed transform matrix | ||
| Line 118: | Line 123: | ||
---- | ---- | ||
---- | ---- | ||
{{OBD_File_Footer | type=OBAN | prev=Mtrl | next=OBDC | name=Object Animation | family= | {{OBD_File_Footer | type=OBAN | prev=Mtrl | next=OBDC | name=Object Animation | family=General | align=center}} | ||
{{OBD}} | |||
Latest revision as of 21:40, 9 December 2023
|
|
| Offset | Type | Raw Hex | Value | Description | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 0x00 | res_id | 01 86 00 00 | 134 | 00134-Blackvan_FB.OBAN | ||||||||||||||||||||||||
| 0x04 | lev_id | 01 00 00 06 | 3 | level 3 | ||||||||||||||||||||||||
| 0x08 | char[12] | 00 00 00 00 | 0 | padding | ||||||||||||||||||||||||
| 0x14 | int32 | 00 00 00 00 | 0 | flags; used values:
| ||||||||||||||||||||||||
| 0x18 | matrix |
|
|
initial position transform matrix | ||||||||||||||||||||||||
| 0x48 | matrix |
|
|
fixed transform matrix | ||||||||||||||||||||||||
| 0x78 | int16 | 50 00 | 80 | fubared animation frame length (in 1/60 seconds); does not work | ||||||||||||||||||||||||
| 0x7A | int16 | F5 01 | 501 | animation length in frames | ||||||||||||||||||||||||
| 0x7C | int16 | 00 00 | 0 | stop frame for the first "half" of the animation; used by door animations to distinguish between open and close sequences | ||||||||||||||||||||||||
| 0x7E | int16 | 65 00 | 101 | 101 keyframes in array | ||||||||||||||||||||||||
| First keyframe (black outline) | ||||||||||||||||||||||||||||
| 0x00 | quaternion |
|
|
object rotation | ||||||||||||||||||||||||
| 0x10 | vector |
|
|
object position | ||||||||||||||||||||||||
| 0x1C | int32 | 00 00 00 00 | 0 | elapsed time in frames | ||||||||||||||||||||||||
Object animations are used to animate objects (doors included), triggers, cameras and characters. Object animations may be referenced from OBOA but they can also be set using env_setanim script command. Camera animations are never referenced from data files, they're started from script using cm_anim/cm_interpolate. Because of this the only way to tell if an animation is intended for camera or for an object is to look at the level scripts.
Characters can have an object animation applied to them by using chr_envanim/chr_envanim_block. The object animation controls the movement of the character and it's normally used together with a Totoro animation that has the 'real world' flag set. This can be used to make the character appear attached to another animated object, for example the motorcycle in the opening of Lab level.
- Transform matrices
- Like all matrices in Oni, they are composed of 3 vectors defining rotation/scaling/shearing and a 4th vector defining a translation.
- In the above table the 4 vectors are presented as rows (Direct 3D convention), although OpenGL and Oni use them as columns.
- Affine transformations use a 4x4 matrix with 4 extra coefficients (in the presentation above, one would add one column on the right):
- three projection transform coefficients (all of them are zero here); one final coefficient (always 1.0 for an affine transform matrix).
- Alternatively, one can think of the 3x4 matrix as a 3x3 rotation/scaling matrix and a position vector
- Let X=(x, y, z) be the position of a vertex in the M3GM
- Let M=(m11, m21, m31; m12, m22, m32; m13, m23, m33) be the 3x3 matrix
- Let R=(m14, m24, m34) be the translation vector
- Then the absolute position of the vertex in the 3D world will be: X M + R
- (left multiplication is used because of the row-major notation above)
- Initial transform matrix
- It is used to position the object in the environment before the animation is played, it coresponds to the first animation frame.
- When the animation is played, they use the fixed transform matrix and a quaternion.
- Fixed transform matrix
- This transformation is applied before the quaternion+position transform at every keyframe.
- The only transform that can't be handled by the quaternion+position is scaling/mirroring.
- Thus, the fixed transform is a scaling matrix most of the time (no rotation or translation).
- In the above example, the fixed transform scales the van up by 1.82 (along all three axes).
- Quaternions
- Those are used in Oni whenever interpolation of 3D rotation is involved (e.g., TRAM rotation)
- In this case, rotation at intermediate frames is interpolated from the keyframe quaternions.
| ONI BINARY DATA |
|---|
| Mtrl << Other file types >> OBDC |
| OBAN : Object Animation |
| General file |