• A State contains the current information about an animation such as its Time and Speed.
• A Transition contains serializable data which defines how to create and play a state such as its AnimationClip and the fade duration used to blend into it.

Each of the State types that are included in Animancer has its own Transition Type which contains various details relevant to it so that when it's passed into AnimancerComponent.Play(ITransition) it will create that type of state. For example, a ClipTransition will create a ClipState to play a single AnimationClip:

using Animancer;
using UnityEngine;

public class TransitionExample : MonoBehaviour
{
    [SerializeField]
    private AnimancerComponent _Animancer;

    [SerializeField] 
    private ClipTransition _Animation;

    protected virtual void OnEnable()
    {
        _Animancer.Play(_Animation);
    }
}

The Transitions sample demonstrates how to use them in more detail.

Fields

The following table describes the fields in a ClipTransition. See the Transition Types page for details about the other types.

Name	Code	Inspector
Animation	Clip
The AnimationClip to play. This field only exists on ClipTransitions. Other Transition Types have other kinds of fields. The name displayed here is actually determined by the transition field (_Animation in the example above). The icon on the right allows you to Preview the transition.
Fade Duration	FadeDuration
The amount of time that the transition will take to Cross Fade from the previous animation to the new one. This value can't be negative and setting it to 0 will cause the animation to Play Instantly. This Time Field is always serialized as seconds, regardless of which field you use to enter the value.
Speed	Speed
How fast the animation will play as a multiple of its regular speed. Negative values cause it to play backwards (so you would likely want to set the Start Time to 1x to play it backwards from the end).
Start Time	NormalizedStartTime
If enabled, the animation time will immediately jump to this value when played. Otherwise it will display a default value: 0x for positive speed or 1x for negative speed. If the animation is inactive (AnimancerNode.Weight == 0) when you start the transition its time will start at that default value, but if the animation is active it will instead continue playing from its current time. This Time Field is always serialized as normalized time, regardless of which field you use to enter the value.
End Time	Events.NormalizedEndTime
If enabled, this value determines when the End Event will occur. It does not affect the animation playback in any way other than to trigger that event. This Time Field is always serialized as normalized time, regardless of which field you use to enter the value.
Events	Events
The timeline visualises the transition details: The labels show important times (in seconds, rounded off). The blue highlighted area represents the fading in and out. Note that transitions only define the way they fade in so the displayed fade out is simply a default value. The actual fade out will be determined by the way the next transition fades in. The grey bar down the bottom represents the actual length of the animation in case the End Time is not 1x. The button on the right adds an Animancer Event which will also be shown in this area.

Time Fields

Several of the above fields use Units Attributes to display a single time value using several fields to represent different units of measurement.

• Entering values in these fields works like any other number field. You simply type a number without the suffix.
• If the field has a toggle, disabling it will set the underlying value to float.NaN which has different effects depending on the field (as explained in the Fields table and in the tooltip).
• The Fields table also specifies which units the underlying value is actually stored as.
• The AnimancerSettings asset has options to disable any of the fields you don't want. For example, measuring values in "Frames" can be very useful for Sprite based animations, but is often less useful for bone based animations.

Approximations

Since the Time Fields only have limited screen space to work with, they often end up being unable to fit the entire value which can lead to confusion. To fix this, these fields will automatically abbreviate their values to fit in the available area and use a ~ symbol to indicate when the displayed value is only an approximation of the actual value. For example, all of the following values would normally look identical to 1.234568 if there wasn't enough room to see the rest of the text.

This feature can be disabled in the AnimancerSettings.

Default Values

Middle Clicking on any of the Time Fields will set it to its default value. Or if it was already at that value, doing so will set it to its secondary default value.