FYSX
The Extensible 2D Physics Library for the Web & Node.
import * as FYSX from 'fysx';
// Create a world
const world = new FYSX.World();
// Enable the world border and set it's size
world.hasBorders = true;
world.width = 800;
world.height = 600;
// Populate the world with randomly positioned bodies
const size = new FYSX.Vec2(50, 50);
for (let i = 0; i < 50; i++) {
const pos = new FYSX.Vec2(
(world.width - size.x) * Math.random(),
(world.height - size.y) * Math.random()
);
const body = FYSX.createRectangleBody(pos, size);
world.addBody(body);
}
// Simulate the world for a bit
for (let i = 0; i < 100; i++) {
world.frame();
}Install
npm i fysx
Getting Started
Check out the examples in the examples folder.
Overview
FYSX's physics algorithm is based on Verlet integration.
Vertex
A Vertex is a single particle in space. It has a position and a previous position (which is used to calculate it's velocity).
Constraint
A Constraint is a "connection" between one or more vertices. They come in different types. They usually apply a force to one or more of the "connected" vertices depending on their current state.
Types of constraints:
- Distance Constraint: Tries to keep two vertices at a constant distance for each other by pushing/pulling them towards/from one another.
- Leash Constraint: Force one vertex to stay within a radius of the other vertex by pulling the vertex inside the radius when it's outside.
- Pin Constraint: Pins a vertex to a point in space. The vertex is forced to stay at that point at all times.
Edge
An Edge is a "solid" line between two vertices. Edges and vertices are the only things that can collide with each other (a collision is always between an edge and a vertex).
Body
Body is a group of vertices, constraints and edges.
World
A World is where all the vertices, constraints, edges and bodies live. Only physical objects in the same world can interact with each other.