Animation Events (File Format): Difference between revisions

The '''EVNT format''' is a companion to [[ANIM (File Format)|ANIM]] resources. It controls functional events synchronized to rigged animations for things like sound effects, visual effects, character messages, and playback control. In Echoes, this format was merged in to the end of the [[ANCS (File Format)|ANCS]] format, but the structure of the file is mostly the same (with a couple changes).

 

! 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

| '''Loop Event Count'''

|  

| [[#Loop Event|Loop Event]]

| ''Loop Event Count''

| '''Loop Events'''

|  

| u32

| 1

| '''UEVT Event Count'''

|  

| [[#UEVT Event|UEVT Event]]

| ''UEVT Event Count''

| '''UEVT Events'''

|  

| u32

| 1

| '''Effect Event Count'''

|  

| [[#Effect Event|Effect Event]]

| ''Effect Event Count''

| '''Effect 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

! Type

! Count

! Name

! Notes

| u16

| 1

| {{unknown|Unknown}}

|  

| string

| 1

| '''Event Name'''

|  

| u16

| 1

| '''Event Type'''

| Enumerated event type (unknown values)

| float

| 1

| '''Event Timestamp'''

| Time (in seconds) from start of [[ANIM (File Format)|ANIM]] to trigger event

| u32

| 1

| {{unknown|Unknown}}

|  

| u32

| 1

| '''Event Index'''

| Index of event unique from other events (perhaps used to maintain a ''triggered'' bitmap)

| bool

| 1

| {{unknown|Unknown}}

|  

| float

| 1

| {{unknown|Unknown}}

|  

| float

| 1

| {{unknown|Unknown}}

|  

! Type

! Count

! Name

! Notes

| [[#Event Base|Event Base]]

| 1

|  

| bool

| 1

| {{unknown|Unknown}}

|  

! Type

! Count

! Name

! Notes

| [[#Event Base|Event Base]]

| 1

|  

| u32

| 1

| '''UEVT Type'''

| Enumerated UEVT type (unknown values)

| string

| 1

| '''Bone Name'''

| Name of the [[CINF (File Format)|CINF]] bone to attach this event to (for applicable events)

! Type

! Name

! Notes

! MP1

! MP2

| [[#Event Base|Event Base]]

| 1

| {{check}}

| u32

| 1

| '''Frame Count'''

| Number of frames to run the effect emitter for

| char

| 4

| '''Effect Type'''

| FourCC of effect's type; either [[PART (File Format)|PART]], [[SWHC (File Format)|SWHC]], or [[ELSC (File Format)|ELSC]]

| Asset ID

| 1

| '''Effect ID'''

| Asset ID of the effect resource

| string

| 1

| '''Bone Name'''

| Name of the [[CINF (File Format)|CINF]] bone to attach this effect to

| u32

| 1

| '''Bone ID'''

| ID of the [[CINF (File Format)|CINF]] bone to attach this effect to

| float

| 1

| '''Effect Scale'''

| Uniform scale of the particle effect

| Enumerated transform-mode relating effect to actor's bone:

<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>

! Type

! Count

! Name

! MP1

! MP2

| u32

| 1

| {{unknown|Unknown}}

|  

| {{nocheck}}

| u16

| 1

| {{unknown|Unknown}}

|  

| {{nocheck}}

| {{check}}

| u16

| 1

|  

| {{nocheck}}

| {{check}}

| float

| 1

|  

| {{nocheck}}

| {{check}}