boxdd 0.2.0

Safe, ergonomic Rust bindings for Box2D v3
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

use boxdd_sys::ffi;

const MAX_POLYGON_VERTICES: usize = ffi::B2_MAX_POLYGON_VERTICES as usize;

/// Capsule helper
pub fn capsule<V: Into<crate::types::Vec2>>(c1: V, c2: V, radius: f32) -> ffi::b2Capsule {
    ffi::b2Capsule {
        center1: ffi::b2Vec2::from(c1.into()),
        center2: ffi::b2Vec2::from(c2.into()),
        radius,
    }
}

/// Axis-aligned box polygon helper
pub fn box_polygon(half_width: f32, half_height: f32) -> ffi::b2Polygon {
    unsafe { ffi::b2MakeBox(half_width, half_height) }
}

/// Build a polygon from an arbitrary set of points by computing the convex hull
/// and applying a radius.
///
/// Returns None if:
/// - the input is empty
/// - there are more than `B2_MAX_POLYGON_VERTICES` points (8)
/// - the hull computation fails
pub fn polygon_from_points<I, P>(points: I, radius: f32) -> Option<ffi::b2Polygon>
where
    I: IntoIterator<Item = P>,
    P: Into<crate::types::Vec2>,
{
    let mut pts: Vec<ffi::b2Vec2> = Vec::with_capacity(MAX_POLYGON_VERTICES + 1);
    for p in points.into_iter().take(MAX_POLYGON_VERTICES + 1) {
        pts.push(ffi::b2Vec2::from(p.into()));
    }
    if pts.is_empty() {
        return None;
    }
    if pts.len() > MAX_POLYGON_VERTICES {
        return None;
    }
    let hull = unsafe { ffi::b2ComputeHull(pts.as_ptr(), pts.len() as i32) };
    if hull.count <= 0 {
        return None;
    }
    let poly = unsafe { ffi::b2MakePolygon(&hull, radius) };
    Some(poly)
}