Animation Inherits from Behaviour, IEnumerable
The animation component is used to play back animations.
You can assign animation clips to the animation component and control playback from your script. The animation system in Unity is weight based and supports: Animation Blending, Additive animations, Animation Mixing, Layers and full control over all aspects of animation playback.
For an overview of animation scripting in Unity please read this introduction.
To play a simple animation use Animation.Play
To cross-fade between animations use Animation.CrossFade
To change how animations wrap (Loop, Once, PingPong) change the WrapMode of the respective AnimationClips in their import settings, or use AnimationState.wrapMode to change it at runtime.
AnimationState can be used to change the layer of an animation, modify playback speed, and for direct control over blending and mixing.
Animation also supports enumerators so you can loop through all AnimationStates like this:
using UnityEngine;
using System.Collections;
public class example :
MonoBehaviour {
void Awake() {
foreach (
AnimationState state
in animation) {
state.speed = 0.5F;
}
}
}
import UnityEngine
import System.Collections
class example(
MonoBehaviour):
def
Awake():
for state as
AnimationState in animation:
state.speed = 0.5F
See Also: An overview of animation scripting in Unity is
here.
Variables
|
clip
|
The default animation.
|
|
playAutomatically
|
Should the default animation clip (Animation.clip) automatically start playing on startup.
|
|
wrapMode
|
How should time beyond the playback range of the clip be treated?
|
|
isPlaying
|
Are we playing any animations?
|
|
this [string name]
|
Returns the animation state named name.
|
|
animatePhysics
|
When turned on, animations will be executed in the physics loop. This is only useful in conjunction with kinematic rigidbodies.
|
|
animateOnlyIfVisible
|
When turned on, Unity might stop animating if it thinks that the results of the animation won't be visible to the user.
|
Functions
|
Stop
|
Stops all playing animations that were started with this Animation.
|
|
Rewind
|
Rewinds the animation named name.
|
|
Sample
|
Samples animations at the current state.
|
|
IsPlaying
|
Is the animation named name playing?
|
|
Play
|
Plays animation without any blending.
|
|
CrossFade
|
Fades the animation with name animation in over a period of time seconds and fades other animations out.
|
|
Blend
|
Blends the animation named animation towards targetWeight over the next time seconds.
|
|
CrossFadeQueued
|
Cross fades an animation after previous animations has finished playing.
|
|
PlayQueued
|
Plays an animation after previous animations has finished playing.
|
|
AddClip
|
Adds a clip to the animation with name newName.
|
|
RemoveClip
|
Remove clip from the animation list.
|
|
GetClipCount
|
Get the number of clips currently assigned to this animation
|
|
SyncLayer
|
Synchronizes playback speed of all animations in the layer.
|
Inherited members
Inherited Variables
Inherited Functions
Inherited Class Functions
|
operator bool
|
Does the object exist?
|
|
Instantiate
|
Clones the object original and returns the clone.
|
|
Destroy
|
Removes a gameobject, component or asset.
|
|
DestroyImmediate
|
Destroys the object obj immediately. It is strongly recommended to use Destroy instead.
|
|
FindObjectsOfType
|
Returns a list of all active loaded objects of Type type.
|
|
FindObjectOfType
|
Returns the first active loaded object of Type type.
|
|
operator ==
|
Compares if two objects refer to the same
|
|
operator !=
|
Compares if two objects refer to a different object
|
|
DontDestroyOnLoad
|
Makes the object target not be destroyed automatically when loading a new scene.
|