blast-stress-solver 0.1.0

Blast stress solver for destructible structures, with optional Rapier3D integration
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

/// Controls how fractures are processed per frame.
///
/// All limits default to -1 (unlimited). This mirrors the JS `FracturePolicy`.
#[derive(Clone, Copy, Debug)]
pub struct FracturePolicy {
    /// Max bonds to break per frame. -1 = unlimited.
    pub max_fractures_per_frame: i32,
    /// Max new rigid bodies to create per frame. -1 = unlimited.
    pub max_new_bodies_per_frame: i32,
    /// Global cap on dynamic rigid bodies. -1 = unlimited.
    pub max_dynamic_bodies: i32,
    /// Max collider migrations to apply per frame. -1 = unlimited.
    pub max_collider_migrations_per_frame: i32,
    /// Minimum node count for a split child to get a body. Default: 1.
    pub min_child_node_count: u32,
    /// Skip solver on idle frames (no forces, no recent fractures). Default: true.
    pub idle_skip: bool,
    /// Apply solver-reported excess forces to newly separated bodies. Default: true.
    pub apply_excess_forces: bool,
}

impl Default for FracturePolicy {
    fn default() -> Self {
        Self {
            max_fractures_per_frame: -1,
            max_new_bodies_per_frame: -1,
            max_dynamic_bodies: -1,
            max_collider_migrations_per_frame: -1,
            min_child_node_count: 1,
            idle_skip: true,
            apply_excess_forces: true,
        }
    }
}

impl FracturePolicy {
    /// Whether fracture generation should be suppressed this frame.
    pub fn should_suppress(&self, current_dynamic_bodies: usize) -> bool {
        if self.max_dynamic_bodies > 0 && current_dynamic_bodies >= self.max_dynamic_bodies as usize
        {
            return true;
        }
        false
    }

    /// Clamp the number of fractures to the per-frame budget.
    pub fn clamp_fractures(&self, count: usize) -> usize {
        if self.max_fractures_per_frame < 0 {
            count
        } else {
            count.min(self.max_fractures_per_frame as usize)
        }
    }

    /// Clamp the number of new bodies to the per-frame budget.
    pub fn clamp_new_bodies(&self, count: usize) -> usize {
        if self.max_new_bodies_per_frame < 0 {
            count
        } else {
            count.min(self.max_new_bodies_per_frame as usize)
        }
    }

    /// Clamp collider migrations to the per-frame budget.
    pub fn clamp_collider_migrations(&self, count: usize) -> usize {
        if self.max_collider_migrations_per_frame < 0 {
            count
        } else {
            count.min(self.max_collider_migrations_per_frame as usize)
        }
    }

    /// Whether split admission budgets are fully disabled.
    pub fn split_budgets_unlimited(&self) -> bool {
        self.max_new_bodies_per_frame < 0 && self.max_collider_migrations_per_frame < 0
    }

    /// Whether a child with the given node count should receive a body.
    pub fn child_qualifies(&self, node_count: u32) -> bool {
        node_count >= self.min_child_node_count
    }
}