From a885c9a70d8e054ef5f6fd5515819dd709710c37 Mon Sep 17 00:00:00 2001 From: nashaofu Date: Mon, 29 Jan 2024 09:46:10 +0800 Subject: [PATCH] =?UTF-8?q?chore:=20=E4=BF=AE=E6=94=B9=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Cargo.toml | 4 +- README-zh_CN.md | 118 ++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 26 ++++++----- 3 files changed, 134 insertions(+), 14 deletions(-) create mode 100644 README-zh_CN.md diff --git a/Cargo.toml b/Cargo.toml index 85bd006..c3265c1 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,8 +1,8 @@ [package] name = "xcap" -version = "0.0.2" +version = "0.0.3" edition = "2021" -description = "A cross-platform screen capture library" +description = "XCap is a cross-platform screen capture library written in Rust. It supports Linux (X11, Wayland), MacOS, and Windows. XCap supports screenshot and video recording (to be implemented)." license = "Apache-2.0" documentation = "https://docs.rs/xcap" homepage = "https://github.com/nashaofu/xcap" diff --git a/README-zh_CN.md b/README-zh_CN.md new file mode 100644 index 0000000..e971fce --- /dev/null +++ b/README-zh_CN.md @@ -0,0 +1,118 @@ +# XCap + +[English](README.md) | 简体中文 + +XCap 是一个使用 Rust 编写的跨平台的屏幕捕获库,它支持 Linux(X11,Wayland)、MacOS 与 Windows。XCap 支持截图与视频录制(待实现)。 + +## 功能 + +- 跨平台: 支持 Linux(X11,Wayland)、MacOS 与 Windows。 +- 支持多种截图模式: 可以对屏幕与窗口进行截图。 +- 支持视频录制:支持对屏幕或窗口进行录制(待实现)。 + +## 例子 + +- 屏幕截图 + +```rust +use std::time::Instant; +use xcap::Monitor; + +fn normalized(filename: &str) -> String { + filename + .replace("|", "") + .replace("\\", "") + .replace(":", "") + .replace("/", "") +} + +fn main() { + let start = Instant::now(); + let monitors = Monitor::all().unwrap(); + + for monitor in monitors { + let image = monitor.capture_image().unwrap(); + + image + .save(format!("target/monitor-{}.png", normalized(monitor.name()))) + .unwrap(); + } + + println!("运行耗时: {:?}", start.elapsed()); +} +``` + +- 窗口截图 + +```rust +use std::time::Instant; +use xcap::Window; + +fn normalized(filename: &str) -> String { + filename + .replace("|", "") + .replace("\\", "") + .replace(":", "") + .replace("/", "") +} + +fn main() { + let start = Instant::now(); + let windows = Window::all().unwrap(); + + let mut i = 0; + + for window in windows { + // 最小化的窗口不能截屏 + if window.is_minimized() { + continue; + } + + println!( + "Window: {:?} {:?} {:?}", + window.title(), + (window.x(), window.y(), window.width(), window.height()), + (window.is_minimized(), window.is_maximized()) + ); + + let image = window.capture_image().unwrap(); + image + .save(format!( + "target/window-{}-{}.png", + i, + normalized(window.title()) + )) + .unwrap(); + + i += 1; + } + + println!("运行耗时: {:?}", start.elapsed()); +} +``` + +## Linux 系统要求 + +在 Linux 上,需要安装 `libxcb`, `libxrandr`与 `dbus`. + +Debian/Ubuntu: + +```sh +apt-get install libxcb1 libxrandr2 libdbus-1-3 +``` + +Alpine: + +```sh +apk add libxcb libxrandr dbus +``` + +ArchLinux: + +```sh +pacman -S libxcb libxrandr dbus +``` + +## License + +本项目采用 Apache 许可证。详情请查看 [LICENSE](./LICENSE) 文件。 diff --git a/README.md b/README.md index 70951a1..7a298b7 100644 --- a/README.md +++ b/README.md @@ -1,20 +1,22 @@ -# 📷 XCap +# XCap -XCap is a cross-platform screen capture library for MacOS, Windows, Linux (X11, Wayland) written in Rust. It provides a simple API for capturing screen capture of a screen or a specific area of a screen. +English | [简体中文](README-zh_CN.md) + +XCap is a cross-platform screen capture library written in Rust. It supports Linux (X11, Wayland), MacOS, and Windows. XCap supports screenshot and video recording (to be implemented). ## Features -- Cross-platform support: Windows Mac and Linux. -- Multiple capture modes: screen window. -- Video capture、audio capture soon. +- Cross-platform: Supports Linux (X11, Wayland), MacOS, and Windows. +- Supports multiple screenshot modes: Can take screenshots of the screen and windows. +- Supports video recording: Supports recording of the screen or window (to be implemented). -## Example +## Examples -- Monitor capture +- Screen Capture ```rust -use xcap::Monitor; use std::time::Instant; +use xcap::Monitor; fn normalized(filename: &str) -> String { filename @@ -40,11 +42,11 @@ fn main() { } ``` -- Window capture +- Window Capture ```rust -use xcap::Window; use std::time::Instant; +use xcap::Window; fn normalized(filename: &str) -> String { filename @@ -89,7 +91,7 @@ fn main() { } ``` -## Linux Requirements +## Linux System Requirements On Linux, you need to install `libxcb`, `libxrandr`, and `dbus`. @@ -113,4 +115,4 @@ pacman -S libxcb libxrandr dbus ## License -This project is licensed under the Apache License. See the [LICENSE](../LICENSE) file for details. +This project is licensed under the Apache License. See the [LICENSE](./LICENSE) file for details.