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
//! POD types for the screen-capture surface
//! (SUPER_PLAN_2 §4 Priority 6 + research/01).
//!
//! Symmetric to the camera surface: screen capture is a "dumb widget"
//! (`azul_layout::widgets::screencap::ScreenCaptureWidget`) that owns a
//! background capture thread + a GL-texture `ImageRef`, identical to the
//! camera widget — only the *source* differs (a display / window instead of
//! a camera). Defined here in `azul-core` so the config types cross the FFI
//! without `azul-layout` (or ScreenCaptureKit / MediaProjection / PipeWire)
//! as a dependency.
//!
//! Reuses the camera surface's generic capture status types
//! ([`crate::camera::StreamState`], `CaptureStats`, `CaptureStreamId`,
//! `CaptureErrorCode`) — those are capture-agnostic.
use crate::resources::RawImageFormat;
/// What to capture.
#[repr(C, u8)]
#[derive(Debug, Clone, Copy, PartialEq)]
pub enum ScreenCaptureSource {
/// The primary display (the default).
PrimaryDisplay,
/// A specific display by index (0-based).
Display(u32),
/// A specific window by its platform id / handle.
Window(u64),
}
impl Default for ScreenCaptureSource {
fn default() -> Self {
ScreenCaptureSource::PrimaryDisplay
}
}
/// Requested screen-capture configuration — the input to the screencap
/// widget. Zero `fps` means "let the backend pick its default".
#[repr(C)]
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct ScreenCaptureConfig {
/// What to capture (display / window).
pub source: ScreenCaptureSource,
/// Preferred frame rate (0 = backend default).
pub fps: u32,
/// Texture format the backend should deliver. `BGRA8` is the portable
/// default; `Nv12` (a later `RawImageFormat` addition) is the zero-copy
/// path on platforms that produce it natively.
pub output_format: RawImageFormat,
}
impl Default for ScreenCaptureConfig {
fn default() -> Self {
Self {
source: ScreenCaptureSource::PrimaryDisplay,
fps: 0,
output_format: RawImageFormat::BGRA8,
}
}
}
impl ScreenCaptureConfig {
/// A default config for the given `source` (backend-chosen fps, `BGRA8`).
pub fn new(source: ScreenCaptureSource) -> Self {
Self {
source,
..Self::default()
}
}
}