dais-core 0.1.0

Core types, command bus, and state machine for Dais
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

//! Monitor management trait and types.
//!
//! Platform-specific implementations live in `dais-platform`.
//! The trait is defined here so both platform backends and the engine can use it.

/// Information about a connected display monitor.
#[derive(Debug, Clone)]
pub struct MonitorInfo {
    /// Unique identifier for this monitor (platform-specific).
    pub id: String,
    /// Human-readable name (e.g., "DELL U2718Q").
    pub name: String,
    /// Position on the virtual desktop, top-left corner (pixels).
    pub position: (i32, i32),
    /// Physical resolution (width, height in pixels).
    pub size: (u32, u32),
    /// Usable work area on the virtual desktop, excluding taskbars/docks
    /// where the platform can provide it. Stored as (x, y, width, height)
    /// in physical pixels.
    pub work_area: (i32, i32, u32, u32),
    /// DPI scale factor (1.0 = 96dpi, 2.0 = Retina/HiDPI).
    pub scale_factor: f64,
    /// Whether this is the OS primary monitor.
    pub is_primary: bool,
}

impl MonitorInfo {
    /// The effective logical size (physical size / scale factor).
    pub fn logical_size(&self) -> (f64, f64) {
        (f64::from(self.size.0) / self.scale_factor, f64::from(self.size.1) / self.scale_factor)
    }

    /// The effective logical work area (physical work area / scale factor).
    pub fn logical_work_area(&self) -> (f64, f64, f64, f64) {
        (
            f64::from(self.work_area.0) / self.scale_factor,
            f64::from(self.work_area.1) / self.scale_factor,
            f64::from(self.work_area.2) / self.scale_factor,
            f64::from(self.work_area.3) / self.scale_factor,
        )
    }
}

/// Trait for platform-specific monitor enumeration.
///
/// Separate implementations are compiled via `cfg` for each platform
/// in the `dais-platform` crate.
pub trait MonitorManager: Send + Sync {
    /// Enumerate all currently connected monitors.
    fn available_monitors(&self) -> Vec<MonitorInfo>;

    /// Get the primary monitor, if one is designated.
    fn primary_monitor(&self) -> Option<MonitorInfo> {
        self.available_monitors().into_iter().find(|m| m.is_primary)
    }

    /// Get a non-primary monitor (for audience display in dual mode).
    fn secondary_monitor(&self) -> Option<MonitorInfo> {
        self.available_monitors().into_iter().find(|m| !m.is_primary)
    }

    /// Find a monitor by name (for config-based assignment).
    fn find_by_name(&self, name: &str) -> Option<MonitorInfo> {
        self.available_monitors().into_iter().find(|m| m.name == name)
    }

    /// Find a monitor by a user-facing selector.
    ///
    /// Supported forms:
    /// - Exact monitor name
    /// - Exact monitor id
    /// - 1-based ordinal like "1", "2", "3" using the detected monitor list order
    fn find_by_selector(&self, selector: &str) -> Option<MonitorInfo> {
        let monitors = self.available_monitors();

        if let Ok(index) = selector.parse::<usize>()
            && index > 0
        {
            return monitors.get(index - 1).cloned();
        }

        monitors.iter().find(|m| m.name == selector || m.id == selector).cloned()
    }
}