Curve

Curve in Math

In One Line

Tweening? LUT? Native? All in the Curve.

Package Info

display name	AceLand Curve
package name	com.aceland.curve
latest version	1.0.0
namespace	AceLand.Curve
git repository	https://github.com/parsue/com.aceland.curve.git
dependencies	com.unity.mathematics: 1.3.2

---

Overview

Easing curves map a normalized time parameter t ∈ [0,1] to a smoothed progression y ∈ [0,1]. They are commonly used for animations, UI transitions, and value interpolation where non-linear motion feels more natural.

This package provides:

• A comprehensive EasingCurve enum of classic easing functions (Sine, Quad, Cubic, Quart, Quint, Expo, Circ, Back, Elastic, Bounce) with In/Out/InOut variants and Linear.

• A loop/wrap system via LoopMode (Once, Clamp, Loop, PingPong) to control how t is mapped before easing.

• Extension methods to evaluate curves efficiently in Unity.

• Optional conversion to DOTween’s Ease enum (if DOTWEEN scripting define is present).

---

Usage

Basic interpolation

float duration = 0.5f;
float timer = 0f;
Vector3 start = Vector3.zero, end = Vector3.one;
EasingCurve curve = EasingCurve.InOutCubic;

void Update() {
    if (timer < duration) {
        timer += Time.deltaTime;
        float t = timer / duration; // 0..1
        float eased = curve.Evaluate(t); // default: Clamp
        transform.position = Vector3.LerpUnclamped(start, end, eased);
    }
}

Looping and ping-pong

EasingCurve curve = EasingCurve.OutSine;

// Continuous looping
float t = Time.time / period; // can grow without bound
float easedLoop = curve.Evaluate(t, LoopMode.Loop);

// Ping-pong motion
float easedPingPong = curve.Evaluate(Time.time, LoopMode.PingPong);

Manual time control

// Using Once allows raw t flow; Evaluate will keep values stable around edge cases.
EasingCurve curve = EasingCurve.InOutSine;
float t = someRawValue; // might be outside [0,1]
float eased = EasingCurve.OutExpo.Evaluate(t, LoopMode.Once);

---

Loop Mode

Enum CurveLoopMode contains 4 states.

State	Description
Once	no wrapping; intended for manual control. For numerical safety, values are clamped internally around the easing functions.
Clamp	clamps t into [0,1]. This matches the default behavior of Evaluate(t).
Loop	wraps t to [0,1) repeating.
PingPong	bounces t between 0 and 1.

---

Bake LUT

For high-throughput systems (Burst jobs, particle systems, GPU shaders), it’s often faster to precompute a lookup table (LUT) of an easing curve and then sample it at runtime. Below are reference implementations for:

• CPU-side LUT generation (Burst-friendly)

• Passing LUT to a shader as a 1D texture

• Sampling LUT in C# Jobs

LUT Texture

using AceLand.Curve

// get the baker
IEasingCurveBaker baker = AceCurve.Baker;

// bake a lut 2d texture
EasingCurve curve = EasingCurve.InOutQuart;
Texture2D lutTex2D = baker.BuildLutTexture(
    curve: curve,
    lutSize: 128,
    loopMode: CurveLoopMode.Clamp, // default
    linear: true    // default
);

// bake a lut texture with max 4 channels
// set null to the curve channel for ignore the channel.
EasingCurve curveX = EasingCurve.InOutQuart;
EasingCurve curveY = EasingCurve.OutCubic;
EasingCurve curveZ = EasingCurve.InSine;
EasingCurve curveW = EasingCurve.OutBack;
Texture2D lutTex = baker.BuildLutTexture(
    curveX: curveX,
    curveY : curveY,
    curveZ : curveZ,
    curveW : curveW,
    lutSize: 128,
    loopMode: CurveLoopMode.Clamp, // default
    linear: true    // default
);

LUT NativeArray

Shader Graph

Work with AnimationCurve

using AceLand.Curve;
using UnityEngine;

IEasingCurveBaker baker = AceCurve.Baker;

// set LoopMode in keyframe of AnimationCurve
AnimationCurve animationCurve;

Texture2D lutTex2D = baker.BuildLutTexture(
    curve: animationCurve,
    lutSize: 128,
    linear: true    // default
);

---

With DOTween

If you use DOTween and define DOTWEEN in Scripting Define Symbols:

using DG.Tweening;

Ease ease = EasingCurve.InOutBack.ToDoTweenEase();
transform.DOMove(target, 1f).SetEase(ease);

---