simple-physics-engine

Simple Physics Engine

A library containing algorithms & abstract classes for building animations/games, regardless of the platform.

This package is currently being developed and is not finished or tested.

Example Usage

Using the physics engine and adding a Bird character

import { AbstractPhysics, RigidBody } from 'simple-physics-engine'

class Bird extends RigidBody {
  constructor(pos, options) {
    super(pos, options)
    // other constructor logic
  }

  // other extensions
}

class Physics extends AbstractPhysics {
  // implement abstract init() method
  function init() {
    addCharacter(bird)
    // other init logic
  }

  // implement abstract update() method
  function update(dt) {
    // your update logic
  }

  // other extensions
}

Supported Algorithms

Search

• A* Search
• Uniform Cost Search (Dijkstra's Algorithm)
• Probabilistic Roadmap (PRM) Generation

Supported Classes

Math

• Vector

Global Logic

• Physics (Abstract Class)

Objects

All of these objects are abstract classes and are meant to be inherited from. For example, you could create a "Car" class by inheriting from "Agent"

Object Hierarchy

TODO: Add picture of hierarchy

Object Reference

Name	Description
Spatial	Root of all objects, just holds a position
CollisionObject	Base collision object, holds some type of extent to check for collisions
StaticBody	An extension of CollisionObject that is incapable of moving
RigidBody	An extension of CollisionObject that supports movement and can receive forces
Agent	An extension of RigidBody that holds a goal and a path towards that goal

TODO

• Write Particle and ParticleSystem classes
• Make sure BoundingSphere collision detection is robust, add bounce handling if time
• Implement kd-tree to make collision detection quicker
• Write abstract Camera class?