World

World

new World()

Look at the World reference pages before reading these docs. A `world` object is created automatically by p5play. There can only be one world per p5.js instance. This class extends `planck.World` and adds some p5play specific features.
Source:

Extends

  • planck.World

Classes

World

Members

allowSleeping :Boolean

"Sleeping" sprites get temporarily ignored during physics simulation. A sprite starts "sleeping" when it stops moving and doesn't collide with anything that it wasn't already touching. This is an important performance optimization that you probably shouldn't disable for every sprite in the world.
Default Value:
  • true
Source:
Type:
  • Boolean

gravity :Object

Gravity force vector that affects all dynamic physics colliders.
Properties:
Name Type Description
x Number
y Number
Default Value:
  • { x: 0, y: 0 }
Source:
Type:
  • Object

realTime :Number

The real time in seconds since the world was created, including time spent paused.
Source:
Type:
  • Number

timeScale :Number

A time scale of 1.0 represents real time. Accepts decimal values between 0 and 2.
Default Value:
  • 1.0
Source:
Type:
  • Number

velocityThreshold :Number

The lowest velocity an object can have before it is considered to be at rest. Adjust the velocity threshold to allow for slow moving objects but don't have it be too low, or else objects will never sleep, which will hurt performance.
Default Value:
  • 0.19
Source:
Type:
  • Number

Methods

getSpriteAt(x, y, groupopt) → {Sprite}

Returns the sprite at the specified position on the top most layer. Optionally you can specify a group to search.
Source:
Parameters:
Name Type Attributes Description
x Number
y Number
group Group <optional>
 the group to search
Returns:
Type:
Sprite
a sprite

getSpritesAt(x, y, groupopt, cameraActiveWhenDrawnopt) → {Array:.<Sprite:>}

Returns the sprites at a position, ordered by layer. Optionally you can specify a group to search.
Source:
Parameters:
Name Type Attributes Description
x Number
y Number
group Group <optional>
 the group to search
cameraActiveWhenDrawn Boolean <optional>
 if true, only sprites that were drawn when the camera was active will be returned
Returns:
Type:
Array:.<Sprite:>
an array of sprites

rayCast(startPos, direction, maxDistance) → {Sprite}

Finds the first sprite that intersects a ray (line), excluding any sprites that intersect with the starting point. Can also be given a starting position and a maximum end position.
Source:
Parameters:
Name Type Description
startPos Object starting position of the ray cast
direction Number direction of the ray
maxDistance Number max distance the ray should check
Returns:
Type:
Sprite
The first sprite the ray hits or undefined

rayCastAll(startPos, direction, maxDistance, limiteropt) → {Array:.<Sprite:>}

Finds sprites that intersect a line (ray), excluding any sprites that intersect the starting point. Can also be given a starting position and a maximum end position.
Source:
Parameters:
Name Type Attributes Description
startPos Object starting position of the ray cast
direction Number direction of the ray
maxDistance Number max distance the ray should check
limiter function <optional>
 limiter function that's run each time the ray intersects a sprite, return true to stop the ray
Returns:
Type:
Array:.<Sprite:>
An array of sprites that the ray cast hit, sorted by distance. The sprite closest to the starting point will be at index 0.

step(timeStepopt, velocityIterationsopt, positionIterationsopt)

Performs a physics simulation step that advances all sprites' forward in time by 1/60th of a second if no timeStep is given. This function is automatically called at the end of the p5.js draw loop, unless it was already called inside the draw loop. Decreasing velocityIterations and positionIterations will improve performance but decrease simulation quality.
Source:
Parameters:
Name Type Attributes Description
timeStep Number <optional>
 time step in seconds
velocityIterations Number <optional>
 8 by default
positionIterations Number <optional>
 3 by default