Release 0.20.0

[liabru]

▲.● matter.js 0.20.0

Release notes for 0.20.0. See the release readme for further information.

Highlights ✺

• added support for high refresh rate displays with fixed timestep in Matter.Runner
• added support for sub-stepping for higher quality simulations in Matter.Runner
• changed to a fixed timestep by default in Matter.Runner
• improved frame pacing and average performance up to ~6% (see #1238)
• reduced average memory usage up to ~30% (see #1238)
• reduced memory garbage collection
• bug fixes and improvements see changelog

Changes ✲

See the release compare page and the changelog for a detailed list of changes.

Migration ⌲

Matter.Runner related changes #1254:

• Matter.Runner now defaults to a fixed deterministic timestep and support for non-fixed timestep is removed
• optionally set your performance budgets runner.maxFrameTime (see docs)
• note that Matter.Runner can now call zero, one, or multiple engine updates and events per display frame (see docs)
• if needed set up your polyfill for window.requestAnimationFrame
• see Matter.Runner updated docs throughout

Performance related changes #1238:

• Matter.Collision use collision.supportCount instead of collision.supports.length for active support count
• Matter.Pair use pair.contacts instead of pair.activeContacts
• Matter.Pair use pair.contactCount instead of pair.contacts.length for active contact count
• Pair.id format has changed

Comparison ⎄

For more information see comparison method.

Output sample comparison estimates of 44 examples against previous release matter-js@0.19.0:  

Similarity     99.80%    Overlap    -1.92%   Filesize   +3.38%  81.58 KB  

airFriction · · avalanche ● · ballPool ● · bridge ● · car ● · catapult ● · 
chains ● · circleStack · · cloth ● · collisionFiltering ● · compositeManipulation ● · 
compound · · compoundStack ● · concave ● · constraints ● · doublePendulum · · 
events ● · friction · · gravity ● · gyro ● · manipulation ● ◆ 
mixed ● · newtonsCradle · · pyramid ● · ragdoll ● · raycasting ● · 
remove ● ◆ restitution · · rounded ● · sensors · · sleeping ● ◆ 
slingshot ● · softBody ● · sprites ● · stack · · staticFriction ● · 
stats ● · stress ● · stress2 ● · stress3 ● · stress4 ● · 
timescale ● · views ● · wreckingBall ● ·   

where for the sample  · no change detected  ● extrinsics changed  ◆ intrinsics changed

Contributors ♥︎

Many thanks to the contributors of this release, past contributors as well those involved in the community for your input and support.