Animify

Animate your console with Strings!

Get Started

Section | Quick Descripton ------------ | ------------- Install | How to Install. Import | How to import into a Project Create Object | How to create an animation Object. Add Frames | How to add Frames. Animate | How to animate the Frames. onStart Callback | Add a callback when animation Starts. onFinish Callback | Add a callback when animation Ends.

Install

To install Animify in your project you need to input the following in your console.

npm install animify

or

npm i animify

Import

To import Animify in your project you need to add the following code to your project

const animify = require('animify');

Create Object

To start using Animify you need to create an animation Object. Which is declared like :

const myAnimationObject = new animify();

There is a configuration you can add, even tho It is OPTIONAL. and you can add like :

const myAnimationObject = new animify({
    fps: 30 // default: 30
});

Add Frames

To add frames into your animation object you need to use the addFrame method. which can take a string or an array with multiple strings.

Single String

myAnimationObject.addFrame('[ ----- ]');

Array

myAnimationObject.addFrame([
    '[ ----- ]',
    '[ --|-- ]',
    '[ --/-- ]'
]);

Animate

To bring the life to your console you need to use the animate method. and takes the frame to start from (usually 0).

Normal

myAnimationObject.animate(0);

Async

myAnimationObject.animate(0).then((res) => {
    console.log(`Printed ${res.frames.printed} with ${res.timeout} ms. delay between Images.`);
});

onStart Callback

To add a callback when the animation is started you need to use the onStart method. Which takes a function.

myAnimationObject.onStart(() => {
    // Code Here
});

onFinish Callback

To add a callback when the animation is started you need to use the onFinish method. Which takes a function.

myAnimationObject.onFinish(() => {
    // Code Here
});

Licensed under the MIT License