Animation Events (File Format): Difference between revisions

Jump to navigation Jump to search

Animation Events (File Format) (view source)

Revision as of 20:17, 9 June 2021

6,757 bytes added ,  9 June 2021
→‎Metroid Prime 1/2
VisualWikitext
>Aruki
(Created page with "The '''EVNT format''' is for animation POI data. Very little is known about it. {{researchmajor|Basically everything.}} Category:File Formats Category:Metroid Prime...")
 
imported>Darkszero
 
(33 intermediate revisions by 5 users not shown)
Line 1: Line 1:
The '''EVNT format''' is for animation POI data. Very little is known about it.
{{research|1|Some event parameters need research}}
'''Animation events''' control functional events synchronized to rigged animations for things like sound effects, visual effects, character messages, and playback control. The events can be found in different places in each game; in Prime 1, they are stored in their own file format, the '''EVNT format'''. In Echoes, the format is the same as Prime 1, but was merged in to the [[ANCS (File Format)|ANCS format]] instead of getting its own file. In Prime 3 and the Donkey Kong Country series, events can be found in the [[CHAR (File Format)|CHAR format]], as well as Prime 3's [[SAND (File Format)|SAND format]].


{{researchmajor|Basically everything.}}
== Format ==
 
=== File Structure (Metroid Prime 1/2) ===
 
{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| u32
| 1
| '''Version'''
| Either 1 or 2. Both can appear in Prime 1, while Echoes uses version 2 (the version number wasn't updated in Echoes despite format changes).
|-
| u32
| 1
| '''Bool Event Count'''
|
|-
| [[#Bool Event|Bool Event]]
| ''Bool Event Count''
| '''Bool Events'''
|
|-
| u32
| 1
| '''Int32 Event Count'''
|
|-
| [[#Int32 Event|Int32 Event]]
| ''Int32 Event Count''
| '''Int32 Events'''
|
|-
| u32
| 1
| '''Particle Event Count'''
|
|-
| [[#Particle Event|Particle Event]]
| ''Particle Event Count''
| '''Particle Events'''
|
|-
| u32
| 1
| '''Sound Event Count'''
| Not present in version 1
|-
| [[#Sound Event|Sound Event]]
| ''Sound Event Count''
| '''Sound Events'''
| Not present in version 1
|}
 
=== Event Type ===
 
Table is accurate to Prime 1, unknown for other games.
 
{| class="wikitable"
! ID
! Type
|-
| 0
| Loop
|-
| 1
| EmptyBool
|-
| 2
| EmptyInt32
|-
| 4
| SoundInt32
|-
| 5
| Particle
|-
| 6
| UserEvent
|-
| 7
| RandRate
|-
| 8
| Sound
|}
 
 
=== Event Base ===
 
These parameters are common to every event type.
 
{| class="wikitable"
! Type
! Count
! Name
! Notes
! MP1/2
! MP3
|-
| u16
| 1
| {{unknown|Unknown}}
|
| {{check}}
| {{check}}
|-
| string
| 1
| '''Event Name'''
|
| {{check}}
| {{check}}
|-
| u16
| 1
| '''Event Type'''
| Enumerated event type (unknown values)
| {{check}}
| {{check}}
|-
| [[Char Anim Time]]
| 1
| '''Event Timestamp'''
| Time (in seconds) from start of [[ANIM (File Format)|ANIM]] to trigger event
| {{check}}
| {{check}}
|-
| u32
| 1
| '''Event Index'''
| Index of event unique from other events (perhaps used to maintain a ''triggered'' bitmap)
| {{check}}
| {{check}}
|-
| u32
| 1
| {{unknown}}
|
| {{nocheck}}
| {{check}}
|-
| bool
| 1
| '''Unique'''
|
| {{check}}
| {{check}}
|-
| float
| 1
| '''Weight'''
| The likelihood of this event being selected
| {{check}}
| {{check}}
|-
| s32
| 1
| '''Character Index'''
| Character index that this event should trigger for. If -1, this event triggers for all characters.
| {{check}}
| {{check}}
|-
| u32
| 1
| '''Flags'''
|
| {{check}}
| {{check}}
|-
| u32
| 1
| {{unknown}}
|
| {{nocheck}}
| {{check}}
|-
| u32
| 1
| {{unknown}}
|
| {{nocheck}}
| {{check}}
|-
| u32
| 1
| {{unknown}}
|
| {{nocheck}}
| {{check}}
|-
| float
| 1
| {{unknown}}
|
| {{nocheck}}
| {{check}}
|-
| float
| 1
| {{unknown}}
|
| {{nocheck}}
| {{check}}
|}
 
=== Bool Event ===
 
{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| [[#Event Base|Event Base]]
| 1
| '''Event Base'''
|
|-
| bool
| 1
| '''Value'''
|
|}
 
=== Int32 Event ===
 
==== Metroid Prime 1/2 ====
 
{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| [[#Event Base|Event Base]]
| 1
| '''Event Base'''
|
|-
| s32
| 1
| '''Value'''
| Numeric value for the event
|-
| string
| 1
| '''Bone Name'''
| Name of the [[CINF (File Format)|CINF]] bone to attach this event to (for applicable events)
|}
 
==== Metroid Prime 3 ====
 
{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| [[#Event Base|Event Base]]
| 1
| '''Event Base'''
|
|-
| u8
| 1
| {{unknown}}
|
|-
| u16
| 1
| {{unknown}}
|
|-
| u16
| 1
| {{unknown}}
|
|}
 
=== Particle Event ===
 
{| class="wikitable"
! Type
! Count
! Name
! Notes
! MP1
! MP2
! MP3
|-
| [[#Event Base|Event Base]]
| 1
| '''Event Base'''
|
| {{check}}
| {{check}}
| {{check}}
|-
| u32
| 1
| '''Frame Count'''
| Number of frames to run the effect emitter for
| {{check}}
| {{check}}
| {{nocheck}}
|-
| {{FourCC}}
| 1
| '''Effect Type'''
| FourCC of effect's type; either [[PART (File Format)|PART]], [[SWHC (File Format)|SWHC]], or [[ELSC (File Format)|ELSC]]
| {{check}}
| {{check}}
| {{check}}
|-
| Asset ID
| 1
| '''Effect ID'''
| Asset ID of the effect resource
| {{check}}
| {{check}}
| {{check}}
|-
| string
| 1
| '''Bone Name'''
| Name of the [[CINF (File Format)|CINF]] bone to attach this effect to
| {{check}}
| {{nocheck}}
| {{nocheck}}
|-
| u32
| 1
| '''Bone ID'''
| ID of the [[CINF (File Format)|CINF]] bone to attach this effect to
| {{nocheck}}
| {{check}}
| {{nocheck}}
|-
| float
| 1
| '''Effect Scale'''
| Uniform scale of the particle effect
| {{check}}
| {{check}}
| {{nocheck}}
|-
| u32
| 1
| '''Transform Type'''
| Enumerated transform-mode relating effect to actor's bone:
<ol start="0">
<li>Emitter transformed to bone for initial frame, then retained</li>
<li>Emitter continuously transformed to bone</li>
<li>Entire effect (including particle instances) continuously transformed to bone</li>
</ol>
| {{check}}
| {{check}}
| {{nocheck}}
|-
| float
| 1
| {{unknown}}
| Probably effect scale?
| {{nocheck}}
| {{nocheck}}
| {{check}}
|-
| u32
| 1
| {{unknown}}
| Probably bone ID?
| {{nocheck}}
| {{nocheck}}
| {{check}}
|}
 
=== Sound Event ===
 
==== Metroid Prime 1/2 ====
 
{| class="wikitable"
! Type
! Count
! Name
! Notes
! MP1
! MP2
|-
| [[#Event Base|Event Base]]
| 1
| '''Event Base'''
|
| {{check}}
| {{check}}
|-
| u32
| 1
| '''Sound ID'''
| Lower 16 bits are an [[AGSC (File Format)|AGSC]] sound ID indirected via the [[ATBL (File Format)|ATBL]]; most significant bit is a ''looped'' flag
| {{check}}
| {{check}}
|-
| float
| 1
| '''Reference Amplitude'''
| Reference amplitude for audio attenuation
| {{check}}
| {{check}}
|-
| float
| 1
| '''Reference Distance'''
| Reference distance for audio attenuation
| {{check}}
| {{check}}
|-
| u32
| 1
| {{unknown|Unknown}}
|
| {{nocheck}}
| {{check}}
|-
| u16
| 1
| {{unknown|Unknown}}
|
| {{nocheck}}
| {{check}}
|-
| u16
| 1
| {{unknown|Unknown}}
|
| {{nocheck}}
| {{check}}
|-
| float
| 1
| {{unknown|Unknown}}
|
| {{nocheck}}
| {{check}}
|}
 
==== Metroid Prime 3 ====
 
{| class="wikitable"
! Type
! Count
! Name
! Notes
|-
| [[#Event Base|Event Base]]
| 1
| '''Event Base'''
|
|-
| Asset ID ([[CAUD (File Format)|CAUD]])
| 1
| '''Sound Effect'''
| Sound to be played.
|-
| u32
| 1
| {{unknown}}
|
|-
| u32
| 1
| {{unknown}}
|
|-
| [[#Unknown Typed Structure|Unknown Typed Structure]]
| 1
| {{unknown}}
|
|-
| [[#Unknown Typed Structure|Unknown Typed Structure]]
| 1
| {{unknown}}
|
|}
 
===== Unknown Typed Structure =====
 
Contains a 32-bit type value, followed by either:
 
* Type 0: Nothing
* Type 1: A float
* Type 2: A [[Maya Spline]]


[[Category:File Formats]]
[[Category:File Formats]]
[[Category:Metroid Prime]]
[[Category:Metroid Prime]]
[[Category:Metroid Prime 2: Echoes]]
[[Category:Metroid Prime 2: Echoes]]
[[Category:Metroid Prime 3: Corruption]]
Anonymous user
Retrieved from "https://wiki.axiodl.com/w/Special:MobileDiff/1934...1968"

Navigation menu