# Gradient

> Represents a Gradient used for animating colors.

## Definition

* **Type:** Class
* **Namespace:** [UnityEngine](/engine/6000.0/script-reference/unityengine.md)
* **Assembly:** UnityEngine.CoreModule
* **Implements:** [IEquatable\<Gradient>](https://learn.microsoft.com/dotnet/api/system.iequatable-1)

```csharp
public class Gradient : IEquatable<Gradient>
```

## Remarks

Gradients allow animating or interpolating colors by having several "color keys" and "alpha keys". Color keys and alpha keys are separate, and each key has a time specified for it, ranging from 0.0 (0%) to 1.0 (100%). Note that the alpha and colors keys will be automatically sorted by time value and that it is ensured to always have a minimum of 2 color keys and 2 alpha keys.

How the colors are interpolated between the keys is controlled by [GradientMode](/engine/6000.0/script-reference/unityengine/gradientmode.md).

Public Gradient variables used in scripts automatically display the gradient editor in the inspector window. [GradientUsageAttribute](/engine/6000.0/script-reference/unityengine/gradientusageattribute.md) allows specifying whether the gradient colors should be high dynamic range for editing.

```csharp
using UnityEngine;

public class ExampleScript : MonoBehaviour
{
    void Start()
    {
        var gradient = new Gradient();

        // Blend color from red at 0% to blue at 100%
        var colors = new GradientColorKey[2];
        colors[0] = new GradientColorKey(Color.red, 0.0f);
        colors[1] = new GradientColorKey(Color.blue, 1.0f);

        // Blend alpha from opaque at 0% to transparent at 100%
        var alphas = new GradientAlphaKey[2];
        alphas[0] = new GradientAlphaKey(1.0f, 0.0f);
        alphas[1] = new GradientAlphaKey(0.0f, 1.0f);

        gradient.SetKeys(colors, alphas);

        // What's the color at the relative time 0.25 (25%) ?
        Debug.Log(gradient.Evaluate(0.25f));
    }
}
```

Additional Resources: [GradientColorKey](/engine/6000.0/script-reference/unityengine/gradientcolorkey.md), [GradientAlphaKey](/engine/6000.0/script-reference/unityengine/gradientalphakey.md), [SerializedProperty.gradientValue](/engine/6000.0/script-reference/unityeditor/serializedproperty/gradientvalue.md).

## Constructors

| Constructor                                                                | Description                   |
| -------------------------------------------------------------------------- | ----------------------------- |
| [Gradient()](/engine/6000.0/script-reference/unityengine/gradient/ctor.md) | Create a new Gradient object. |

## Properties

| Property                                                                         | Description                                                       |
| -------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| [alphaKeys](/engine/6000.0/script-reference/unityengine/gradient/alphakeys.md)   | All alpha keys defined in the gradient.                           |
| [colorKeys](/engine/6000.0/script-reference/unityengine/gradient/colorkeys.md)   | All color keys defined in the gradient.                           |
| [colorSpace](/engine/6000.0/script-reference/unityengine/gradient/colorspace.md) | Indicates the color space that the gradient color keys are using. |
| [mode](/engine/6000.0/script-reference/unityengine/gradient/mode.md)             | Controls how the gradient colors are interpolated.                |

## Methods

| Method                                                                       | Description                                                |
| ---------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [Evaluate](/engine/6000.0/script-reference/unityengine/gradient/evaluate.md) | Calculate color at a given time.                           |
| [SetKeys](/engine/6000.0/script-reference/unityengine/gradient/setkeys.md)   | Setup Gradient with an array of color keys and alpha keys. |