Module fracture_csg
Expand description
Principled Stress-Cleavage Dynamic Fracture (fracture_csg.rs).
Wires evaluate_stress_cleavage_partition directly into the 3D collision impulse handler:
- When impact stress $\sigma = J / A$ exceeds
tensile_strength, evaluates the principal stress cleavage plane ($\mathbf{n}_{\text{cleavage}} \cdot \mathbf{p} - d_0 = 0$), - Splits a convex / box collider into two child debris
RigidBody3Dbodies with conserved total mass and conserved linear/angular momentum.
Structs§
- Fracture
Outcome3D - Result of splitting a
RigidBody3Dalong a principal tensile stress cleavage plane.
Functions§
- evaluate_
and_ fracture_ body - Evaluates whether an impact impulse
impact_impulse_nsovercontact_area_m2fracturesbody, and if $\sigma = J / A \ge \text{tensile_strength}$, partitions the collider along the cleavage plane usingevaluate_stress_cleavage_partition. - evaluate_
stress_ cleavage_ partition - Evaluate structural fracture criterion under principal tensile stress $\sigma_1$.
Returns
Some(true/false)if $\sigma_1 \ge \sigma_{\text{crit}}$ indicating the cleavage partition half-space sign, orNoneif below threshold.