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

use super::*;

fn borrow_world_scoped_handle<T, Id: Copy>(
    world: &mut World,
    id: Id,
    is_valid: impl FnOnce(Id) -> bool,
    wrap: impl FnOnce(Arc<WorldCore>, Id) -> T,
) -> Option<T> {
    crate::core::callback_state::assert_not_in_callback();
    if is_valid(id) {
        Some(wrap(world.core_arc(), id))
    } else {
        None
    }
}

fn try_borrow_world_scoped_handle<T, Id: Copy>(
    world: &mut World,
    id: Id,
    invalid: crate::error::ApiError,
    is_valid: impl FnOnce(Id) -> bool,
    wrap: impl FnOnce(Arc<WorldCore>, Id) -> T,
) -> crate::error::ApiResult<T> {
    crate::core::callback_state::check_not_in_callback()?;
    if is_valid(id) {
        Ok(wrap(world.core_arc(), id))
    } else {
        Err(invalid)
    }
}

impl World {
    /// Borrow a scoped body handle by id (returns `None` if the id is invalid).
    pub fn body<'w>(&'w mut self, id: BodyId) -> Option<Body<'w>> {
        borrow_world_scoped_handle(
            self,
            id,
            |id| unsafe { ffi::b2Body_IsValid(raw_body_id(id)) },
            Body::new,
        )
    }

    pub fn try_body<'w>(&'w mut self, id: BodyId) -> crate::error::ApiResult<Body<'w>> {
        try_borrow_world_scoped_handle(
            self,
            id,
            crate::error::ApiError::InvalidBodyId,
            |id| unsafe { ffi::b2Body_IsValid(raw_body_id(id)) },
            Body::new,
        )
    }

    /// Borrow a scoped joint handle by id (returns `None` if the id is invalid).
    pub fn joint<'w>(&'w mut self, id: JointId) -> Option<crate::joints::Joint<'w>> {
        borrow_world_scoped_handle(
            self,
            id,
            |id| unsafe { ffi::b2Joint_IsValid(raw_joint_id(id)) },
            crate::joints::Joint::new,
        )
    }

    pub fn try_joint<'w>(
        &'w mut self,
        id: JointId,
    ) -> crate::error::ApiResult<crate::joints::Joint<'w>> {
        try_borrow_world_scoped_handle(
            self,
            id,
            crate::error::ApiError::InvalidJointId,
            |id| unsafe { ffi::b2Joint_IsValid(raw_joint_id(id)) },
            crate::joints::Joint::new,
        )
    }

    /// Borrow a scoped shape handle by id (returns `None` if the id is invalid).
    pub fn shape<'w>(&'w mut self, id: ShapeId) -> Option<crate::shapes::Shape<'w>> {
        borrow_world_scoped_handle(
            self,
            id,
            |id| unsafe { ffi::b2Shape_IsValid(raw_shape_id(id)) },
            crate::shapes::Shape::new,
        )
    }

    pub fn try_shape<'w>(
        &'w mut self,
        id: ShapeId,
    ) -> crate::error::ApiResult<crate::shapes::Shape<'w>> {
        try_borrow_world_scoped_handle(
            self,
            id,
            crate::error::ApiError::InvalidShapeId,
            |id| unsafe { ffi::b2Shape_IsValid(raw_shape_id(id)) },
            crate::shapes::Shape::new,
        )
    }

    /// Borrow a scoped chain handle by id (returns `None` if the id is invalid).
    pub fn chain<'w>(&'w mut self, id: ChainId) -> Option<crate::shapes::chain::Chain<'w>> {
        borrow_world_scoped_handle(
            self,
            id,
            |id| unsafe { ffi::b2Chain_IsValid(raw_chain_id(id)) },
            crate::shapes::chain::Chain::new,
        )
    }

    pub fn try_chain<'w>(
        &'w mut self,
        id: ChainId,
    ) -> crate::error::ApiResult<crate::shapes::chain::Chain<'w>> {
        try_borrow_world_scoped_handle(
            self,
            id,
            crate::error::ApiError::InvalidChainId,
            |id| unsafe { ffi::b2Chain_IsValid(raw_chain_id(id)) },
            crate::shapes::chain::Chain::new,
        )
    }
}