framewatch 0.6.0

Event-driven, change-triggered window capture that emits timestamped screenshots + metadata for AI agents.
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

//! Shared helpers for the integration tests: synthetic BGRA frame builders.
#![allow(dead_code, clippy::too_many_arguments)]

use chrono::{DateTime, Duration as ChronoDuration, TimeZone, Utc};
use framewatch::{RawFrame, WindowInfo};
use std::sync::Arc;
use std::time::{Duration, Instant};

pub const W: u32 = 320;
pub const H: u32 = 180;

/// A fixed wall-clock base so golden output is deterministic.
pub fn base_wall() -> DateTime<Utc> {
    Utc.with_ymd_and_hms(2026, 6, 13, 15, 4, 5).unwrap()
}

/// A tightly-packed BGRA buffer filled with one color `(b, g, r)`.
pub fn solid(b: u8, g: u8, r: u8) -> Vec<u8> {
    let mut buf = vec![0u8; (W * H * 4) as usize];
    for px in buf.chunks_exact_mut(4) {
        px[0] = b;
        px[1] = g;
        px[2] = r;
        px[3] = 255;
    }
    buf
}

/// Paint a filled rectangle (pixel coords) into a BGRA buffer.
pub fn paint_rect(buf: &mut [u8], x: u32, y: u32, w: u32, h: u32, b: u8, g: u8, r: u8) {
    for yy in y..(y + h).min(H) {
        for xx in x..(x + w).min(W) {
            let off = ((yy * W + xx) * 4) as usize;
            buf[off] = b;
            buf[off + 1] = g;
            buf[off + 2] = r;
            buf[off + 3] = 255;
        }
    }
}

/// A monotonic clock base for frame timing.
pub fn base_instant() -> Instant {
    Instant::now()
}

/// Build a frame at `t_ms` after the bases.
pub fn frame_at(buf: Vec<u8>, base: Instant, t_ms: u64) -> (RawFrame, Instant) {
    let now = base + Duration::from_millis(t_ms);
    let f = RawFrame {
        buffer: Arc::from(buf.into_boxed_slice()),
        width: W,
        height: H,
        stride: W * 4,
        captured_at: now,
        wall_time: base_wall() + ChronoDuration::milliseconds(t_ms as i64),
        window: window_info(),
    };
    (f, now)
}

/// A stable synthetic window descriptor.
pub fn window_info() -> WindowInfo {
    WindowInfo {
        hwnd: 67890,
        title: "Build — myapp — Visual Studio Code".to_string(),
        exe: "Code.exe".to_string(),
        class: "Chrome_WidgetWin_1".to_string(),
        rect: framewatch::Rect::new(0, 0, W, H),
        client_rect: framewatch::Rect::new(0, 0, W, H),
        dpi: 96,
        foreground: true,
    }
}