Struct IslandManager 

pub struct IslandManager { /* private fields */ }

System that manages which bodies are active (awake) vs sleeping to optimize performance.

Sleeping Optimization

Bodies at rest automatically “sleep” - they’re excluded from simulation until something disturbs them (collision, joint connection to moving body, manual wake-up). This can dramatically improve performance in scenes with many static/resting objects.

Islands

Connected bodies (via contacts or joints) are grouped into “islands” that are solved together. This allows parallel solving and better organization.

You rarely interact with this directly - it’s automatically managed by PhysicsPipeline.

Implementations

impl IslandManager

pub fn new() -> Self

Creates a new empty island manager.

pub fn cleanup_removed_rigid_bodies(&mut self, bodies: &mut RigidBodySet)

Update this data-structure after one or multiple rigid-bodies have been removed for bodies.

pub fn wake_up( &mut self, bodies: &mut RigidBodySet, handle: RigidBodyHandle, strong: bool, )

Wakes up a sleeping body, forcing it back into the active simulation.

Use this when you want to ensure a body is active (useful after manually moving a sleeping body, or to prevent it from sleeping in the next few frames).

Parameters

• strong - If true, the body is guaranteed to stay awake for multiple frames. If false, it might sleep again immediately if conditions are met.

Example

islands.wake_up(&mut bodies, body_handle, true);
let body = bodies.get_mut(body_handle).unwrap();
// Wake up a body before applying force to it
body.add_force(vector![100.0, 0.0, 0.0], false);

Only affects dynamic bodies (kinematic and fixed bodies don’t sleep).

pub fn active_bodies(&self) -> &[RigidBodyHandle]

Handls of dynamic and kinematic rigid-bodies that are currently active (i.e. not sleeping).

Trait Implementations

impl Clone for IslandManager

fn clone(&self) -> IslandManager

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for IslandManager

fn default() -> IslandManager

Returns the “default value” for a type.