boxddd 0.2.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

use boxddd::{
    BodyDef, BodyType, BoxHull, Capsule, Error, ExplosionDef, QueryFilter, ShapeDef, Sphere, Vec3,
    World, WorldDef,
};

#[test]
fn cast_mover_returns_fraction_for_simple_static_scene() {
    let mut world = World::new(WorldDef::default()).unwrap();
    let body = world.create_body(BodyDef::builder().body_type(BodyType::Static).build());
    world.create_hull_shape(body, &ShapeDef::default(), &BoxHull::new(1.0, 0.5, 1.0));
    let mover = Capsule::new([0.0, 2.0, 0.0], [0.0, 3.0, 0.0], 0.25);
    let fraction = world
        .cast_mover(
            [0.0, 0.0, 0.0],
            &mover,
            [0.0, -4.0, 0.0],
            QueryFilter::default(),
        )
        .unwrap();
    assert!((0.0..=1.0).contains(&fraction));
}

#[test]
fn collide_mover_returns_world_and_body_planes() {
    let mut world = World::new(WorldDef::default()).unwrap();
    let body = world.create_body(BodyDef::builder().body_type(BodyType::Static).build());
    let shape = world.create_hull_shape(body, &ShapeDef::default(), &BoxHull::new(0.5, 0.5, 0.5));
    let mover = Capsule::new([-0.3, 0.6, 0.0], [0.3, 0.6, 0.0], 0.2);

    let world_planes = world
        .collide_mover([0.0, 0.0, 0.0], &mover, QueryFilter::default())
        .unwrap();
    assert!(world_planes.iter().any(|plane| plane.shape_id == shape));

    let body_planes = world
        .try_body_collide_mover(body, [0.0, 0.0, 0.0], &mover, QueryFilter::default())
        .unwrap();
    assert!(body_planes.iter().any(|plane| plane.shape_id == shape));
}

#[test]
fn collide_mover_callback_panic_is_reported() {
    let mut world = World::new(WorldDef::default()).unwrap();
    let body = world.create_body(BodyDef::builder().body_type(BodyType::Static).build());
    world.create_hull_shape(body, &ShapeDef::default(), &BoxHull::new(0.5, 0.5, 0.5));
    let mover = Capsule::new([-0.3, 0.6, 0.0], [0.3, 0.6, 0.0], 0.2);

    assert_eq!(
        world
            .visit_collide_mover([0.0, 0.0, 0.0], &mover, QueryFilter::default(), |_| {
                panic!("callback panic should be contained");
            })
            .unwrap_err(),
        Error::CallbackPanicked
    );
}

#[test]
fn explode_changes_near_dynamic_body_velocity_and_rejects_invalid_input() {
    let mut world = World::new(WorldDef::builder().gravity(Vec3::ZERO).build()).unwrap();
    let near_body = world.create_body(
        BodyDef::builder()
            .body_type(BodyType::Dynamic)
            .position([1.0, 0.0, 0.0])
            .build(),
    );
    world.create_sphere_shape(
        near_body,
        &ShapeDef::builder().density(1.0).build(),
        &Sphere::new(Vec3::ZERO, 0.5),
    );
    let far_body = world.create_body(
        BodyDef::builder()
            .body_type(BodyType::Dynamic)
            .position([10.0, 0.0, 0.0])
            .build(),
    );
    world.create_sphere_shape(
        far_body,
        &ShapeDef::builder().density(1.0).build(),
        &Sphere::new(Vec3::ZERO, 0.5),
    );

    let explosion = ExplosionDef::builder()
        .position(Vec3::ZERO)
        .radius(2.0)
        .falloff(0.0)
        .impulse_per_area(20.0)
        .build();
    world.try_explode(&explosion).unwrap();

    assert!(world.body_linear_velocity(near_body).x > 0.0);
    assert_eq!(world.body_linear_velocity(far_body), Vec3::ZERO);

    let invalid = ExplosionDef::builder().radius(-1.0).build();
    assert_eq!(
        world.try_explode(&invalid).unwrap_err(),
        Error::InvalidArgument
    );
}