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

use crate::{FrameHeaderRef, ImageRef};
use derive_deref::Deref;
use leap_sys::LEAP_IMAGE_EVENT;

#[doc = " Streaming stereo image pairs from the device."]
#[doc = ""]
#[doc = " LeapPollConnection() produces this message when an image is available."]
#[doc = " The struct contains image properties, the distortion grid, and a pointer to"]
#[doc = " the buffer containing the image data -- which was allocated using the allocator"]
#[doc = " function passed to LeapC using the LeapSetAllocator."]
#[doc = " @since 4.0.0"]
/// # Fields
/// Available via dereference: [LEAP_IMAGE_EVENT].
#[derive(Deref, Clone, Copy)]
pub struct ImageEventRef<'a>(pub(crate) &'a LEAP_IMAGE_EVENT);

impl<'a> ImageEventRef<'a> {
    #[doc = " The information header identifying the images tracking frame."]
    pub fn info(&self) -> FrameHeaderRef {
        FrameHeaderRef(&self.info)
    }

    #[doc = " The left and right images."]
    pub fn images(&self) -> [ImageRef; 2] {
        [(ImageRef(&self.image[0])), (ImageRef(&self.image[1]))]
    }
}

#[cfg(test)]
mod tests {
    pub use crate::tests::*;
    pub use crate::*;
    #[test]
    pub fn receive_image() {
        let mut connection = initialize_connection();

        connection
            .set_policy_flags(PolicyFlags::IMAGES, PolicyFlags::empty())
            .expect("Failed to set policy flags");

        let (width, height, data, _frame_id) = connection
            .wait_for(|e| match e {
                EventRef::Image(e) => {
                    let right_image = &e.images()[1];
                    let data = right_image.data();
                    let width = right_image.properties().width;
                    let height = right_image.properties().height;
                    let _distortion_matrix = right_image.distorion_matrix();
                    Some((width, height, data.to_vec(), e.info().frame_id))
                }
                _ => None,
            })
            .expect("Did not receive an image");

        let temp_dir = tempfile::tempdir().expect("Failed to create a temp dir");
        let mut path = temp_dir.into_path();
        path.push("image.png");
        ::image::save_buffer(
            path.to_str().unwrap(),
            &data,
            width,
            height,
            ::image::ColorType::L8,
        )
        .expect("failed to save buffer");

        connection
            .set_policy_flags(PolicyFlags::empty(), PolicyFlags::IMAGES)
            .expect("Failed to set policy flags");
    }
}