ImageKit:Rust 编写的一个强大、快速且灵活的命令行工具,用于批量处理图片
ImageKit 是一个强大、快速且灵活的命令行工具,用于批量处理图片。它使用 Rust 编写,通过并行处理来最大化性能,让你能轻松地对整个目录的图片进行尺寸调整、质量控制和添加高度可定制的水印。
功能特性
- 批量处理: 递归地处理指定输入目录下的所有图片 (
.jpg,.jpeg,.png,.gif,.bmp,.webp)。 - 智能缩放:
- 如果只提供宽度,则自动按比例计算高度,保证图片不变形。
- 如果只提供高度,则自动按比例计算宽度。
- 质量控制: 使用
-q或--quality参数(1-100)微调输出质量,在文件大小和视觉保真度之间取得平衡。设置为100可获得最佳质量。 - 强大的水印功能:
- 多语言支持: 完美渲染混合文本水印,支持全球主要书写系统,包括拉丁文(用于英语、法语、西班牙语)、西里尔文(用于俄语)、泰文以及中日韩统一表意文字。
- 高度可定制: 在图片的九个标准位置添加文本,并自由设置字体大小。
- 自定义颜色: 通过十六进制色码(如
RRGGBB或RRGGBBAA)精确控制水印颜色和透明度。 - 智能缩放: 如果请求的水印对于图片来说过大,工具会自动缩小水印以确保其完整显示,永不裁切。
- ⚡ 极速性能: 利用 Rayon 库并行处理图片,充分利用多核 CPU 的性能。
- 跨平台: 可在 Windows, macOS, 和 Linux 上编译和运行。
🚀 使用方法
示例
示例 1: 添加包含中英文的水印
./target/release/imagekit \
-i example/img-src \
-o example/img-out \
--watermark-text "你好, World! - 印记"
示例 2: 缩放图片并以最高质量保存
如果你希望调整尺寸但不损失图片质量,请使用 --quality 100。
./target/release/imagekit -i example/img-src -o example/img-out --width 1024 --quality 100
示例 3: 添加一个不透明的黑色水印(使用默认质量 85)
./target/release/imagekit \
-i example/img-src \
-o example/img-out \
--watermark-text "@机密文件" \
--watermark-color 000000FF
📋 命令行选项
| 选项 | 标志 | 描述 | 必需/可选 | 默认值 |
|---|---|---|---|---|
| 输入目录 | -i, --input-dir |
包含需要处理的图片的源目录。 | 必需 | - |
| 输出目录 | -o, --output-dir |
用于存放处理后图片的目录。 | 必需 | - |
| 宽度 | --width |
(可选)调整图片的宽度。若不提供高度,则按比例缩放。 | 可选 | 原始宽度 |
| 高度 | --height |
(可选)调整图片的高度。若不提供宽度,则按比例缩放。 | 可选 | 原始高度 |
| 水印文字 | --watermark-text |
(可选)要添加的水印文字内容。 | 可选 | - |
| 水印位置 | --watermark-position |
(可选)水印在图片上的位置。 | 可选 | se |
| 字体大小 | --font-size |
(可选)水印文字的大小(单位:像素)。 | 可选 | 24 |
| 水印颜色 | --watermark-color |
(可选)水印颜色,格式为 RRGGBB 或 RRGGBBAA。 | 可选 | FFFFFF80 (半透明白) |
| 质量 | -q, --quality |
(可选)设置输出质量(1-100)。对于JPEG,影响压缩率;对于PNG,影响压缩速度。 | 可选 | 85 |
| 输出格式 | --output-format |
(可选)指定输出图片的格式。 | 可选 | 原始格式 |
watermark-position 的可用值:
nw: 左上,north: 中上,ne: 右上west: 中左,center: 居中,east: 中右sw: 左下,south: 中下,se: 右下
详情见:https://github.com/hzbd/imagekit/blob/master/README-zh.md
