README.md

screenshots

A cross-platform screenshots library for MacOS、Windows、Linux(X11、wayland).

example

use screenshots::Screen;
use std::{fs, time::Instant};

fn main() {
  let start = Instant::now();
  let screens = Screen::all().unwrap();

  for screen in screens {
    println!("capturer {:?}", screen);
    let mut image = screen.capture().unwrap();
    let mut buffer = image.buffer();
    fs::write(format!("target/{}.png", screen.display_info.id), &buffer).unwrap();

    image = screen.capture_area(300, 300, 300, 300).unwrap();
    buffer = image.buffer();
    fs::write(format!("target/{}-2.png", screen.display_info.id), &buffer).unwrap();
  }

  let screen = Screen::from_point(100, 100).unwrap();
  println!("capturer {:?}", screen);

  let image = screen.capture_area(300, 300, 300, 300).unwrap();
  let buffer = image.buffer();
  fs::write("target/capture_display_with_point.png", &buffer).unwrap();

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

API

Screen: Screen capturer

• Screen::new(display_info): Get screen from display info, return Screen.
• Screen::all(): Get all screen, return Result<Vec<Screen>>.
• Screen::from_point(x, y): Get screen from point, return Result<Screen>.
• screen.capture(): capture screen screenshot image, return Result<Image>.
• screen.capture_area(x, y, width, height): Capture the current screen the designated area, return Result<Image>.

Image: Screen screenshot image

• Image::new(width, height, buffer): Get image from width、height and rgba buffer, return Image.
• Image::from_bgra(width, height, buffer): Get image from width、height and bgra buffer, return Result<Image, EncodingError>.
• image.width(): Get image width, return u32.
• image.height(): Get image height, return u32.
• image.buffer(): Get image buffer, return Vec<u8>.

Linux requirements

On Linux, you need to install libxcb、libxrandr、dbus

Debian/Ubuntu:

apt-get install libxcb1 libxrandr2 libdbus-1-3

Alpine:

apk add libxcb libxrandr dbus