Struct FractureModifier 

pub struct FractureModifier {
    pub config: FractureConfig,
    pub stress: ScalarField3D,
    pub cracks: Vec<Crack>,
    pub enabled: bool,
}

Fracture modifier: stress accumulation and crack propagation

Fields

config: FractureConfig

Configuration

stress: ScalarField3D

Accumulated stress field

cracks: Vec<Crack>

Active cracks

enabled: bool

Whether modifier is enabled

Implementations

impl FractureModifier

pub fn new( config: FractureConfig, resolution: usize, min: (f32, f32, f32), max: (f32, f32, f32), ) -> Self

Create a new fracture modifier

pub fn apply_stress_at( &mut self, x: f32, y: f32, z: f32, amount: f32, radius: f32, )

Apply stress at a point (from impact or load)

pub fn stress_at(&self, x: f32, y: f32, z: f32) -> f32

Get stress at a point

pub fn active_crack_count(&self) -> usize

Number of active cracks

impl FractureModifier

pub const PARTICIPANT_KIND: ParticipantKind

Snapshot tag of this type as a world participant: "FRAC", the four ASCII bytes read big endian. Never changes.

Trait Implementations

impl Participant for FractureModifier

One update(h) per world substep (h converted with Fix128::to_f32); see the module documentation of crate::sim_modifier for the payload and what is not coupled yet.

Observations: channel 0 the highest cell stress (absent for a grid without cells), channel 1 the number of cracks, channel 2 the number of cracks still growing.

fn kind(&self) -> ParticipantKind

Snapshot tag of this participant type.

fn substep( &mut self, _ctx: &mut SubstepCtx<'_>, h: Fix128, ) -> Result<(), ParticipantFault>

Advance by one world substep of width h (ctx.h()). Read bodies from ctx, stage forces on them through ctx.

fn observe(&self, out: &mut ObservationSink)

Report observable values. The world reports them as Observed::Undecided while a fault is recorded.

fn write_state(&self, out: &mut Vec<u8>)

Append the whole state to out.

fn check_state(&self, bytes: &[u8]) -> Result<(), StateError>

Check that bytes is a payload Self::read_state can apply. Must not change self.

fn read_state(&mut self, bytes: &[u8])

Replace the state with bytes. Only called with a payload Self::check_state accepted.

fn step_rule(&self) -> StepRule

How this participant’s time step relates to the world substep.

fn ports(&self) -> &[Port]

The ports this participant reads and writes, empty by default. The world reads them once, at registration, to fix the execution order (execution_order); they must not change while the participant is registered.

impl PhysicsModifier for FractureModifier

fn modify_distance(&self, x: f32, y: f32, z: f32, original_dist: f32) -> f32

Modify the SDF distance at a world-space point.

fn update(&mut self, dt: f32)

Advance the simulation state by dt seconds.

fn name(&self) -> &'static str

Name of this modifier (for debugging)

fn is_active(&self) -> bool

Whether this modifier has any active effect