SetEntityAnimationWeight

SetEntityAnimationWeight()

Syntax

SetEntityAnimationWeight(#Entity, Animation$, Weight)

Description

Changes the #Entity animation weight. The weight is useful when playing several animations at once. For example to do a smooth transition from one animation to another, it is possible to reduce progressively the weight of the first animation and increase the weight of the second animation.

Parameters

#Entity The entity to use.

Animation$ The animation name. The animations are stored in the mesh object in a case-sensitive manner (ie: "Walk" will be a different animation than "walk"). If the animation isn't found or the mesh doesn't have a skeleton, this function will have no effect.

Weight The new entity animation weight (value between 0.0 and 1.0). If the weight is 0, then the animation has no effect. If the weight is 1, then animation is fully playing.

Return value

None.

Remarks

The EntityAnimationBlendMode() also affects how animations are mixed.

See Also

StartEntityAnimation(), EntityAnimationBlendMode()

Supported OS

All

<- SetEntityAnimationTime() - EntityAnimation Index - StartEntityAnimation() ->

#Entity	The entity to use.
Animation$	The animation name. The animations are stored in the mesh object in a case-sensitive manner (ie: "Walk" will be a different animation than "walk"). If the animation isn't found or the mesh doesn't have a skeleton, this function will have no effect.
Weight	The new entity animation weight (value between 0.0 and 1.0). If the weight is 0, then the animation has no effect. If the weight is 1, then animation is fully playing.