boxddd 0.1.0

Safe, ergonomic Rust bindings for Box3D
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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150

use boxddd::{
    Capsule, Compound, Error, HeightField, Hull, MeshData, MeshDataOptions, ShapeDef, Sphere,
    SurfaceMaterial, Transform, Vec3,
};

#[test]
fn surface_material_default_matches_box3d_default() {
    let material = SurfaceMaterial::default();
    assert_eq!(material.friction, 0.6);
    assert_eq!(material.restitution, 0.0);
    assert_eq!(material.rolling_resistance, 0.0);
    assert_eq!(material.tangent_velocity, Vec3::ZERO);
}

#[test]
fn value_and_resource_geometry_reject_invalid_inputs() {
    assert_eq!(
        Capsule::new(Vec3::ZERO, Vec3::X, f32::NAN).validate(),
        Err(Error::InvalidArgument)
    );
    assert_eq!(
        Sphere::new(Vec3::ZERO, 0.0).validate(),
        Err(Error::InvalidArgument)
    );
    assert!(Hull::from_points([Vec3::ZERO, Vec3::X, Vec3::Y], 8).is_err());
    assert!(Hull::cylinder(1.0, 1.0, 0.0, 2).is_err());
    assert!(MeshData::box_mesh(Vec3::ZERO, [1.0, 0.0, 1.0], true).is_err());
    assert!(
        MeshData::from_triangles(
            vec![Vec3::ZERO, Vec3::X, Vec3::Y],
            vec![0, 1, 3],
            None,
            MeshDataOptions::default(),
        )
        .is_err()
    );
    assert!(
        MeshData::from_triangles(
            vec![Vec3::ZERO, Vec3::X, Vec3::Y],
            vec![0, 1, 2],
            Some(&[0, 1]),
            MeshDataOptions::default(),
        )
        .is_err()
    );
    assert!(
        MeshData::from_triangles(
            vec![Vec3::ZERO, Vec3::X, Vec3::new(2.0, 0.0, 0.0)],
            vec![0, 1, 2],
            None,
            MeshDataOptions::default(),
        )
        .is_err()
    );
    assert!(
        MeshData::from_triangles(
            vec![Vec3::ZERO, Vec3::X, Vec3::Y],
            vec![0, 1, 2],
            None,
            MeshDataOptions::default().weld_tolerance(f32::NAN),
        )
        .is_err()
    );
    assert!(MeshData::wave_mesh(2, 2, 1.0, f32::NAN, 1.0, 1.0).is_err());
    assert!(MeshData::torus_mesh(2, 8, 1.0, 0.25).is_err());
    assert!(MeshData::hollow_box_mesh(Vec3::ZERO, [1.0, 0.0, 1.0]).is_err());
    assert!(MeshData::platform_mesh(Vec3::ZERO, 1.0, 0.0, 2.0).is_err());
    assert!(HeightField::grid(1, 2, [1.0, 1.0, 1.0], false).is_err());
    assert!(
        HeightField::from_samples(2, 2, vec![0.0, 1.0, 2.0], [1.0, 1.0, 1.0], None, false).is_err()
    );
    assert!(
        HeightField::from_samples(
            2,
            2,
            vec![0.0, 1.0, 2.0, f32::NAN],
            [1.0, 1.0, 1.0],
            None,
            false,
        )
        .is_err()
    );
    assert!(
        HeightField::from_samples(
            2,
            2,
            vec![0.0, 1.0, 2.0, 3.0],
            [1.0, 1.0, 1.0],
            Some(&[0, 1]),
            false,
        )
        .is_err()
    );
    assert!(HeightField::wave(2, 2, [1.0, 1.0, 1.0], f32::NAN, 1.0, false).is_err());
    assert!(
        Compound::single_sphere(
            Sphere::new(Vec3::ZERO, f32::INFINITY),
            SurfaceMaterial::default()
        )
        .is_err()
    );
    assert!(Compound::builder().build().is_err());
    let mesh = MeshData::box_mesh(Vec3::ZERO, [1.0, 1.0, 1.0], true).unwrap();
    let mut compound_builder = Compound::builder();
    compound_builder
        .add_sphere(Sphere::new(Vec3::ZERO, 0.25), SurfaceMaterial::default())
        .unwrap();
    assert!(
        compound_builder
            .add_mesh(
                &mesh,
                Transform::IDENTITY,
                [0.0, 1.0, 1.0],
                [SurfaceMaterial::default()],
            )
            .is_err()
    );
    assert_eq!(
        SurfaceMaterial {
            friction: -1.0,
            ..Default::default()
        }
        .validate(),
        Err(Error::InvalidArgument)
    );
    assert_eq!(
        SurfaceMaterial {
            restitution: -1.0,
            ..Default::default()
        }
        .validate(),
        Err(Error::InvalidArgument)
    );
    assert_eq!(
        SurfaceMaterial {
            rolling_resistance: -1.0,
            ..Default::default()
        }
        .validate(),
        Err(Error::InvalidArgument)
    );
    assert_eq!(
        ShapeDef::builder().friction(-1.0).build().validate(),
        Err(Error::InvalidArgument)
    );
    assert_eq!(
        ShapeDef::builder().restitution(-1.0).build().validate(),
        Err(Error::InvalidArgument)
    );
}