# CrossFade(string, float, PlayMode)

> Fades in the animation with the name animation over a period of time defined by fadeLength.

## Definition

* **Type:** Method
* **Namespace:** [UnityEngine](/engine/6000.5/script-reference/unityengine.md)
* **Assembly:** UnityEngine.AnimationModule

```csharp
public void CrossFade(string animation, float fadeLength, PlayMode mode)
```

### Parameters

**** (\[string]\(https\://learn.microsoft.com/dotnet/api/system.string)): The name of the animation in the `Animation` component to crossfade to.**** (\[float]\(https\://learn.microsoft.com/dotnet/api/system.single)): The duration of the crossfade in seconds. Negative values are clamped to 0 seconds.**** (\[PlayMode]\(/engine/6000.5/script-reference/unityengine/playmode)): The layer behavior of the crossfade. This controls whether the crossfade is with animations on all layers or animations on the same later as `animation`.

### Remarks

If the mode is set to [PlayMode.StopSameLayer](/engine/6000.5/script-reference/unityengine/playmode/stopsamelayer.md), animations on the same layer as `animation` are faded out while `animation` is faded in. if the mode is set to [PlayMode.StopAll](/engine/6000.5/script-reference/unityengine/playmode/stopall.md), all animations are faded out while `animation` is faded in.

If the animation is not set to be looping, it will be stopped and rewound after playing.

The following example demonstrates how to switch between two animations using the CrossFade method.

```csharp
using UnityEngine;

[RequireComponent(typeof(Animation))]
public class AnimationCrossFadeExample : MonoBehaviour
{
    public bool IsRunning = false;
    Animation m_Animation;

    void Start()
    {
        m_Animation = GetComponent<Animation>();

        if (m_Animation.GetClip("walk") == null)
            Debug.LogError("Missing walk clip");

        if (m_Animation.GetClip("run") == null)
            Debug.LogError("Missing run clip");

        m_Animation.Play("walk");
    }

    void Update()
    {
        if (Input.GetKeyDown(KeyCode.Space))
        {
            IsRunning = !IsRunning;
            m_Animation.CrossFade(IsRunning ? "run" : "walk", .5f);
        }
    }
}
```

Additional Resources: [Animation.Play](/engine/6000.5/script-reference/unityengine/animation/play.md), [PlayMode](/engine/6000.5/script-reference/unityengine/playmode.md).