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

use boxddd::prelude::*;

fn main() -> boxddd::Result<()> {
    let foundation = Foundation::initialize_default()?;
    let mut world = foundation.create_world(foundation.world_def())?;

    let body = world.create_body(
        foundation
            .body_def_builder()
            .body_type(BodyType::Static)
            .position(Vec3::ZERO)
            .build()?,
    )?;
    let sphere = world.create_sphere_shape(
        body,
        &foundation.shape_def_builder().density(1.0).build()?,
        &Sphere::new([-1.0, 0.0, 0.0], 0.5),
    )?;
    let cube = world.create_hull_shape(
        body,
        &foundation.shape_def_builder().density(1.0).build()?,
        &BoxHull::cube(0.4)?,
    )?;

    let shapes = world.body_shapes(body)?;
    println!("body owns {} shape(s): {shapes:?}", shapes.len());

    let overlap = world.overlap_aabb(
        Aabb {
            lower_bound: [-2.0, -1.0, -1.0].into(),
            upper_bound: [0.5, 1.0, 1.0].into(),
        },
        QueryFilter::default(),
    )?;
    println!("world overlap hits: {overlap:?}");

    let closest_ray_hit =
        world.cast_ray_closest([-3.0, 0.0, 0.0], [5.0, 0.0, 0.0], QueryFilter::default())?;
    println!("closest ray hit: {closest_ray_hit:?}");

    let body_hit = world.body_cast_ray(
        body,
        [-3.0, 0.0, 0.0],
        [5.0, 0.0, 0.0],
        QueryFilter::default(),
    )?;
    println!("body-scoped ray hit: {body_hit:?}");

    let sphere_closest = world.shape_closest_point(sphere, [2.0, 0.0, 0.0])?;
    let cube_hit = world.shape_cast_ray(cube, [-2.0, 0.0, 0.0], [5.0, 0.0, 0.0])?;
    println!("sphere closest point to x=2: {sphere_closest:?}");
    println!("cube shape-only ray hit: {cube_hit:?}");

    Ok(())
}