AnimationInstanceWeight Property |
Namespace: DigitalRune.Animation
Exception | Condition |
---|---|
ArgumentOutOfRangeException | value is negative or greater than 1. |
The animation weight defines the intensity of the animation. It is a factor that is applied to the animation output. The animation weight is in particular relevant when multiple animations should be combined. Each animation combines its output with the output of the previous stage in the animation composition chain. (If the animation is the first animation of a composition chain it combines its value with the base value of the property that is being animated.)
The default value is 1 which means that 100% of the animation is returned, overriding any previous stage in a animation composition chain. A value of 0.75 means that result is weighted combination of the previous stage (25%) and the output of the current animation (75%). A value of 0 basically disables the output of the current animation.
Changing the animation weight of an instance affects the entire subtree: the current animation instance and all children. The effective animation weight is the product of all weights from the root node to the current animation instance.