Easy Easer - A Perplexingly Simple Easing Class

Community Showcases
1

Intro

Hi all! I just finished a simple scripting tool for Unity which assists with easing values. I created it after becoming tired of writing repetitive boilerplate code just to lerp some values around. I thought I would post it here in case anyone else might also find it useful. Let me know what you think!

Easy Easer

A perplexingly simple easing class for Unity. Handles interpolation over a specified period of seconds for basic data types such as:

  • float
  • Vector3 & Quaternion
  • Color & Color32

It also supports interpolation of custom types by access of its Progress and CurveProgress properties.

Of course, an easer is no good without a handful of built-in curves.

  • Linear (default)
  • Smooth Step
  • Super Smooth Step
  • Cubic
  • Cubic Inverse
  • Cubic Uniform
  • Bounce
  • Elastic

And if that’s not enough, custom curves may be implemented with ease.

Partial Example

// Ease a float smoothly from 0 to 100 over a period of 5 seconds
private IEnumerator EaseFloat(float value)
{
	const float easeSeconds = 5f;
	Easer easer = new(easeSeconds);
	easer.Curve = Curves.SmoothStep;

	while (easer.IsEasing)
	{
		value = easer.EaseFloat(0, 100);
		yield return null;
	}
}

Full Example

using UnityEngine;
using System.Collections;
using EasyEaser;

public class Example : MonoBehaviour
{
	// Inspector
	public Vector3 DesiredPosition;
	public Color DesiredColor;
	public float EaseSeconds;

	// General
	private SpriteRenderer spriteRenderer;

	private void Start()
	{
		spriteRenderer = GetComponent<SpriteRenderer>();
		StartCoroutine(EaseSelf());
	}

	private IEnumerator EaseSelf()
	{
		// Get starting state
		Vector3 startPosition = transform.position;
		Color startColor = spriteRenderer.color;

		// Create an easer that lasts for some amount of seconds with a smooth curve
		Easer easer = new(EaseSeconds);
		easer.Curve = Curves.SmoothStep;

		// Ease until easer is finished
		while (easer.IsEasing)
		{
			transform.position = easer.EaseVector(startPosition, DesiredPosition);
			spriteRenderer.color = easer.EaseColor(startColor, DesiredColor);
			Debug.Log($"Linear Amount Eased: {easer.Progress}");
			Debug.Log($"Curved Amount Eased: {easer.CurveProgress}");
			yield return null;
		}
	}
}

Example Inspector
Example Inspector977×165 12.6 KB

Example Ease

Custom Curves

Any function with a float as the input and a float as the return value may be used as a custom curve.

float CustomCurve(float x)
{
	return x < 0.5f ? 4f * x * x * x : 1f - Mathf.Pow(-2f * x + 2f, 3f) / 2f;
}

Easer easer = new Easer(EaseSeconds);
easer.Curve = CustomCurve;
1 Like