foster/liabru-matter-js
0
0
Fork 0
mirror of https://github.com/liabru/matter-js.git synced 2024-11-23 09:26:51 -05:00
Code Issues Wiki Activity
A 2D rigid body physics engine for the web.
561 commits 9 branches 23 tags 24 MiB
JavaScript 100%
Find a file
liabru 5a12f56067 release 0.11.0
2016-11-04 00:34:17 +00:00
build release 0.11.0 2016-11-04 00:34:17 +00:00
demo fix gravity reset in demo 2016-09-19 23:01:49 +01:00
examples fix tests 2016-11-04 00:04:56 +00:00
src improve docs 2016-11-03 23:35:00 +00:00
test fix tests 2016-11-04 00:04:56 +00:00
.eslintrc migrated from grunt to gulp, jshint to eslint 2015-11-29 14:27:38 +00:00
.gitignore remove and ignore all test refs 2016-11-03 23:34:16 +00:00
.travis.yml change travis node version to latest stable 2016-09-21 21:12:12 +01:00
bower.json release 0.11.0 2016-11-04 00:34:17 +00:00
CHANGELOG.md release 0.11.0 2016-11-04 00:34:17 +00:00
CONTRIBUTING.md updated contributing notes 2016-01-16 20:57:05 +00:00
Gulpfile.js fix release tasks 2016-11-04 00:19:52 +00:00
LICENSE initial commit 2014-02-19 14:15:05 +00:00
package.json release 0.11.0 2016-11-04 00:34:17 +00:00
README.md updated readme 2016-11-03 00:42:22 +00:00

README.md

Matter.js

Matter.js is a JavaScript 2D rigid body physics engine for the web

brm.io/matter-js

Demos - Gallery - Features - Install - Usage - Examples - Docs - Wiki - References - License

Build Status

Demos

Gallery

See how others are using matter.js physics

Features

  • Rigid bodies
  • Compound bodies
  • Composite bodies
  • Concave and convex hulls
  • Physical properties (mass, area, density etc.)
  • Restitution (elastic and inelastic collisions)
  • Collisions (broad-phase, mid-phase and narrow-phase)
  • Stable stacking and resting
  • Conservation of momentum
  • Friction and resistance
  • Events
  • Constraints
  • Gravity
  • Sleeping and static bodies
  • Rounded corners (chamfering)
  • Views (translate, zoom)
  • Collision queries (raycasting, region tests)
  • Time scaling (slow-mo, speed-up)
  • Canvas renderer (supports vectors and textures)
  • MatterTools for creating, testing and debugging worlds
  • World state serialisation (requires resurrect.js)
  • Cross-browser (Chrome, Firefox, Safari, IE8+)
  • Mobile-compatible (touch, responsive)
  • An original JavaScript physics implementation (not a port)

Install

Download the edge build (master) or get a stable release and include the script in your web page:

<script src="matter.js" type="text/javascript"></script>

You can also install using the package managers Bower and NPM.

bower install matter-js
npm install matter-js

Usage

Visit the Getting started wiki page for a minimal usage example.
Also see the Rendering wiki page, which also shows how to use your own game loop.

Examples

See the examples directory which contains the source for all demos.
There are even more examples on codepen.

Documentation

See the API Documentation and the wiki

Building and Contributing

To build you must first install node.js and gulp, then run

npm install

This will install the required build dependencies, then run

gulp dev

to spawn a development server. For information on contributing see CONTRIBUTING.md.

Changelog

To see what's new or changed in the latest version, see the changelog.

References

See the wiki page on References.

License

Matter.js is licensed under The MIT License (MIT)
Copyright (c) 2014 Liam Brummitt

This license is also supplied with the release and source code.
As stated in the license, absolutely no warranty is provided.