wiki.omf2097.com

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== Animation string =====
[[omf2097_file_formats|<-back]]

Animation Strings are the code inside the .AF files (HAR/Bots), that defines how moves and various other things works. They're a string of various tags and values, that instructs the game/engine on what actions to pull at what stage of each move etc. This page is a list of all the tags and with what the OpenOMF team have figured out about them so far.

----
===== Basic format =====

Animation strings are of the form:

  <frame descriptor 1>-<frame descriptor 2>-...-<frame descriptor n>

Frame descriptors are a sequence of lowercase tags followed by an uppercase frame letter and an integer frame duration:

  zzA1

For instance:

  x-5A3-x-3B2-x-2C1-x-1D1

divides up as:

^ Tags ^ Frame ^ Duration ^
| x-5 | A | 3 |
| x-3 | B | 2 |
| x-2 | C | 1 |
| x-1 | D | 1 |

----

===== Tags =====

There are a lot of available tags. Not all of them are understood. Some of them take numeric parameters, which are indicated in angle brackets below. Such parameters must match the regular expression:
<code>
-?+\?[0-9]*
</code>
An omitted parameter is treated as 0.

Here's a complete list of all tags. Descriptions in ''italics'' may be unreliable.

==== A ====

^ Tag  ^ Notes                                                                                       ^
| aa   | Reset your air attack state if you have already performed one                               |
| ab   | Allow passing through walls                                                                 |
| ac   | Turn HAR towards the center of the arena                                                    |
| ad   | Allow the HAR to turn in the held direction. Used in Katana's wall spin and Heel Stomp      |
| ae   | Never used?                                                                                 |
| af   | Freeze opponent HAR for some time                                                           |
| ag   |                                                                                             |
| ai   | hit will launch                                                                             |
| am   | with the enemy modifier, 'ame' is related to the bm tag and tells OMF when to stop walking  |
| ao   | Nova death related, something to do with loose robot parts ?                                |
| as   | Makes the fire orb 'wander' in the fire pit                                                 |
| at   | Chronos Teleport.  Move 40 pixels behind the opponent unless you hold a direction, where it's randomly up to 30 pixels from a wall. |
| aw   | Trigger an animation transition on wall contact                                             |
| ax   | Ignore the ground and fall through the floor                                                |
| ar   | Reverse player direction?                                                                   |
| al   | Never used?                                                                                 |

==== B ====

^ Tag ^ Notes ^
| b<...> | The b codes control the rendering method used for the sprite. A variable b is set to a visibility level, and is linearly interpolated throughout the frame from the bs value to the bf value, if the bs value has been specified and is not zero. Otherwise the b value is set to the bf value. |
| ::: | b = bs ? (bs + (bf - bs) * tick / ticksThisFrame) : bf |
| ::: | The bf value is set by the tags bb, bf, bj, bl, bm. These tags all also set some bflags which control the rendering effect. |
| b1 | Advances you to fight Fire, and on Fire's stage advances you to fight Ice |
| b2 | Breaks the grate on the floor of the Fire Pit, if it is breakable |
| bb<n> | Vertical screen shake with magnitude n  |
| be | Block the end of the round, used in scrap/destruct  |
| bf<n> | Blend finish with opacity n < 256  |
| bh | Used in shadow grab, shadow scrap, chronos matter phasing and very extensively in gargoyle's scrap. Possibly used to ignore bounds checking |
| bl<n> | Horizontal screen shake with magnitude n |
| bm<n> | Animation to play while doing something (walking to har for scrap is bm10) |
| bj<n> | Jump to animation <n> |
| bs<n> | Blend start with opacity n < 256 (the sprite is drawn at this opacity at the start of the frame and gradually transitioned to whatever is set as the blend finish value)  |
| bu | Jump to the middle of arena, used by Jaguar |
| bw | |
| bx | |
| bp<...> | The bp codes control scene and entity lighting and colouring. A variable bp is set to a colour level, and is linearly interpolated throughout the frame from the bpb value to the bpp value. The bpd tag specifies a reference colour (r,g,b) by palette index. |
| ::: | <code>
 bp = bpb + (bpp - bpb) * tick / ticksThisFrame 
 for i = bps to bps + bpn:
 if bz:
   m = max(r_i, g_i, b_i)
   r_i' = r_i + m/64 * bp/64 * (r - r_i*)
   g_i' = g_i + m/64 * bp/64 * (g - g_i*)
   b_i' = b_i + m/64 * bp/64 * (b - b_i*)
 else:
   r_i' = r * bp/64
   g_i' = g_i * (1 - bp/64) + g * bp/64
   b_i' = b_i * (1 - bp/64) + b * bp/64

 r_i = max(0, min(63, r_i'))
 g_i = max(0, min(63, g_i'))
 b_i = max(0, min(63, b_i'))
 </code> |
| ::: | In the above, r_i* is the original (unmodified) value. |
| bpd<n> | bpd := n Specifies a colour (reference palette index) |
| bps<n> | bps := n Starting palette index |
| bpn<n> | bpn := n Palette entry count |
| bpf | Blend Palette Fighter: If this is the HAR for player 2 then bps48 bpn48 (second robot's colours) else bps1 bpn47 (first robot's colours) |
| bpp<n> | bpb := n, bpp := n Set both initial and final colour level. |
| bpb<n> | bpb := n Initial colour level for blending. Specify bpp first. |
| bpo | bpo := 1 Disables palette effects. Only used in CREDITS.BK. |
| bz | If specified, a colour tint effect will be used, otherwise a green-blue lightning effect will be used. |
| ba<n> | Only CREDITS.BK - How many palette copies to make, starting from index bc + bi. |
| bc<n> | Only CREDITS.BK - How many palette entries to copy, starting from index indicated by bi. |
| bd | Only CREDITS.BK - Assumes that the last frame of current animation is a palette, and copies it to temporary buffer to be used by palette effects. |
| bg | Only CREDITS.BK - Changes sprite indexes. For each sprite index, do: <code>new_index = bi + old_index * bc + background_color_index</code>  |
| bi<n> | Only CREDITS.BK - Starting offset for the palette copying. Copied range is bi + ba. |
| bk<n> | Check if animation number <n> is playing. If it is, set the BK flag (that does something ?). crashes if not in arena? |
| bn | Unblockable.  Used in Flail's Spinning Throw, Shadow's Shadow Grab, and Nova's Earthquake Smash |
| bo<n> | |
| br | Draw additively |
| bt | Dark tint effect for eg. Shadow HAR |
| by |	|

==== C ====

^ Tag ^ Notes ^
| cf | Used by Shadow's scrap (AF1:61)  Makes shadow walk to the far corner of arena - used with bm tag |
| cg | Used by Katana's rising blade (normal and extended) (AF5:22,23) |
| cl | Used by Pyros' scrap (both parts) (AF3:35,38) |
| cp | resources/tags.csv:"cp",0,"If hit collision succeeds, perform hit pause" Basic testing: enables hit pause on hit, doesn't stack. |
| cw | Used by Flail's scrap moves (AF7:33,35,36), possibly interacts with `d` and `jn` tags when a wall collision occurs |
| cx<n> | The player has horizontal control by holding left/right. Larger numbers mean faster movement. Used by: |
| ::: | <code>
 Jaguar's Concussion Cannon (AF0:38)
 Thorn's off-wall attack (AF2:39)
 Electra's Ball Lightning (AF4:33)
 Katana's razor spins (AF5:25,26,27,28)
 Flail's chain spins (AF7:31,39)
 Gargoyle standing pose and diving claw grab (AF8:1,35)
 Chronos' Stasis Activator (AF9:38,39)
</code> |
| cy<n> | The player has vertical control by holding up/down. Larger numbers mean faster movement. |

==== D-I ====

^ Tag ^ Notes ^
| d<n> | Jump back into the animation as if N 'ticks' have already occured, for example, d1 will jump back to the start of the animation, but d200 will jump into the animation at whatever point the animation would be 200 ticks after it had started. |
| e | Set X and Y coordinates to same as enemy coords. Applied every tick. |
| f | Toggle flag Flip sprite vertically |
| g | Set object Y coordinate to ground and zero out vertical velocity. Applied every tick. |
| h | Zeroes out velocity for the frame. Applied every tick. |
| i | Proceed to the next animation on hit OR block. |

==== J ====

^ Tag ^ Notes ^
| j<...> | J tags define which moves can 'chain' to which other moves. jf moves appear to chain to your scrap move (f=finisher here). It is unknown whether jn<n> is part of this block of tags or a separate tag. |
| jf2 | Frame can chain to destruction |
| jf | Frame can chain to scrap |
| jg | Frame can chain to a 'throw' move |
| jh | Frame can chain to a 'high' move, eg. roundhouse kick |
| jj | Frame can chain into an 'airborne' move (only used by katana's razor spin) |
| jl | Frame can chain to a 'low' move eg. crouching kick |
| jm | Frame can chain to a 'medium' move eg. crouching punch |
| jp | |
| jz | Combination of all other j flags except jn. Only used by (AF5:35). |
| jn<n> | Frame can chain to animation <n> |

==== K-L ====

^ Tag ^ Notes ^
| k    | Knocks you back but only if it is the first character of an enemy string and only if it wasn't a throw.  Invalid otherwise. |
| k<n> | Perform a knockback on hit?  Unclear what it actually does |
| l<n> | The volume of the sound. The range of n is 0 to 100 (0 effectively mutes the sound, no differences above 100) |

==== M-O ====

^ Tag ^ Notes ^
| ma<n> | Sets angle of new object in degrees. Velocity is then x=cos(ma), y=sin(ma). if n == 1000 then n := random(360) |
| mc | Only used by shadow, probably links the shadow projections to the HAR |
| md<n> | Destroy animation n |
| mg<n> | Gravity for the spawned animation, default is apparently 0. |
| mi<n> | |
| mm<n> | Selects an animation ID for use with mo, mu tags. Animation must exist, otherwise undefined behaviour. MM must be set before using mo, mu. It is possible to chain these, eg. mm15momm22mu5 etc. |
| mo | Enables some flag on animation selected with MM. Possibly used on other HAR ? |
| mu<n> | Sets animation MM unavailable for use for the next <n> ticks. N < 1024. |
| mn<n> | Sets z-index for the current and following animation sprites and created animations (by m tag). 0 disables, 1-n enables. Empty value means 0. |
| mp<n> | Bitmask (1 byte). Affects at least how mn tag is handled. <code>
0x1  Run sprite pixel colors through the palette remapping multiple times (how many?)
0x2  Unknown
0x4  Unknown, HAR 1 related ?
0x8  Unknown
0x10 Unknown, HAR 2 related ?
0x20 Unknown
0x40 Unknown
0x80 Unknown
</code>|
| mrx<n> | mx := random(320 - 2*mm) + n -- Randomizes X coordinate of the new animation. |
| mry<n> | my := random(200 - 2*mm) + n -- Randomizes Y coordinate of the new animation. |
| ms | my := -4 * (y - 188), Used to fix bullet hit animation coordinates for desert arena. |
| mx<n> | Set X coordinate of new animation |
| my<n> | Set Y coordinate of new animation |
| m<n> | Create instance of animation n |
| n | Disabled hit coordinates for the current frame. This is used in recovery frames of attacks. |
| ox<n> | X coordinate correction; is only applied while ox tag is enabled. |
| oy<n> | Y coordinate correction; is only applied while ox tag is enabled. |

==== P-T ====

^ Tag ^ Notes ^
| pa | Enable color effect for HAR palette effects |
| pb<n> | n < 512 |
| pc<n> | n < 512 |
| pd<n> | n < 256. Reference color index. |
| pe | Switch HAR palette effect handling to the other HAR. |
| ph | Disable HAR palette effects if HAR is not in damage animation (9) |
| pp<n> | Effect intensity |
| ps | Update the color palette |
| ptd<n> | Effect fade-in time in ticks (0 - 127) |
| ptp<n> | Effect constant max time in ticks (0-127) |
| ptr<n> | Effect fade-out time in ticks (0-127) |
| q<n> | Enable nth hit. A move can only hit once without this tag. In order to add additional hits, q tags must be present in ascending order. Duplicate q tags or descending q tags have no effect. |
| r |toggle a global Flip sprite horizontally  |
| s<n> | Play sound n. Also resets the sf and sb values to default. |
| sa | |
| sb<n> | Sound panning. The range of n is -100 (far left) to 100 (Far right). Value above 126 causes overflow to -128, value lower than -128 is capped to -128.  |
| sc<n> | sc0 is different from other sc tags -- This is possibly sound channel selection |
| sd | Appears to alter the behaviour of the sf tag, only used in intro.bk |
| se<n> | similar to sl<n+1>, overrides sl if both sl and se are present in this frame. |
| sf<n> | Sound frequency n. n has a range of -16 to 239, anything above 239 seems to overflow the frequency. |
| sl<n> | Pan the sound from sb<n> to sl<n>. |
| smf<n> | |
| smo <n> | Play music track <n>. The track to play is one of the following: |
| ::: | <code>
  * 0 - No music 
  * 1 - End.psm 
  * 2 - Menu.psm 
  * 3 - Arena0.psm 
  * 4 - Arena1.psm 
  * 5 - Arena2.psm 
  * 6 - Arena3.psm 
  * 7 - Arena4.psm
</code> |
| sp<n> | Doesn't seem to have any effects on the intro lightnings. |
| sw<n> | sw<n> sets an internal counter to max(current value, n). This counter is decreased at a rate of either 2 or 4 units per game tick, down to 0. If the counter gets to 100 or above, the game pauses for a little while. |

==== T-Z ====

^ Tag ^ Notes ^
| t | Prevent sound from playing, if other HAR is blocking. |
| ua | Sets enemy HAR to damage animation, if not already set. Used to keep opponent immobilized during shadow grab, until the grab fades. |
| ub | Motion blur effect for the current object |
| uc | |
| ud | |
| ue | Damage opponent if on the ground. Used in earthquake smash. |
| uf | Only used by shadow grab (both forms) and shadow scrap. May have to do with opponent's ground state. |
| ug | |
| uh | |
| uj | |
| ul | |
| un | |
| ur | |
| us | |
| uz | Used in shadow grab. Causes the shadow to disappear when the opponent takes damage |
| v | 'velocity' modifier for x/y tags |
| vsx | also does v. Never used? |
| vsy | actually vsK where K is anything other than x. also does v. Never used? |
| w | Seems to handle sprite caching in engine. |
| x<...> | /x-?\+?=?-?\+?[0-9]*/ is accepted. Code will always be one of the following: |
| x-<n> | Set -x coordinate by n each tick in this frame |
| x+<n> | Set +x coordinate by n each tick in this frame |
| x=<n> | Set x position relative to start position and interpolate to the next x= position |
| x<n> | If unspecified, a value of 100 is assumed. Scales image horizontally between 0 and 100%. (exception: Does not do anything eg. in You win! etc. sprites on arenas). |
| y<...> | /y-?\+?=?-?\+?[0-9]*/ is accepted. Code will always be one of the following: |
| y-<n> | Set -y coordinate by n each tick in this frame |
| y+<n> | Set +y coordinate by n each tick in this frame |
| y=<n> | Set y position relative to start position and interpolate to the next y= position |
| y<n> | If unspecified, a value of 100 is assumed. Scales image vertically between 0 and 100%. |
| z<...> | The z tags specify which attacks the player is invulnerable to, for the duration of the frame. |
| ::: | <code>
The Z Tags
zz: total invincibility?
all frames of Rising Blade
frames 1-2 of Jag Leaps
zp: on early frames of Shadow Headbutt, f1-3 of Flip Kick - inv. projectiles?
zj: invincible to jumps?
all frames of Rising Talon
frames 1-2 of Flip Kick
</code> |
| zg |0x0004 Never used? |
| zh |0x0040 Never used? Player is invincible to 'high' attacks |
| zj |0x0080 Player is invincible to jumping attacks |
| zl |0x0010 Never used? Player is invincible to 'low' attacks |
| zm |0x0020 Never used? Player is invincible to 'medium' attacks |
| zp |0x0100 Player is invincible to projectiles |
| zz |0xFFFF Combination of all other z flags. Player is invincible for this frame|

----

==== ChaosBM Hidden Comments ====

<code>
//chaos -- notes 25/11/09 -- flags' effects on various anim data fields//

f4:
ar 0001
at 0002
af 0004
aa 0008
ai 0010
ac 0020
aw 0040
ad 0080
ab 0400
ao 0800
as 1000
ae 2000
am 4000
ax 8000

al f4 = f4E | 0002 // bug? should this be f4 |= 0x0002?

f4E:
us 0001
bn 0004
ag 0008
ur 0010
ue 0020
ud 0040
uh 0080
uz 0100
uf 0200
uc 0400
ua 0800
ug 1000
ul 2000
by 4000
bo0 4000 // plus some other stuff
bk 8000 // plus some other stuff

f1A:
zg 0004
zl 0010
zm 0020
zh 0040
zj 0080
zp 0100
zz FFFF

f14:
bg 0200
br 0100
bt 0400
f ^ 0004
v = 0001
vsK = 0001 // plus f52

f52:
cf 08
cg 20
cl 40
cp 10
cw 04
uj 80
vsx 01 // plus f14
vsy 02 // plus f14

f22:
jg 0004
fl 0010
jm 0020
jh 0040
jj 0080
jp 0100
jf 1000
jf2 2000
jz FFFF


From [[http://www.omf2097.com/~forum/viewthread.php?tid=193&page=8|:fixme]] : [More incorporated below]

cp: doesn't strictly mean "hits here"
look at Nova's basic punch: it starts hitting on frame 2-3 but doesn't have CP till 4
ub: this frame causes trails
n: during recovery; or during entirety of Concussion Cannon
</code>

----

==== Error handling ====

A handful of animation strings used by the AF and BK files provided with OMF2097 are ill-formed. The behaviour in the case of ill-formed strings in the OMF engine is inconsistent, but at least the following non-tags must be accepted and ignored by any correct parser:

^ Tag ^ Used by ^ Notes ^
| zc | Pyros' Shadow Super Thrust <code>x+4zcubs21l50zp</code> | Probably a typo for zp. It looks like someone added 'zp's at the end of all the tags later when it was found to be not working properly (probably because of this zc). The tags for the frames before and after both contain zp. |

----
wiki.omf2097.com

User Tools

Site Tools

Page Tools
