dropecho.easings

A library of easings (linear transformations).
https://github.com/dropecho/easings/

To install, run:

haxelib install dropecho.easings 1.0.0 

See using Haxelib in Haxelib documentation for more information.

README.md

dropecho.easings

A small Haxe library of easing functions (linear transformations) and interpolation helpers for games and animation. Compiles to JavaScript and C#.

Install

haxelib install dropecho.easings   # Haxe
npm install @dropecho/easings      # JavaScript

Usage

Easing functions take a normalized time t in [0, 1] and return the eased value, also in [0, 1].

Haxe

import dropecho.Easings;

Easings.easeInQuad(0.25);                  // 0.0625
Easings.easeOutCubic(0.25);                // 0.578125
Easings.smoothStep(0.5);                   // 0.5
Easings.mix(0, 100, 0.25);                 // 25   (lerp is an alias)
Easings.rangeMap(0.25, 0, 1, 0, 255);      // 63.75
Easings.rangeMapClamped(5, 0, 1, 0, 255);  // 255  (input clamped to the in-range)
Easings.clamp(value, 0, 1);

JavaScript

The library is exposed as the easings object (CommonJS export, or a global in the browser).

const { easings } = require("@dropecho/easings");

easings.easeInQuad(0.25); // 0.0625
easings.smoothStep(0.5);  // 0.5

API

GroupFunctions
Range / interpolationclamp, rangeMap, rangeMapClamped, mix, lerp
Ease in (accelerate from 0)easeInQuad, easeInCubic, easeInQuart, easeInQuint, easeInSine
Ease out (decelerate to 1)easeOutQuad, easeOutCubic, easeOutQuart, easeOutQuint
Composite / miscsmoothStep, scale
  • rangeMap extrapolates outside the in-range; rangeMapClamped pins the result to the out-range and handles inverted in-ranges (inMin > inMax).
  • scale(t, easing) returns t · easing(t), a cheap way to sharpen an ease.

Development

npm run build   # build JS + C#
npm test        # run the utest suite (via dropecho.testing)
npm run bench   # run the benchmarks

License

MIT

Contributors
vantreeseba
Version
1.0.0
Published
4 months ago
Dependencies
License
MIT

All libraries are free

Every month, more than a thousand developers use Haxelib to find, share, and reuse code — and assemble it in powerful new ways. Enjoy Haxe; It is great!

Explore Haxe

Haxe Manual

Haxe Code Cookbook

Haxe API documentation

You can try Haxe in the browser! try.haxe.org

Join us on GitHub!

Haxe is being developed on GitHub. Feel free to contribute or report issues to our projects.

Haxe on GitHub

⌂