Interface: WorldEventsMap

Phaser.Types.Physics.Matter. WorldEventsMap

Methods


afteradd(event)

The Matter Physics After Add Event.

This event is dispatched by a Matter Physics World instance at the end of the process when a new Body or Constraint has just been added to the world.

Listen to it from a Scene using: this.matter.world.on('afteradd', listener).

Parameters:
Name Type Description
event Phaser.Physics.Matter.Events.AfterAddEvent

The Add Event object.

Since: 3.22.0
Source: src/physics/matter-js/events/AFTER_ADD_EVENT.js (Line 30)

afterremove(event)

The Matter Physics After Remove Event.

This event is dispatched by a Matter Physics World instance at the end of the process when a Body or Constraint was removed from the world.

Listen to it from a Scene using: this.matter.world.on('afterremove', listener).

Parameters:
Name Type Description
event Phaser.Physics.Matter.Events.AfterRemoveEvent

The Remove Event object.

Since: 3.22.0
Source: src/physics/matter-js/events/AFTER_REMOVE_EVENT.js (Line 30)

afterupdate(event)

The Matter Physics After Update Event.

This event is dispatched by a Matter Physics World instance after the engine has updated and all collision events have resolved.

Listen to it from a Scene using: this.matter.world.on('afterupdate', listener).

Parameters:
Name Type Description
event Phaser.Physics.Matter.Events.AfterUpdateEvent

The Update Event object.

Since: 3.0.0
Source: src/physics/matter-js/events/AFTER_UPDATE_EVENT.js (Line 29)

beforeadd(event)

The Matter Physics Before Add Event.

This event is dispatched by a Matter Physics World instance at the start of the process when a new Body or Constraint is being added to the world.

Listen to it from a Scene using: this.matter.world.on('beforeadd', listener).

Parameters:
Name Type Description
event Phaser.Physics.Matter.Events.BeforeAddEvent

The Add Event object.

Since: 3.22.0
Source: src/physics/matter-js/events/BEFORE_ADD_EVENT.js (Line 30)

beforeremove(event)

The Matter Physics Before Remove Event.

This event is dispatched by a Matter Physics World instance at the start of the process when a Body or Constraint is being removed from the world.

Listen to it from a Scene using: this.matter.world.on('beforeremove', listener).

Parameters:
Name Type Description
event Phaser.Physics.Matter.Events.BeforeRemoveEvent

The Remove Event object.

Since: 3.22.0
Source: src/physics/matter-js/events/BEFORE_REMOVE_EVENT.js (Line 30)

beforeupdate(event)

The Matter Physics Before Update Event.

This event is dispatched by a Matter Physics World instance right before all the collision processing takes place.

Listen to it from a Scene using: this.matter.world.on('beforeupdate', listener).

Parameters:
Name Type Description
event Phaser.Physics.Matter.Events.BeforeUpdateEvent

The Update Event object.

Since: 3.0.0
Source: src/physics/matter-js/events/BEFORE_UPDATE_EVENT.js (Line 29)

collisionactive(event, bodyA, bodyB)

The Matter Physics Collision Active Event.

This event is dispatched by a Matter Physics World instance after the engine has updated. It provides a list of all pairs that are colliding in the current tick (if any).

Listen to it from a Scene using: this.matter.world.on('collisionactive', listener).

Parameters:
Name Type Description
event Phaser.Physics.Matter.Events.CollisionActiveEvent

The Collision Event object.

bodyA MatterJS.BodyType

The first body of the first colliding pair. The event.pairs array may contain more colliding bodies.

bodyB MatterJS.BodyType

The second body of the first colliding pair. The event.pairs array may contain more colliding bodies.

Since: 3.0.0
Source: src/physics/matter-js/events/COLLISION_ACTIVE_EVENT.js (Line 33)

collisionend(event, bodyA, bodyB)

The Matter Physics Collision End Event.

This event is dispatched by a Matter Physics World instance after the engine has updated. It provides a list of all pairs that have finished colliding in the current tick (if any).

Listen to it from a Scene using: this.matter.world.on('collisionend', listener).

Parameters:
Name Type Description
event Phaser.Physics.Matter.Events.CollisionEndEvent

The Collision Event object.

bodyA MatterJS.BodyType

The first body of the first colliding pair. The event.pairs array may contain more colliding bodies.

bodyB MatterJS.BodyType

The second body of the first colliding pair. The event.pairs array may contain more colliding bodies.

Since: 3.0.0
Source: src/physics/matter-js/events/COLLISION_END_EVENT.js (Line 33)

collisionstart(event, bodyA, bodyB)

The Matter Physics Collision Start Event.

This event is dispatched by a Matter Physics World instance after the engine has updated. It provides a list of all pairs that have started to collide in the current tick (if any).

Listen to it from a Scene using: this.matter.world.on('collisionstart', listener).

Parameters:
Name Type Description
event Phaser.Physics.Matter.Events.CollisionStartEvent

The Collision Event object.

bodyA MatterJS.BodyType

The first body of the first colliding pair. The event.pairs array may contain more colliding bodies.

bodyB MatterJS.BodyType

The second body of the first colliding pair. The event.pairs array may contain more colliding bodies.

Since: 3.0.0
Source: src/physics/matter-js/events/COLLISION_START_EVENT.js (Line 33)

drag(body, constraint)

The Matter Physics Drag Event.

This event is dispatched by a Matter Physics World instance when a Pointer Constraint is actively dragging a body. It is emitted each time the pointer moves.

Listen to it from a Scene using: this.matter.world.on('drag', listener).

Parameters:
Name Type Description
body MatterJS.BodyType

The Body that is being dragged. This is a Matter Body, not a Phaser Game Object.

constraint Phaser.Physics.Matter.PointerConstraint

The Pointer Constraint that is dragging the body.

Since: 3.16.2
Source: src/physics/matter-js/events/DRAG_EVENT.js (Line 23)

dragend(body, constraint)

The Matter Physics Drag End Event.

This event is dispatched by a Matter Physics World instance when a Pointer Constraint stops dragging a body.

Listen to it from a Scene using: this.matter.world.on('dragend', listener).

Parameters:
Name Type Description
body MatterJS.BodyType

The Body that has stopped being dragged. This is a Matter Body, not a Phaser Game Object.

constraint Phaser.Physics.Matter.PointerConstraint

The Pointer Constraint that was dragging the body.

Since: 3.16.2
Source: src/physics/matter-js/events/DRAG_END_EVENT.js (Line 23)

dragstart(body, part, constraint)

The Matter Physics Drag Start Event.

This event is dispatched by a Matter Physics World instance when a Pointer Constraint starts dragging a body.

Listen to it from a Scene using: this.matter.world.on('dragstart', listener).

Parameters:
Name Type Description
body MatterJS.BodyType

The Body that has started being dragged. This is a Matter Body, not a Phaser Game Object.

part MatterJS.BodyType

The part of the body that was clicked on.

constraint Phaser.Physics.Matter.PointerConstraint

The Pointer Constraint that is dragging the body.

Since: 3.16.2
Source: src/physics/matter-js/events/DRAG_START_EVENT.js (Line 24)

pause()

The Matter Physics World Pause Event.

This event is dispatched by an Matter Physics World instance when it is paused.

Listen to it from a Scene using: this.matter.world.on('pause', listener).

Since: 3.0.0
Source: src/physics/matter-js/events/PAUSE_EVENT.js (Line 19)

resume()

The Matter Physics World Resume Event.

This event is dispatched by an Matter Physics World instance when it resumes from a paused state.

Listen to it from a Scene using: this.matter.world.on('resume', listener).

Since: 3.0.0
Source: src/physics/matter-js/events/RESUME_EVENT.js (Line 19)

sleepend(event, body)

The Matter Physics Sleep End Event.

This event is dispatched by a Matter Physics World instance when a Body stop sleeping.

Listen to it from a Scene using: this.matter.world.on('sleepend', listener).

Parameters:
Name Type Description
event Phaser.Physics.Matter.Events.SleepEndEvent

The Sleep Event object.

body MatterJS.BodyType

The body that has stopped sleeping.

Since: 3.0.0
Source: src/physics/matter-js/events/SLEEP_END_EVENT.js (Line 29)

sleepstart(event, body)

The Matter Physics Sleep Start Event.

This event is dispatched by a Matter Physics World instance when a Body goes to sleep.

Listen to it from a Scene using: this.matter.world.on('sleepstart', listener).

Parameters:
Name Type Description
event Phaser.Physics.Matter.Events.SleepStartEvent

The Sleep Event object.

body MatterJS.BodyType

The body that has gone to sleep.

Since: 3.0.0
Source: src/physics/matter-js/events/SLEEP_START_EVENT.js (Line 29)