0.20.2 • Published 2 years ago
@trepidacious/cannon-es v0.20.2
cannon-es
This is a maintained fork of cannon.js, originally created by Stefan Hedman @schteppe.
It's a type-safe flatbundle (esm and cjs) which allows for tree shaking and usage in modern environments.
These minor changes and improvements were also made:
- These PRs from the original repo were merged: schteppe/cannon.js#433, schteppe/cannon.js#430, schteppe/cannon.js#418, schteppe/cannon.js#360, schteppe/cannon.js#265, schteppe/cannon.js#392, schteppe/cannon.js#424
- The ConvexPolyhedronconstructor now accepts an object instead of a list of arguments. #6
- The Cylinderis now oriented on the Y axis. #30
- The typeproperty of theCylinderis now equal toShape.types.CYLINDER. #59
- Body.applyImpulse()and- Body.applyForce()are now relative to the center of the body instead of the center of the world 86b0444
- Sleeping bodies now wake up if a force or an impulse is applied to them #61
- Added a property World.hasActiveBodies: booleanwhich will be false when all physics bodies are sleeping. This allows for invalidating frames when physics aren't active for increased performance.
- Add support for Trigger bodies. #83
- Deprecated properties and methods have been removed.
- The original cannon.js debugger, which shows the wireframes of each body, has been moved to its own repo cannon-es-debugger.
- Added optional property World.frictionGravity: Vec3which can be set to customize the force used when computing the friction between two colliding bodies. Ifundefined,World.gravitywill be used. This property is useful to enable friction in zero gravity. This addresses issue #224 and follows the pattern established for p2.js.
If instead you're using three.js in a React environment with react-three-fiber, check out use-cannon! It's a wrapper around cannon-es.
Installation
yarn add cannon-esUsage
import { World } from 'cannon-es'
// ...or, if you're using webpack, you can import it like this while still taking advantage of tree shaking:
import * as CANNON from 'cannon-es'
// ...Documentation
Examples
TO DO:
- Fix Octree as anyassertions, and removeas anytype assertions wherever possible
- Remove use of defined assertion (!) where possible (profile performance to ensure no degradation)
- Convert to abstract classes where possible (Equation, Solver, etc.?)
- V-HACD support (https://github.com/pmndrs/use-cannon/issues/35#issuecomment-600188994)
- Explore performance enhancements:

