leaprs 0.2.2

Safe wrapper for the LeapC Ultraleap (Leap Motion) hand tracking device API.
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

use derive_deref::Deref;
use leap_sys::LEAP_TRACKING_EVENT;

use crate::{FrameHeaderRef, HandRef};

#[doc = " A snapshot, or frame of data, containing the tracking data for a single moment in time."]
#[doc = " The LEAP_FRAME struct is the container for all the tracking data."]
#[doc = " @since 3.0.0"]
/// # Fields
/// Available via dereference: [LEAP_TRACKING_EVENT].
#[derive(Deref, Clone, Copy)]
pub struct TrackingEventRef<'a>(pub(crate) &'a LEAP_TRACKING_EVENT);

impl<'a> TrackingEventRef<'a> {
    #[doc = " A universal frame identification header. @since 3.0.0"]
    pub fn info(&self) -> FrameHeaderRef {
        FrameHeaderRef(&self.info)
    }

    #[doc = " A pointer to the array of hands tracked in this frame."]
    #[doc = " @since 3.0.0"]
    pub fn hands(&self) -> Vec<HandRef> {
        let n_hand = self.nHands as isize;
        unsafe {
            (0..n_hand)
                .map(|hand_index| &*self.pHands.offset(hand_index))
                .map(HandRef)
                .collect()
        }
    }
}

#[cfg(test)]
mod tests {
    use crate::tests::*;
    use crate::*;

    #[test]
    fn read_hands() {
        let mut conn = initialize_connection();
        conn.wait_for(|e| match e {
            EventRef::Tracking(e) => {
                let hands = e.hands();
                let hand_ids: Vec<_> = hands.iter().map(|h| h.id).collect();
                Some(hand_ids)
            }
            _ => None,
        })
        .expect("No tracking event received");
    }
}