Vehicle Animation: Difference between revisions

From Burnout Wiki
Content added Content deleted
VisualWikitext
(Created page.)
 
(Updated enumerations and changed descriptions to indicate ties to part models. (Thanks Matt))
Line 1: Line 1:
<pre>This page is a work in progress. Check back at a later date for more up-to-date information.</pre>

The vehicle animation resource type stores per-vehicle user-triggered animations, working in conjunction with a [[Body Part Remap Data]] resource.
The vehicle animation resource type stores per-vehicle user-triggered animations, working in conjunction with a [[Body Part Remap Data]] resource.


Line 15: Line 13:
| 0x4 || 0x4 || uint32_t || ? || Version number || 1
| 0x4 || 0x4 || uint32_t || ? || Version number || 1
|-
|-
| 0x8 || 0x4 || uint32_t || ? || Number of animations ||
| 0x8 || 0x4 || uint32_t || ? || Number of models ||
|-
|-
| 0xC || 0x4 || [[#Animation|Animation]]* || ? || Animations ||
| 0xC || 0x4 || [[#Model|Model]]* || ? || Models ||
|-
|-
| 0x10 || 0x4 || uint32_t || ? || Number of animation data entries ||
| 0x10 || 0x4 || uint32_t || ? || Number of animation data entries ||
|-
|-
| 0x14 || 0x4 || [[#Animation data|Animation data]]* || ? || Animation data ||
| 0x14 || 0x4 || [[#Animation|Animation]]* || ? || Animation data ||
|-
|-
| 0x18 || 0x4 || uint32_t || ? || Number of secondary data entries ||
| 0x18 || 0x4 || uint32_t || ? || Number of modifier entries ||
|-
|-
| 0x1C || 0x4 || [[#Secondary data|Secondary data]]* || ? || Secondary data ||
| 0x1C || 0x4 || [[#Animation modifier|Animation modifier]]* || ? || Modifier/attribute data ||
|-
|-
| 0x20 || 0x4 || int8_t[4] || ? || Wheel animation indices || Order: Front left, front right, rear left, rear right<br />-1 if unused; no animation displays
| 0x20 || 0x4 || int8_t[4] || ? || Wheel part model indices || Order: Front left, front right, rear left, rear right<br />-1 if unused; no animation displays
|-
|-
| 0x24 || 0xC || || || padding ||
| 0x24 || 0xC || || || padding ||
Line 42: Line 40:
| 0x4 || 0x4 || uint32_t || ? || Version number || 1
| 0x4 || 0x4 || uint32_t || ? || Version number || 1
|-
|-
| 0x8 || 0x4 || uint32_t || ? || Number of animations ||
| 0x8 || 0x4 || uint32_t || ? || Number of models ||
|-
|-
| 0xC || 0x4 || || || padding ||
| 0xC || 0x4 || || || padding ||
|-
|-
| 0x10 || 0x8 || [[#Animation|Animation]]* || ? || Animations ||
| 0x10 || 0x8 || [[#Model|Model]]* || ? || Models ||
|-
|-
| 0x18 || 0x4 || uint32_t || ? || Number of animation data entries ||
| 0x18 || 0x4 || uint32_t || ? || Number of animation data entries ||
Line 52: Line 50:
| 0x1C || 0x4 || || || padding ||
| 0x1C || 0x4 || || || padding ||
|-
|-
| 0x20 || 0x8 || [[#Animation data|Animation data]]* || ? || Animation data ||
| 0x20 || 0x8 || [[#Animation|Animation]]* || ? || Animation data ||
|-
|-
| 0x28 || 0x4 || uint32_t || ? || Number of secondary data entries ||
| 0x28 || 0x4 || uint32_t || ? || Number of modifier entries ||
|-
|-
| 0x2C || 0x4 || || || padding ||
| 0x2C || 0x4 || || || padding ||
|-
|-
| 0x30 || 0x8 || [[#Secondary data|Secondary data]]* || ? || Secondary data ||
| 0x30 || 0x8 || [[#Animation modifier|Animation modifier]]* || ? || Modifier/attribute data ||
|-
|-
| 0x38 || 0x4 || int8_t[4] || ? || Wheel animation indices || Order: Front left, front right, rear left, rear right<br />-1 if unused; no animation displays
| 0x38 || 0x4 || int8_t[4] || ? || Wheel part model indices || Order: Front left, front right, rear left, rear right<br />-1 if unused; no animation displays
|-
|-
| 0x3C || 0x4 || || || padding ||
| 0x3C || 0x4 || || || padding ||
Line 67: Line 65:
|}
|}


=== Animation ===
=== Model ===
{{todo|Research the non-primary indices.}}
{{todo|Research the non-primary indices.}}


Line 73: Line 71:
! Offset !! Length !! Type !! Name !! Description !! Comments
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
|-
| 0x0 || 0x1 || int8_t || ? || Animation index || Primary index
| 0x0 || 0x1 || int8_t || ? || Part model index || Primary index from the [[Vehicle Graphics|graphics]] resource
|-
|-
| 0x1 || 0x1 || int8_t || ? || Second animation index? || -1 if unused
| 0x1 || 0x1 || int8_t || ? || Second part model index? || From the [[Vehicle Graphics|graphics]] resource. -1 if unused
|-
|-
| 0x2 || 0x1 || int8_t || ? || Third animation index? || -1 if unused
| 0x2 || 0x1 || int8_t || ? || Third part model index? || From the [[Vehicle Graphics|graphics]] resource. -1 if unused
|}
|}


=== Animation data ===
=== Animation ===
{{todo|Research types/flags, understand connection between byte at 0x2 and secondary data.}}
{{todo|Research types/flags, understand connection between byte at 0x2 and secondary data.}}


Line 86: Line 84:
! Offset !! Length !! Type !! Name !! Description !! Comments
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
|-
| 0x0 || 0x1 || int8_t || ? || Index ||
| 0x0 || 0x1 || int8_t || ? || Part model index || From the [[Vehicle Graphics|graphics]] resource
|-
|-
| 0x1 || 0x1 || int8_t || ? || Type or flags ||
| 0x1 || 0x1 || int8_t || ? || Animation type || See [[#Animation type|animation type]]
|-
|-
| 0x2 || 0x1 || int8_t || ? || Secondary index? || Refers to secondary data index on cops but not others
| 0x2 || 0x1 || int8_t || ? || Modifier part model index? || Refers to modifier part model on cops but not others. See [[#Animation modifier|animation modifier]]
|-
|-
| 0x3 || 0xD || || || padding ||
| 0x3 || 0xD || || || padding ||
Line 97: Line 95:
|}
|}


=== Secondary data ===
=== Animation modifier ===
{{todo|Understand the animation type/action field.}}
{{todo|Understand the animation type/action field.}}


Line 103: Line 101:
! Offset !! Length !! Type !! Name !! Description !! Comments
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
|-
| 0x0 || 0x1 || int8_t || ? || Index ||
| 0x0 || 0x1 || int8_t || ? || Part model index || From the [[Vehicle Graphics|graphics]] resource
|-
|-
| 0x1 || 0x1 || int8_t || ? || Animation type/action (per pashok) || Trigger? 0 and 0x15 on cops/DLC. More on bikes (0xB).
| 0x1 || 0x1 || int8_t || ? || Animation trigger || See [[#Animation trigger|animation trigger]]
|-
|-
| 0x2 || 0x1 || bool || ? || Loop animation ||
| 0x2 || 0x1 || bool || ? || Loop animation ||
Line 115: Line 113:


= Enumerations =
= Enumerations =
=== Type or flags ===
=== Animation type ===
{{todo|Values such as 3 are used; explore what they do and determine if these are flags or not.}}
{{todo|Values such as 3 are used; explore what they do and determine if these are flags or not.}}
{| class="wikitable"
{| class="wikitable"
! Name !! Value !! Comments
! Name !! Value !! Comments
|-
|-
| ? || 0x1 || Rotate
| ? || 0 || None
|-
| ? || 1 || Rotate
|-
| ? || 2 || Transform
|-
| ? || 3 ||
|-
| ? || 4 || Rotate (reversed)?
|-
| ? || 5 || Rotate once and return to origin
|}

=== Animation trigger ===
{| class="wikitable"
|+ Caption text
|-
! Name !! Value !! Comments
|-
| ? || 0 ||
|-
| ? || 1 || Turning
|-
| ? || 2 ||
|-
| ? || 3 ||
|-
| ? || 4 ||
|-
| ? || 5 ||
|-
| ? || 6 || Front right wheel rotation
|-
| ? || 7 || Front left wheel rotation
|-
| ? || 8 || Rear right wheel rotation
|-
| ? || 9 || Rear left wheel rotation
|-
| ? || 10 || Brake
|-
| ? || 11 || Throttle
|-
| ? || 12 ||
|-
| ? || 13 || Speed
|-
| ? || 14 || RPM
|-
| ? || 15 ||
|-
| ? || 16 ||
|-
| ? || 17 ||
|-
| ? || 18 ||
|-
| ? || 19 ||
|-
|-
| ? || 0x2 || Transform
| ? || 20 || Hover
|-
|-
| ? || 0x4 || Rotate (reversed)?
| ? || 21 || Boost
|}
|}


Revision as of 20:49, 31 October 2022

The vehicle animation resource type stores per-vehicle user-triggered animations, working in conjunction with a Body Part Remap Data resource.

Structures

Note: This type has no available debugging symbols. All structures are based on user research and are unconfirmed.

Header

32-bit

Offset Length Type Name Description Comments
0x0 0x4 uint32_t ? Resource size
0x4 0x4 uint32_t ? Version number 1
0x8 0x4 uint32_t ? Number of models
0xC 0x4 Model* ? Models
0x10 0x4 uint32_t ? Number of animation data entries
0x14 0x4 Animation* ? Animation data
0x18 0x4 uint32_t ? Number of modifier entries
0x1C 0x4 Animation modifier* ? Modifier/attribute data
0x20 0x4 int8_t[4] ? Wheel part model indices Order: Front left, front right, rear left, rear right
-1 if unused; no animation displays
0x24 0xC padding
0x30 0x100 Matrix44Affine[4] ? Wheel positions Order: Front left, front right, rear left, rear right
Animation only; real positions in deformation resource

64-bit

Offset Length Type Name Description Comments
0x0 0x4 uint32_t ? Resource size
0x4 0x4 uint32_t ? Version number 1
0x8 0x4 uint32_t ? Number of models
0xC 0x4 padding
0x10 0x8 Model* ? Models
0x18 0x4 uint32_t ? Number of animation data entries
0x1C 0x4 padding
0x20 0x8 Animation* ? Animation data
0x28 0x4 uint32_t ? Number of modifier entries
0x2C 0x4 padding
0x30 0x8 Animation modifier* ? Modifier/attribute data
0x38 0x4 int8_t[4] ? Wheel part model indices Order: Front left, front right, rear left, rear right
-1 if unused; no animation displays
0x3C 0x4 padding
0x40 0x100 Matrix44Affine[4] ? Wheel positions Order: Front left, front right, rear left, rear right
Animation only; real positions in deformation resource

Model

Hmmm...
Hmmm...
To do:
Research the non-primary indices.
Offset Length Type Name Description Comments
0x0 0x1 int8_t ? Part model index Primary index from the graphics resource
0x1 0x1 int8_t ? Second part model index? From the graphics resource. -1 if unused
0x2 0x1 int8_t ? Third part model index? From the graphics resource. -1 if unused

Animation

Hmmm...
Hmmm...
To do:
Research types/flags, understand connection between byte at 0x2 and secondary data.
Offset Length Type Name Description Comments
0x0 0x1 int8_t ? Part model index From the graphics resource
0x1 0x1 int8_t ? Animation type See animation type
0x2 0x1 int8_t ? Modifier part model index? Refers to modifier part model on cops but not others. See animation modifier
0x3 0xD padding
0x10 0x30 Matrix33 ?

Animation modifier

Hmmm...
Hmmm...
To do:
Understand the animation type/action field.
Offset Length Type Name Description Comments
0x0 0x1 int8_t ? Part model index From the graphics resource
0x1 0x1 int8_t ? Animation trigger See animation trigger
0x2 0x1 bool ? Loop animation
0x3 0xD padding
0x10 0x20 Vector4[2] ?

Enumerations

Animation type

Hmmm...
Hmmm...
To do:
Values such as 3 are used; explore what they do and determine if these are flags or not.
Name Value Comments
? 0 None
? 1 Rotate
? 2 Transform
? 3
? 4 Rotate (reversed)?
? 5 Rotate once and return to origin

Animation trigger

Caption text
Name Value Comments
? 0
? 1 Turning
? 2
? 3
? 4
? 5
? 6 Front right wheel rotation
? 7 Front left wheel rotation
? 8 Rear right wheel rotation
? 9 Rear left wheel rotation
? 10 Brake
? 11 Throttle
? 12
? 13 Speed
? 14 RPM
? 15
? 16
? 17
? 18
? 19
? 20 Hover
? 21 Boost
Retrieved from "https://burnout.wiki/wiki/Vehicle_Animation?oldid=8634"