oximedia-transcode 0.1.6

High-level transcoding pipeline for OxiMedia
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

//! Hardware probe trait and implementation stubs.
//!
//! [`HwProbe`] is a `Send + Sync` trait that abstracts platform detection.
//! [`SystemProbe`] dispatches to the OS-specific implementation at compile
//! time.  [`MockProbe`] is for use in unit tests.

use super::capabilities::HwAccelCapabilities;

// ─── HwProbe trait ───────────────────────────────────────────────────────────

/// Abstraction over hardware acceleration probing.
///
/// Implement this trait (or use [`MockProbe`]) to supply capability data
/// without touching OS APIs — useful for unit tests and deterministic CI.
pub trait HwProbe: Send + Sync {
    /// Probe the system and return discovered capabilities.
    fn probe(&self) -> HwAccelCapabilities;
}

// ─── SystemProbe ─────────────────────────────────────────────────────────────

/// Real system probe — dispatches to OS-specific code at compile time.
///
/// On macOS: parses `sysctl` output to identify the Apple Silicon/Intel
/// chip family, then returns a static codec table.
///
/// On Linux: walks `/sys/class/drm/` to find DRM devices, resolves vendor
/// IDs to driver families, and maps those to supported codecs.
///
/// On Windows / WASM / other: returns [`HwAccelCapabilities::none()`].
pub struct SystemProbe;

// ─── MockProbe ───────────────────────────────────────────────────────────────

/// A test double that returns a pre-built capability set.
///
/// ```
/// use oximedia_transcode::{HwAccelCapabilities, MockProbe, HwProbe};
///
/// let probe = MockProbe(HwAccelCapabilities::none());
/// assert!(probe.probe().is_empty());
/// ```
pub struct MockProbe(pub HwAccelCapabilities);

impl HwProbe for MockProbe {
    fn probe(&self) -> HwAccelCapabilities {
        self.0.clone()
    }
}

// ─── Platform dispatch ────────────────────────────────────────────────────────

#[cfg(target_os = "macos")]
impl HwProbe for SystemProbe {
    fn probe(&self) -> HwAccelCapabilities {
        crate::hw_accel::macos::probe_macos()
    }
}

#[cfg(target_os = "linux")]
impl HwProbe for SystemProbe {
    fn probe(&self) -> HwAccelCapabilities {
        crate::hw_accel::linux::probe_linux()
    }
}

#[cfg(target_os = "windows")]
impl HwProbe for SystemProbe {
    fn probe(&self) -> HwAccelCapabilities {
        tracing::warn!(
            "HW accel detection not yet implemented on Windows; \
             returning empty capabilities"
        );
        HwAccelCapabilities::none()
    }
}

#[cfg(target_arch = "wasm32")]
impl HwProbe for SystemProbe {
    fn probe(&self) -> HwAccelCapabilities {
        HwAccelCapabilities::none()
    }
}

#[cfg(not(any(
    target_os = "macos",
    target_os = "linux",
    target_os = "windows",
    target_arch = "wasm32"
)))]
impl HwProbe for SystemProbe {
    fn probe(&self) -> HwAccelCapabilities {
        HwAccelCapabilities::none()
    }
}