visual-cortex-capture 0.2.0

Screen-capture abstraction for visual-cortex: frames, regions, rates, the FrameSource trait, and the macOS ScreenCaptureKit backend.
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

/// What to capture: a display by index, or a window matched by exact title.
///
/// Construction is infallible — a matching window need not exist yet (it may
/// appear later and reattach). Resolution failure surfaces at capture time as
/// [`CaptureError::TargetNotFound`](crate::CaptureError::TargetNotFound).
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum Target {
    /// The Nth display reported by the platform (0 = first).
    Display(usize),
    /// The first window whose title matches exactly.
    WindowTitled(String),
}

impl Target {
    /// Capture the display at `index` (0 = first).
    pub fn display(index: usize) -> Self {
        Target::Display(index)
    }

    /// Capture the first window whose title exactly equals `title`.
    pub fn window_titled(title: impl Into<String>) -> Self {
        Target::WindowTitled(title.into())
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn constructors_build_expected_variants() {
        assert_eq!(Target::display(2), Target::Display(2));
        assert_eq!(
            Target::window_titled("Elden Ring"),
            Target::WindowTitled("Elden Ring".to_string())
        );
    }
}