Struct ExtStressSolver 

pub struct ExtStressSolver { /* private fields */ }

High-level stress solver that manages NvBlast families, actors, and fracture commands.

This is the primary API for most users. It wraps the C++ ExtStressSolver which internally manages an NvBlast asset, family, and actors alongside the stress computation.

Implementations

impl ExtStressSolver

pub fn new( nodes: &[NodeDesc], bonds: &[BondDesc], settings: &SolverSettings, ) -> Option<Self>

Create a solver from node and bond descriptors with the given settings.

pub fn set_settings(&mut self, settings: &SolverSettings)

Update solver settings.

pub fn reset(&mut self)

Reset accumulated forces.

pub fn add_force( &mut self, node_index: u32, position: Vec3, force: Vec3, mode: ForceMode, )

Apply a force to a specific node.

pub fn add_gravity(&mut self, gravity: Vec3)

Apply gravity to all actors.

pub fn add_actor_gravity(&mut self, actor_index: u32, gravity: Vec3) -> bool

Apply gravity to a specific actor.

pub fn update(&mut self)

Run one solver update (computes stresses from accumulated forces).

pub fn overstressed_bond_count(&self) -> u32

Number of bonds that exceeded their fatal stress limit after the last update().

pub fn converged(&self) -> bool

Whether the solver converged in the last update().

pub fn linear_error(&self) -> f32

Linear error residual from the last solve.

pub fn angular_error(&self) -> f32

Angular error residual from the last solve.

pub fn actor_count(&self) -> u32

Number of actors currently in the family.

pub fn node_count(&self) -> u32

Total number of graph nodes.

pub fn bond_count(&self) -> u32

Total number of bonds.

pub fn actors(&self) -> Vec<Actor>

Collect the current actor table.

pub fn generate_fracture_commands(&self) -> Vec<FractureCommand>

Generate fracture commands for all actors with overstressed bonds.

pub fn apply_fracture_commands( &mut self, commands: &[FractureCommand], ) -> Vec<SplitEvent>

Apply fracture commands and return split events.

pub fn get_excess_forces( &self, actor_index: u32, com: Vec3, ) -> Option<(Vec3, Vec3)>

Get excess forces for an actor that separated from the structure. Returns (force, torque) if the actor exists.

Trait Implementations

impl Drop for ExtStressSolver

fn drop(&mut self)

Executes the destructor for this type.

impl Send for ExtStressSolver

impl Sync for ExtStressSolver