Skip to content

limeandcoconut/Powertrain

Repository files navigation

Powertrain

A lightweight game loop written to prioritize updates and fill in with extra renders.

Updates will be called as accurately as possible while render operations will happen as often as possible. If, for some reason, lag has caused more than enough time for more than one update to occur they will be called sequentially until caught up. A render will always happen afterwards upates are done.

Testing and dev are done with babel.

import Powertrain from 'powertrain'

const engine = new Powertrain({
  playspeed: 1,     // optional, default = 1
  fps: 60,          // optional, default = 60
  update: () => {}, // optional, default = no-op
  render: () => {}, // optional, default = no-op
})

engine.start()
engine.stop()

Usage

NPM

constructor()

Name Type Attributes Default Description
obj.playSpeed number 1 A scalar for the speed of play.
obj.fps number 60 The target fraes per second. This is the number of updates per second that should occur. Not the number of renders.
obj.update function ()=>{} The function to update game logic.
obj.render function (scalar)=>{} The function to render the game. Accepts a scalar representing progress towards next frame. Can be used for interpolation.

start()

Starts update loop and sets running flag to true and calls for a requestAnimationFrame (provided by a crossplatform polyfill).

stop()

Sets running flag to false. This will stop the loop.

TODO:

Feedback ✉️

It is greatly appreciated! 🎉

Website 🌐

js@jacobsmith.tech

https://github.com/limeandcoconut

@limeandcoconut 🐦

Cheers!

License

ISC, see LICENSE.md for details.

About

A lightweight es6 game loop written to prioritize updates and fill in with extra renders.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published