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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

use crate::core::{callback_state, debug_checks, validation};
use crate::error::{Error, InvalidValueReason, Result};
use crate::types::{BodyId, JointId, Quat, Transform, Vec3};
use crate::world::World;
use boxddd_sys::ffi;

mod defs;
pub use defs::*;

macro_rules! family_method {
    ($world:expr, $joint:expr, $ty:expr, $body:block) => {{
        let _call = enter_typed_joint_call($world, $joint, $ty)?;
        let result = $body;
        Ok(result)
    }};
}

mod distance;
mod motor;
mod parallel;
mod prismatic;
mod revolute;
mod spherical;
mod wheel;
mod world_api;

#[inline]
fn check_joint_body_pair_valid(body_a: BodyId, body_b: BodyId) -> Result<()> {
    if body_a != body_b {
        Ok(())
    } else {
        Err(validation::invalid(
            "joint.bodies",
            InvalidValueReason::InvalidCombination,
        ))
    }
}

#[inline]
fn validate_length_range(context: &'static str, lower: f32, upper: f32) -> Result<()> {
    validation::nonnegative(context, lower)?;
    validation::nonnegative(context, upper)?;
    validation::ordered(context, lower, upper)
}

#[inline]
pub(crate) fn enter_joint_call(
    world: &World,
    joint_id: JointId,
) -> Result<callback_state::OwnerCallFrame> {
    world.enter_joint_call(joint_id)
}

#[inline]
fn enter_typed_joint_call(
    world: &World,
    joint_id: JointId,
    expected: JointType,
) -> Result<callback_state::OwnerCallFrame> {
    let call = enter_joint_call(world, joint_id)?;
    let actual = JointType::from_raw(unsafe { ffi::b3Joint_GetType(joint_id.into_raw()) })
        .ok_or(Error::NativeFailure)?;
    if actual == expected {
        Ok(call)
    } else {
        Err(validation::invalid(
            "joint.type",
            InvalidValueReason::InvalidCombination,
        ))
    }
}