xcap

Use Window::all() to get a list of all open windows. You can iterate through them and use window.capture_image() to take a screenshot of each. Note that minimized windows cannot be captured; check window.is_minimized() before attempting a capture.

use fs_extra::dir;
use std::time::Instant;
use xcap::Window;

fn normalized(filename: &str) -> String {
    filename.replace(['|', '\', ':', '/'], "")
}

fn main() {
    let start = Instant::now();
    let windows = Window::all().unwrap();

    dir::create_all("target/windows", true).unwrap();

    let mut i = 0;
    for window in windows {
        // 最小化的窗口不能截屏
        if window.is_minimized().unwrap() {
            continue;
        }

        println!(
            "Window: {:?} {:?} {:?}",
            window.title().unwrap(),
            (
                window.x().unwrap(),
                window.y().unwrap(),
                window.width().unwrap(),
                window.height().unwrap()
            ),
            (
                window.is_minimized().unwrap(),
                window.is_maximized().unwrap()
            )
        );

        let image = window.capture_image().unwrap();
        image
            .save(format!(
                "target/windows/window-{}-{}.png",
                i,
                normalized(&window.title().unwrap())
            ))
            .unwrap();

        i += 1;
    }

    println!("运行耗时: {:?}", start.elapsed());
}

To record video, obtain a video recorder from a monitor using monitor.video_recorder(). This returns a tuple containing the video_recorder and a receiver sx (likely a channel) that emits video frames. You can then call .start() and .stop() on the recorder to control the recording lifecycle.

use std::{thread, time::Duration};
use xcap::Monitor;

fn main() {
    let monitor = Monitor::from_point(100, 100).unwrap();

    let (video_recorder, sx) = monitor.video_recorder().unwrap();

    thread::spawn(move || loop {
        match sx.recv() {
            Ok(frame) => {
                println!("frame: {:?}", frame.width);
            }
            _ => continue,
        }
    });

    println!("start");
    video_recorder.start().unwrap();
    thread::sleep(Duration::from_secs(2));
    println!("stop");
    video_recorder.stop().unwrap();
    thread::sleep(Duration::from_secs(2));
    println!("start");
    video_recorder.start().unwrap();
    thread::sleep(Duration::from_secs(2));
    println!("stop");
    video_recorder.stop().unwrap();
}

To capture a specific rectangular area of a monitor, use monitor.capture_region(x, y, width, height). This is useful for partial screenshots.

use fs_extra::dir;
use std::time::Instant;
use xcap::Monitor;

fn normalized(filename: String) -> String {
    filename.replace(['|', '\', ':', '/'], "")
}

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let monitors = Monitor::all()?;
    dir::create_all("target/monitors", true).unwrap();

    let monitor = monitors
        .into_iter()
        .find(|m| m.is_primary().unwrap_or(false))
        .expect("No primary monitor found");

    let monitor_width = monitor.width()?;
    let monitor_height = monitor.height()?;

    let region_width = 400u32;
    let region_height = 300u32;

    let x = ((monitor_width as i32) - (region_width as i32)) / 2;
    let y = ((monitor_height as i32) - (region_height as i32)) / 2;
    let start = Instant::now();

    let image = monitor.capture_region(x, y, region_width, region_height)?;
    println!(
        "Time to record region of size {}x{}: {:?}",
        image.width(),
        image.height(),
        start.elapsed()
    );

    image
        .save(format!(
            "target/monitors/monitor-{}-region.png",
            normalized(monitor.friendly_name().unwrap())
        ))
        .unwrap();

    Ok(())
}

The Monitor struct allows for both static image capture and video recording.

Static Image Capture

• capture_image(): Captures the entire monitor as an RgbaImage.
• capture_region(x, y, width, height): Captures a specific rectangular area of the monitor.
  • Note: If the requested region extends beyond the monitor's bounds, it will return an XCapError::InvalidCaptureRegion error.

Video Recording

• video_recorder(): Initializes a video recording session. It returns a tuple containing:
  1. A VideoRecorder instance to control the recording.
  2. A std::sync::mpsc::Receiver<Frame> used to receive individual video frames.

use xcap::Monitor;

let monitor = Monitor::all().unwrap()[0].clone();

// Capture a region
let img = monitor.capture_region(0, 0, 500, 500).unwrap();

// Start video recording
let (recorder, frame_receiver) = monitor.video_recorder().unwrap();
// Use recorder and frame_receiver to handle video stream...