Technology moves fast! ⚡ Don't get left behind.🚶 Subscribe to our mailing list to keep up with latest and greatest in open source projects! 🏆


Subscribe to our mailing list

mojs-player

Player controls for `mojs` animations.

Subscribe to updates I use mojs-player


Statistics on mojs-player

Number of watchers on Github 174
Number of open issues 3
Average time to close an issue 1 day
Main language JavaScript
Average time to merge a PR 2 days
Open pull requests 2+
Closed pull requests 0+
Last commit about 2 years ago
Repo Created almost 3 years ago
Repo Last Updated about 1 year ago
Size 10.6 MB
Homepage http://mojs.io
Organization / Authorlegomushroom
Latest Release0.43.16
Contributors2
Page Updated
Do you use mojs-player? Leave a review!
View open issues (3)
View mojs-player activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating mojs-player for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)

mojs-player

mojs-player

Player controls for mojs. Intended to help you to craft mojs animation sequences. To be clear, this player is not needed to play mojs animations. It is just a debug tool that gives you the ability to:

  • control your sequences with GUI while working on them
  • it saves the current progress of your animation thus you don't loose the focus
  • it gives you bounds to constrain focus point of your animation
  • it gives you the control over the speed of animation
  • it gives you the ability to seek animations freely
  • it saves player's state and settings thus they not get lost when page reloaded

Installation

The MojsPlayer depends on mojs >= 0.225.2 so make sure you link it first.

CDN:

<script src="//cdn.jsdelivr.net/mojs-player/latest/mojs-player.min.js"></script>

NPM:

[sudo] npm install mojs-player

Bower:

bower install mojs-player

Import MojsPlayer constructor to your code (depends on your environment) :

const MojsPlayer = require('mojs-player').default;
// or
import MojsPlayer from 'mojs-player';

If you installed it with script link you should have MojsPlayer global.

Usage

Construct MojsPlayer and pass your main Tween/Timeline as the add option:

// const mainTimeline = new mojs.Timeline({});
// .. some code regarding timeline ..
const mojsPlayer = new MojsPlayer({ add: mainTimeline });

The add option is the only required option to launch. Player's controls should appear at the bottom of the page.

You can also set other player initial state:

// ..
const mojsPlayer = new MojsPlayer({
  // required
  add:      mainTimeline,
  // optionally
  className:    '',         // class name to add to main HTMLElement
  isSaveState:  true,       // determines if should preserve state on page reload
  isPlaying:    false,      // playback state
  progress:     0,          // initial progress
  isRepeat:     false,      // determines if it should repeat after completion
  isBounds:     false,      // determines if it should have bounds
  leftBound:    0,          // left bound position  [0...1]
  rightBound:   1,          // right bound position [0...1]
  isSpeed:      false,      // determines if speed control should be open
  speed:        1,          // `speed` value
  isHidden:     false,      // determines if the player should be hidden
  precision:    0.1,        // step size for player handle - for instance, after page reload - player should restore timeline progress - the whole timeline will be updated incrementally with the `precision` step size until the progress will be met.
  name:         'mojs-player', // name for the player - mainly used for localstorage identifier, use to distinguish between multiple local players
  onToggleHide(isHidden) {  // should be called after user taps on the hide-button (isHidden is a boolean, indicating the visibility state of the player)
    if (isHidden) {
      // do something when player is invisible
    } else {
      // do something when player is visible
    }
  }
});

Shortcuts

  • alt + p - toggle play/pause playback state
  • alt + - - decrease progress by 1/100
  • alt + + - increase progress by 1/100
  • shift + alt + - - decrease progress by 1/10
  • shift + alt + + - increase progress by 1/10
  • alt + s - stop playback
  • alt + r - toggle repeat state
  • alt + b - toggle bounds state
  • alt + h - toggle show/hide player state
  • alt + q - reset speed to 1x
  • alt + 2 - decrease speed by 1/50
  • alt + 3 - increase speed by 1/50
  • shift + alt + 2 - decrease speed by 1/10
  • shift + alt + 3 - increase speed by 1/10

Development

Install webpack globally:

[sudo] npm install webpack -g

Install dependencies with npm:

[sudo] npm install

Run webpack:

webpack

Please make sure you are on the dev branch before making changes.

License

(The MIT License)

Copyright (c) Oleg Solomka @LegoMushroom legomushroom@gmail.com

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

mojs-player open pull requests (View All Pulls)
  • mojs-player: add onToggleHide callback as an option; readme: add new …
  • Update jsDelivr link
mojs-player list of languages used
Other projects in JavaScript