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
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
122
123
124
125
126
127

use derive_deref::Deref;
use leap_sys::*;

use crate::{BoneRef, DigitRef, PalmRef};

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
#[doc = " The Hand chirality types."]
#[doc = " Used in the LEAP_HAND struct."]
#[doc = " @since 3.0.0"]
pub enum HandType {
    #[doc = " A left hand. @since 3.0.0"]
    Left,
    #[doc = " A right hand. @since 3.0.0"]
    Right,
}

#[doc = " Describes a tracked hand. @since 3.0.0"]
#[derive(Deref, Clone, Copy)]
/// # Fields
/// Available via dereference: [LEAP_HAND].
pub struct HandRef<'a>(pub(crate) &'a LEAP_HAND);

impl<'a> HandRef<'a> {
    #[doc = " Identifies the chirality of this hand. @since 3.0.0"]
    pub fn hand_type(&self) -> HandType {
        match self.type_ {
            leap_sys::_eLeapHandType_eLeapHandType_Left => HandType::Left,
            leap_sys::_eLeapHandType_eLeapHandType_Right => HandType::Right,
            _ => unreachable!(),
        }
    }

    #[doc = " Additional information associated with the palm. @since 3.0.0"]
    pub fn palm(&self) -> PalmRef {
        PalmRef(&self.palm)
    }

    #[doc = " The arm to which this hand is attached."]
    #[doc = " An arm consists of a single LEAP_BONE struct."]
    #[doc = " @since 3.0.0"]
    pub fn arm(&self) -> BoneRef {
        BoneRef(&self.arm)
    }

    #[doc = " The fingers of the hand as an array. @since 3.0.0"]
    pub fn digits(&self) -> [DigitRef; 5] {
        let digits;
        unsafe {
            digits = &self.__bindgen_anon_1.digits;
        }
        [
            DigitRef(&digits[0]),
            DigitRef(&digits[1]),
            DigitRef(&digits[2]),
            DigitRef(&digits[3]),
            DigitRef(&digits[4]),
        ]
    }

    #[doc = " The thumb. @since 3.0.0"]
    pub fn thumb(&self) -> DigitRef {
        unsafe { DigitRef(&self.__bindgen_anon_1.__bindgen_anon_1.thumb) }
    }

    #[doc = " The index finger. @since 3.0.0"]
    pub fn index(&self) -> DigitRef {
        unsafe { DigitRef(&self.__bindgen_anon_1.__bindgen_anon_1.index) }
    }

    #[doc = " The middle finger. @since 3.0.0"]
    pub fn middle(&self) -> DigitRef {
        unsafe { DigitRef(&self.__bindgen_anon_1.__bindgen_anon_1.middle) }
    }

    #[doc = " The ring finger. @since 3.0.0"]
    pub fn ring(&self) -> DigitRef {
        unsafe { DigitRef(&self.__bindgen_anon_1.__bindgen_anon_1.ring) }
    }

    #[doc = " The pinky finger. @since 3.0.0"]
    pub fn pinky(&self) -> DigitRef {
        unsafe { DigitRef(&self.__bindgen_anon_1.__bindgen_anon_1.pinky) }
    }
}

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

    #[test]
    fn get_all_hand_bones() {
        let mut connection = initialize_connection();
        connection
            .wait_for(|e| match e {
                EventRef::Tracking(e) => {
                    let hands = e.hands();
                    if hands.is_empty() {
                        println!("Warning: Put hands in front of the sensor for this test.");
                    }

                    let digits_by_array = hands.iter().flat_map(|h| h.digits());

                    let digits_by_name = hands
                        .iter()
                        .flat_map(|h| [h.thumb(), h.index(), h.middle(), h.ring(), h.pinky()]);

                    for digit in digits_by_array.chain(digits_by_name) {
                        let bones_by_array = digit.bones();
                        let bones_by_name = [
                            digit.proximal(),
                            digit.intermediate(),
                            digit.proximal(),
                            digit.distal(),
                        ];

                        for bone in bones_by_array.iter().chain(bones_by_name.iter()) {
                            assert!(bone.width > 0.0);
                        }
                    }
                    Some(())
                }
                _ => None,
            })
            .expect("No hand in view");
    }
}