GUI for live easing/property curves editing.
MojsCurveEditor is a GUI plugin for interactive custom easings and property curves editing while crafting your animations. It is part of mojs tools.
The MojsCurveEditor depends on mojs >= 0.225.2, tween autoupdates available for mojs >= 0.276.2. Please make sure you've linked mojs library first.
# npm
npm install @mojs/curve-editor
# cdn
<script src="https://cdn.jsdelivr.net/npm/@mojs/curve-editor"></script>Import MojsCurveEditor constructor inside your code, depending on your environment:
const MojsCurveEditor = require('mojs-curve-editor').default;
// or
import MojsCurveEditor from '@mojs/curve-editor';If you installed it with script link - you should have
MojsCurveEditorglobal
Construct MojsCurveEditor with the next options:
const mojsCurve = new MojsCurveEditor({
// name of the Curve you are working on. The name is used to
// identify record in `localStorage` to restore the state from
// when page gets reloaded, so please specify unique names if
// you use more than one editor on the same page.
name: 'bounce curve'
});After that you can "connect" the curve with your mojs modules by passing a "sample" of the curve to the easing property of the module, like this:
const mojsCurve = new MojsCurveEditor();
const tween = new mojs.Tween({
easing: mojsCurve.getEasing()
});
// or
const shape = new mojs.Shape({
easing: mojsCurve.getEasing()
});
// or as `property curve`
const html = new mojs.Html({
el: '#js-el',
x: {
0: 100,
curve: mojsCurve.getEasing()
}
});Each tween/module should have it's out sample of the curve, this means you need to call mojsCurve.getEasing() send the sample of the curve to the easing property of modules.
If you use mojs>0.276.5 the state of the modules with the curve sample will be updated automatically.
The getEasing function receives options hash:
easing: mojsCurve.getEasing({
// `transform` function that pipes through the current value
// of the curve so you can transform it
transform: (k) => { return k; }
});After you are happy with the curve you made, you need to change the sample, mojsCurve.getEasing() calls, with the actual path data that you can get by clicking on the code button 
:
const html = new mojs.Html({
el: '#js-el',
x: {
0: 100,
easing: 'M0, 100 L100, 0'
}
});Constructor accepts the next options:
const curveEditor = new MojsCurveEditor({
// name of the curve editor
name: 'bounce curve'
// if should preserve state on page reloads
isSaveState: true,
// start path - will be loaded on initialization of the curve,
// e.g. before any user modifications were made. Path of 'M0, 100 L100, 0' is set by default.
startPath: 'M0, 100 L100, 0',
// callback on path change, accepts path string
onChange: function (path) {},
// if should hide when minimized - useful when you try to embed
isHiddenOnMin: false
});curveEditor
// get `easing function` of the curve
.getEasing()
// maximize the curve editor
.maximize()
// minimize the curve editor
.minimize()
// toggle `maximize/minimize` methods regarding editor's state
.toggleSize();alt + z-undocurve actionalt + x-redocurve actionalt + d-deleteselected point(s)- [3 times]
alt + \-resetcurve
All shortcuts work only for active editor - it should have orange mojs logo indicator at bottom left.
Install webpack globally:
[sudo] npm install webpack -g
Install dependencies with npm:
[sudo] npm install
Run webpack:
webpack
Please make sure you started a feature branch with the feature name (better from the dev branch) before making changes.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent