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

use std::ops::Deref;

use crate::{sized_with_trailing_data::SizedWithTrailingData, FrameHeaderRef, HandRef};
use leap_sys::LEAP_TRACKING_EVENT;

/// # Fields
/// Available via dereference: [LEAP_TRACKING_EVENT].
pub struct InterpolationTrackingEvent(pub(crate) Box<SizedWithTrailingData<LEAP_TRACKING_EVENT>>);

impl InterpolationTrackingEvent {
    /// Allocate a LEAP_TRACKING_EVENT with more data contiguous to it.
    /// Unsafe: inner struct is uninitialized
    pub(crate) unsafe fn new_uninitialized(requested_frame_size: u64) -> Self {
        let trailing_size =
            requested_frame_size as usize - std::mem::size_of::<LEAP_TRACKING_EVENT>();
        Self(SizedWithTrailingData::allocate(
            std::mem::zeroed(),
            trailing_size,
        ))
    }

    #[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()
        }
    }
}

impl Deref for InterpolationTrackingEvent {
    type Target = LEAP_TRACKING_EVENT;

    fn deref(&self) -> &Self::Target {
        &self.0.sized
    }
}