Gets the animation-time elapsed since the start of a specified element of the current animation action. Useful for synchronizing events to elements of an animation action.

Reminder: first element of an action is element 1, not 0.

Format:

AnimElem = value1

AnimElem = value1, [oper] value2

Arguments:

Return type: boolean (0 if false or 1 if true)

Error conditions: none

Details:

Trigger in Format 1 is true if the player's animation is at the start of the element number specified by value1. In other words, if value1 is equal to n, it is true on the first game-tick of the nth element of the animation. Trigger in Format 2 compares the player's animation-time to t+value2, where t is time of the start of the element number specified by value1. If value1 is an invalid animation element, M.U.G.E.N may crash or behave strangely.

Examples:

trigger1 = AnimElem = 2 ; True on the first game-tick that the player's animation is on element 2. Is equivalent to saying: trigger1 = AnimElem = 2, = 0.


trigger1 = AnimElem = 2, = 4 ; True 4 game-ticks after the start of the player's second animation element.


trigger1 = AnimElem = 2, >= 0
trigger1 = AnimElem = 3, < 0 ; True for the whole of the second element of the player's animation, assuming there is a third element. If a third element does not exist, the second line should read, trigger1 = AnimTime <= 0