dynamis-model 0.7.0

Host facing physics descriptions, states, and derived mass properties
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
83
84
85
86
87

#[derive(Clone, Copy, Debug, PartialEq)]
pub struct SurfaceDesc {
    pub friction: f32,
    pub restitution: f32,
    pub rolling_friction: f32,
    pub spin_friction: f32,
}

impl SurfaceDesc {
    pub fn new() -> Self {
        Self {
            friction: 0.5,
            restitution: 0.0,
            rolling_friction: 0.0,
            spin_friction: 0.0,
        }
    }

    pub fn friction(mut self, friction: f32) -> Self {
        assert!(friction >= 0.0, "surface friction must be non-negative");
        self.friction = friction;
        self
    }

    pub fn restitution(mut self, restitution: f32) -> Self {
        self.restitution = restitution;
        self
    }

    pub fn rolling_friction(mut self, rolling_friction: f32) -> Self {
        assert!(
            rolling_friction >= 0.0,
            "surface rolling friction must be non-negative"
        );
        self.rolling_friction = rolling_friction;
        self
    }

    pub fn spin_friction(mut self, spin_friction: f32) -> Self {
        assert!(
            spin_friction >= 0.0,
            "surface spin friction must be non-negative"
        );
        self.spin_friction = spin_friction;
        self
    }
}

impl Default for SurfaceDesc {
    fn default() -> Self {
        Self::new()
    }
}

#[derive(Clone, Copy, Debug, PartialEq)]
pub struct SurfaceTable<'a> {
    palette: &'a [SurfaceDesc],
    indices: &'a [u32],
}

impl<'a> SurfaceTable<'a> {
    pub fn new(palette: &'a [SurfaceDesc], indices: &'a [u32]) -> Self {
        assert!(
            !palette.is_empty(),
            "a surface table carries at least one surface"
        );
        assert!(
            indices
                .iter()
                .all(|index| (*index as usize) < palette.len()),
            "a surface index must address its own palette"
        );
        Self { palette, indices }
    }

    pub fn palette(self) -> &'a [SurfaceDesc] {
        self.palette
    }

    pub fn indices(self) -> &'a [u32] {
        self.indices
    }

    pub fn count(self) -> usize {
        self.indices.len()
    }
}