Struct SoftBody 

pub struct SoftBody {
    pub nodes: Vec<SoftNode>,
    pub springs: Vec<Spring>,
    pub damping: f32,
    pub restitution: f32,
    pub iterations: usize,
    pub label: String,
}

A mass-spring soft body.

Fields

nodes: Vec<SoftNode>

springs: Vec<Spring>

damping: f32

Global friction / air drag coefficient.

restitution: f32

Contact restitution (for floor/ceiling collisions).

iterations: usize

Iteration count for constraint projection.

label: String

User label.

Implementations

impl SoftBody

pub fn new() -> Self

pub fn rope(n: usize, length: f32, mass_per_node: f32, stiffness: f32) -> Self

Create a 1D rope of n nodes spanning length.

pub fn grid(cols: usize, rows: usize, cell_size: f32) -> Self

Create a 2D cloth grid of cols × rows nodes, spaced cell_size.

pub fn grid_with_params( cols: usize, rows: usize, cell_size: f32, mass: f32, stiffness: f32, ) -> Self

Create a cloth grid with custom mass and stiffness.

pub fn blob(n: usize, radius: f32, mass: f32, stiffness: f32) -> Self

Create a circular blob of n nodes with internal cross-springs.

pub fn add_node(&mut self, position: Vec2, mass: f32) -> usize

Add a node and return its index.

pub fn add_spring(&mut self, a: usize, b: usize, stiffness: f32) -> usize

Add a spring between two nodes and return its index.

pub fn pin(&mut self, node: usize)

Pin a node (fix it in space).

pub fn unpin(&mut self, node: usize)

Unpin a node.

pub fn apply_impulse(&mut self, node: usize, impulse: Vec2)

Apply an impulse to a node.

pub fn apply_force_radius(&mut self, origin: Vec2, radius: f32, force: Vec2)

Apply force to all nodes in a radius.

pub fn step(&mut self, dt: f32, gravity: Vec2)

Step the simulation by dt seconds.

pub fn resolve_floor(&mut self, floor_y: f32)

Resolve simple floor collision (y >= floor_y, normal = up).

pub fn resolve_ceiling(&mut self, ceiling_y: f32)

Resolve ceiling collision.

pub fn resolve_wall_left(&mut self, x: f32)

Resolve left wall.

pub fn resolve_wall_right(&mut self, x: f32)

Resolve right wall.

pub fn resolve_circle_obstacle(&mut self, center: Vec2, radius: f32)

Push nodes out of a circle.

pub fn aabb(&self) -> Option<(Vec2, Vec2)>

Axis-aligned bounding box of all nodes.

pub fn centroid(&self) -> Vec2

Centroid of all node positions.

pub fn kinetic_energy(&self) -> f32

Total kinetic energy.

pub fn spring_potential_energy(&self) -> f32

Total potential energy from spring stretch.

pub fn active_spring_count(&self) -> usize

Number of active (non-broken) springs.

pub fn translate(&mut self, offset: Vec2)

Translate all nodes.

pub fn scale(&mut self, factor: f32)

Scale positions around centroid.

pub fn freeze(&mut self)

Zero all velocities (instant freeze).

pub fn positions(&self) -> Vec<Vec2>

Collect all edge node positions (ring periphery for convex hulls or rendering).

pub fn nearest_node(&self, point: Vec2) -> Option<usize>

Closest node index to a world position.

Trait Implementations

impl Clone for SoftBody

fn clone(&self) -> SoftBody

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SoftBody

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SoftBody

fn default() -> Self

Returns the “default value” for a type.