cameras 0.3.1

A cross-platform camera library for Rust, built with data-oriented design. Explicit format negotiation, push-based frame delivery, typed errors, and zero trait objects.
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

//! Hardware-accelerated H.264 / H.265 decoders for the RTSP backend.
//!
//! Each platform has a native path:
//!
//! - macOS: `VideoToolbox` via `objc2-video-toolbox`
//! - Windows: `Media Foundation` `IMFTransform` via the `windows` crate
//! - Linux: `VA-API` via `cros-libva`
//!
//! Decoders accept AVCC-formatted NAL units (length-prefixed, as delivered by
//! `retina`) plus codec extradata (SPS/PPS parsed from the SDP) and produce
//! BGRA [`Frame`]s through the same channel USB backends use.

use crate::error::Error;
use crate::types::Frame;
use std::time::Duration;

/// Which video codec the decoder is configured for.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub enum VideoCodec {
    /// H.264 / AVC
    H264,
    /// H.265 / HEVC
    H265,
}

/// Platform decoder contract.
///
/// Concrete implementations hold platform-specific state
/// (`VTDecompressionSession`, `IMFTransform`, VA-API context). Construction
/// prepares the decoder from extradata; `decode` accepts one NAL unit payload
/// and returns every BGRA frame that is ready to deliver.
pub(crate) trait VideoDecoder: Send {
    fn new(codec: VideoCodec, extradata: &[u8]) -> Result<Self, Error>
    where
        Self: Sized;

    fn decode(&mut self, nal: &[u8], timestamp: Duration) -> Result<Vec<Frame>, Error>;
}

#[cfg(target_os = "macos")]
mod macos;

#[cfg(target_os = "windows")]
mod windows;

#[cfg(target_os = "macos")]
pub(crate) type Decoder = macos::VideoToolboxDecoder;

#[cfg(target_os = "windows")]
pub(crate) type Decoder = windows::MediaFoundationDecoder;