game-loops
v1.1.0
Published
Several kinds of game loop
Downloads
15
Maintainers
Readme
Game Loops
Various implementations of game loops. Most of which I have implemented at one time or another. I grow weary of rewriting this code. Here it is for viewing or usage. There are tests too. If you want detail explanation on why you may want one over another read Fix your timestep by Glenn Fielder.
- fixed delta time
- variable delta time
- semi fixed timestep
- fixed timestep
- fixed timestep with remainder
Creating a loop
import {
createFixedDeltaTime,
createVariableDeltaTime,
createSemiFixedTimestep,
createFixedTimeStep,
createFixedTimeStepWithRemainder
} from 'game-loops';
const ms = 1000 / 60;
const onFrame = (Δ, t) => { ... };
const onRemainder = (Δ, t) => { ... };
const isPaused = () => false;
const fixedDeltaTime = createFixedDeltaTime(ms, isPaused, onFrame);
const variableDeltaTime = createVariableDeltaTime(isPaused, onFrame);
const semiFixedTimeStep = createSemiFixedTimestep(ms, isPaused, onFrame);
const fixedTimeStep = createFixedTimeStep(ms, isPaused, onFrame);
const withRemainder = createFixedTimeStepWithRemainder(ms, isPaused, onFrame, onRemainder);
Hooking it into a scheduler
setInterval(fixedDeltaTime, 1000 / 60);
setInterval(variableDeltaTime, 1000 / 60);
setInterval(semiFixedTimeStep, 1000 / 60);
setInterval(fixedTimeStep, 1000 / 60);
setInterval(withRemainder, 1000 / 60);
or you can call it on demand
fixedDeltaTime();
variableDeltaTime();
semiFixedTimeStep();
fixedTimeStep();
withRemainder();
Common behaviour
- They all accept a function that should return true if paused and false if not paused. No callbacks are executed when paused.
- All callbacks receive the delta as the first parameter
- All callbacks receive the elapsed game time as the second parameter.
fixed delta time
Calls your function with a fixed time delta everytime you invoke it. You could probably just do this yourself.
variable delta time
Calculates time between invocations and uses that as the delta.
semi fixed timestep
As variable but caps it at a delta you define.
fixed timestep
Set the timestep to some number of milliseconds. Say 1000/60 for 60 frames per second. This means that the callback will always receive the timestep specified on frame. Will call your function frameDelta / ms
times
Accepts an optional final parameter to limit the frameDelta to some number of ms.
const fixedTimeStep = createFixedTimeStep(ms, isPaused, onFrame, maxMS);
fixed timestep with remainder
Like fixed timestep but your onRemainder
function is called with the remainder of ms. You can determine how far through a frame you are to render the world. It's up to you. Will call your function frameDelta / ms
times.
Accepts an optional final parameter to limit the frameDelta to some number of ms.
const withRemainder = createFixedTimeStepWithRemainder(ms, isPaused, onFrame, onRemainder, maxMS);