media-device 0.9.1

A cross-platform wrapper for capture and playback devices
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

use cfg_if::cfg_if;
use media_core::{
    video::{ColorRange, VideoFormat},
    Result,
};

use crate::{DeviceEvent, DeviceManager};

cfg_if! {
    if #[cfg(target_os = "windows")] {
        pub use crate::backend::media_foundation::MediaFoundationDeviceManager as DefaultCameraManager;
    } else if #[cfg(any(target_os = "macos", target_os = "ios"))] {
        pub use crate::backend::av_foundation::AVFoundationCaptureDeviceManager as DefaultCameraManager;
    } else {
        compile_error!("unsupported target");
    }
}

#[derive(Clone, Debug)]
pub(crate) struct CameraFormat {
    pub format: VideoFormat,
    pub color_range: ColorRange,
    pub width: u32,
    pub height: u32,
    pub frame_rates: Vec<f32>,
}

pub struct CameraManager<T: DeviceManager> {
    backend: T,
}

impl<T: DeviceManager> CameraManager<T> {
    pub fn new() -> Result<Self> {
        let mut backend = T::init()?;
        backend.refresh()?;
        Ok(Self {
            backend,
        })
    }

    pub fn index(&self, index: usize) -> Option<&T::DeviceType> {
        self.backend.index(index)
    }

    pub fn index_mut(&mut self, index: usize) -> Option<&mut T::DeviceType> {
        self.backend.index_mut(index)
    }

    pub fn lookup(&self, id: &str) -> Option<&T::DeviceType> {
        self.backend.lookup(id)
    }

    pub fn lookup_mut(&mut self, id: &str) -> Option<&mut T::DeviceType> {
        self.backend.lookup_mut(id)
    }

    pub fn iter(&self) -> T::Iter<'_> {
        self.backend.iter()
    }

    pub fn iter_mut(&mut self) -> T::IterMut<'_> {
        self.backend.iter_mut()
    }

    pub fn refresh(&mut self) -> Result<()> {
        self.backend.refresh()
    }

    pub fn set_change_handler<F>(&mut self, handler: F) -> Result<()>
    where
        F: Fn(&DeviceEvent) + Send + Sync + 'static,
    {
        self.backend.set_change_handler(handler)
    }
}

impl<T: DeviceManager> Drop for CameraManager<T> {
    fn drop(&mut self) {
        self.backend.deinit();
    }
}

impl CameraManager<DefaultCameraManager> {
    pub fn new_default() -> Result<Self> {
        Self::new()
    }
}