Custom Animation Functions


Custom Animation Functions

Custom animation functions are an advanced feature that is only intended for users who know Lua. As such, the following page will assume you are familiar with Lua and related programming concepts. For more information on Lua, see Programming In Lua.

WeakAuras allows the user to define custom "paths" for all animation types. For Translation animations, the term "path" is literal; the custom path actually defines what x and y coordinates the display will take. For other animation types, the term "path" simply refers to the manner in which the display's original value is combined with the value specified by the animation to determine a final value, for whatever aspect of the display the animation is meant to alter.

WeakAuras' animation system is based on 4 distinct types of animation: Alpha, Translation, Scale, and Rotate. Every display type supports Alpha and Translation animations. Some display types do not support Scale animations (mostly because it is not possible to cleanly apply Scale animations to text). Only Textures support Rotate animations.

To define a custom animation function in WeakAuras, you must first change the animation's Type to "Custom Function". This will provide a multi-line editbox in which the Custom Function can be written. The custom function should be an anonymous function. The arguments passed to the function, and values which should be returned by the function, vary by animation type.


Alpha animations provide 3 arguments:



Date created
Nov 21, 2010