Struct SoftBodySet 

pub struct SoftBodySet { /* private fields */ }

A set of soft bodies that can be handled by a physics pipeline. Inserting a soft body creates its hidden root rigid body in the RigidBodySet (see SoftBody) and its colliders in the ColliderSet; removing it removes them, so never remove those yourself.

Implementations

impl SoftBodySet

pub fn new() -> Self

Creates an empty set.

pub fn len(&self) -> usize

The number of soft bodies in this set.

pub fn is_empty(&self) -> bool

Whether this set is empty.

pub fn contains(&self, handle: SoftBodyHandle) -> bool

Whether the given handle identifies a soft body of this set.

pub fn get(&self, handle: SoftBodyHandle) -> Option<&SoftBody>

The soft body with the given handle.

pub fn get_mut(&mut self, handle: SoftBodyHandle) -> Option<&mut SoftBody>

The soft body with the given handle.

pub fn iter(&self) -> impl ExactSizeIterator<Item = (SoftBodyHandle, &SoftBody)>

Iterates over the soft bodies of this set.

pub fn iter_mut( &mut self, ) -> impl ExactSizeIterator<Item = (SoftBodyHandle, &mut SoftBody)>

Iterates mutably over the soft bodies of this set.

impl SoftBodySet

pub fn add_cluster( &mut self, handle: SoftBodyHandle, particles: &[u32], bodies: &mut RigidBodySet, colliders: &mut ColliderSet, ) -> Option<u32>

Adds a cluster to a soft body: a set of its particles (invalid indices ignored, duplicates merged) backed by a fresh crate::dynamics::RigidBodyType::SoftFrame proxy body that joints and colliders attach to. Returns its stable index, None if nothing valid remains.

pub fn remove_cluster( &mut self, handle: SoftBodyHandle, cluster: u32, islands: &mut IslandManager, bodies: &mut RigidBodySet, colliders: &mut ColliderSet, impulse_joints: &mut ImpulseJointSet, multibody_joints: &mut MultibodyJointSet, ) -> Option<SoftClusterRemoval>

Removes the cluster-th cluster of a soft body, its proxy rigid body, and the particles only this cluster covered (with their elements and attachments); removing the last cluster removes the body. Returns what was deleted, or None if the body or cluster is missing.

impl SoftBodySet

pub fn insert( &mut self, soft_body_builder: SoftBodyBuilder, bodies: &mut RigidBodySet, colliders: &mut ColliderSet, ) -> SoftBodyHandle

Inserts a soft body, creating its root rigid body and the deformable colliders of its collision meshes from the collider template; its element topology must index valid particles.

pub fn remove( &mut self, handle: SoftBodyHandle, islands: &mut IslandManager, bodies: &mut RigidBodySet, colliders: &mut ColliderSet, impulse_joints: &mut ImpulseJointSet, multibody_joints: &mut MultibodyJointSet, ) -> Option<SoftBody>

Removes a soft body, its cluster proxies (root rigid body included) and its colliders.

impl SoftBodySet

pub fn sync_particle_positions( &mut self, bodies: &mut RigidBodySet, colliders: &mut ColliderSet, params: &IntegrationParameters, quarantined: &mut Vec<SoftBodyHandle>, )

Updates each soft body’s derived state at the end of a step: surface orientation, sleep state, colliders of the awake ones, the coming step’s speculative margin and the impact-adaptive substep request. A body with a non-finite particle is quarantined.

pub fn tear( &mut self, handle: SoftBodyHandle, edges: &[u32], cells: &[u32], islands: &mut IslandManager, bodies: &mut RigidBodySet, colliders: &mut ColliderSet, impulse_joints: &mut ImpulseJointSet, multibody_joints: &mut MultibodyJointSet, ) -> Option<SoftBodyTearEvent>

Tears a soft body right away and rebuilds its colliders, losing no material: a crack opens through a particle of every torn edge and cell (see SoftBody::tear_edge), disconnected pieces become soft bodies, crossed clusters split. Returns the event, None if unchanged.

pub fn cut( &mut self, handle: SoftBodyHandle, blade: &[Vector; 3], islands: &mut IslandManager, bodies: &mut RigidBodySet, colliders: &mut ColliderSet, impulse_joints: &mut ImpulseJointSet, multibody_joints: &mut MultibodyJointSet, ) -> Option<SoftBodyTearEvent>

Cuts a soft body right away along a blade, a world segment (2D) or triangle (3D), splitting the particles of the edges the blade meets (pinned ones never) and losing no material (see SoftBody::rest_measure). Returns the tear event, or None when nothing changed.

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

Wakes up the given soft body (effective at the start of the next step).

Trait Implementations

impl Clone for SoftBodySet

fn clone(&self) -> SoftBodySet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for SoftBodySet

fn default() -> SoftBodySet

Returns the “default value” for a type.

impl Index<SoftBodyHandle> for SoftBodySet

type Output = SoftBody

The returned type after indexing.

fn index(&self, index: SoftBodyHandle) -> &SoftBody

Performs the indexing (container[index]) operation.

impl IndexMut<SoftBodyHandle> for SoftBodySet

fn index_mut(&mut self, index: SoftBodyHandle) -> &mut SoftBody

Performs the mutable indexing (container[index]) operation.