Skip to main content

Physics.RebuildBroadphaseRegions(Bounds worldBounds, number subdivisions)

Rebuild the broadphase interest regions as well as set the world boundaries.

Parameters:

NameTypeDescription
worldBoundsBoundsBoundaries of the physics world.
subdivisionsnumberHow many cells to create along x and z axis.

Usage

---@type Bounds
local worldBounds;

---@type number
local subdivisions;


Physics:RebuildBroadphaseRegions(worldBounds, subdivisions)

Extra Detail

Effective only when the Multi-box Pruning Broadphase is used.

In this mode, the boundaries of the world have to be set and then the physics engine would subdivide the volume into a flat grid in the XZ plane, with each cell containing a set of objects that belong to the cell. One may think that each cell contains an instance of the regular sweep-and-prune broadphase. The main benefit of having a grid is to be able to avoid the typical sweep-and-prune locality problem where in a flat world all the objects overlap each other along the Y axis thus causing excess rebuilding of the SAP projections lists along each axis even for the objects that are far apart.

Note that the physics objects located outside of the world boundaries will not detect collisions at all.

There is a limit of 256 on the total amount of world cells currently, so the maximum number you can set to subdivisions is 16.