eye 0.5.0

Cross platform camera capture and control
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 eye_hal::format::PixelFormat;

mod error;
mod rgb;
mod yuv;

#[cfg(feature = "jpeg")]
mod jpeg;

pub use error::{Error, ErrorKind, Result};

/// Returns all available blueprints.
pub fn blueprints() -> Vec<Box<dyn Blueprint>> {
    vec![
        Box::new(rgb::blueprint()),
        #[cfg(feature = "jpeg")]
        Box::new(jpeg::blueprint()),
        Box::new(yuv::blueprint()),
    ]
}

/// Codec blueprint.
///
/// Allows you to identify the codecs' capabilities and instantiate it.
pub trait Blueprint {
    /// Instantiate the codec with a given set of parameters.
    fn instantiate(
        &self,
        inparams: Parameters,
        outparams: Parameters,
    ) -> Result<Box<dyn Codec + Send>>;

    /// Returns all available input formats.
    fn src_fmts(&self) -> Vec<PixelFormat>;

    /// Returns all available output formats.
    fn dst_fmts(&self) -> Vec<PixelFormat>;
}

pub trait Codec {
    /// Convert the input buffer using the output buffer as destination.
    fn decode(&self, inbuf: &[u8], outbuf: &mut Vec<u8>) -> Result<()>;
}

/// Codec parameters used for instantiation.
#[derive(Debug, Clone)]
pub struct Parameters {
    pub pixfmt: PixelFormat,
    pub width: u32,
    pub height: u32,
}