开源一个rust编写的图片压缩和打水印的小工具 - imagekit，支持批量处理

气氛小组长
244 阅读3分钟

ImageKit

github.com/hzbd/imagek…

Build Status License: MIT Rust Version

ImageKit 是一个强大、快速且灵活的命令行工具，用于批量处理图片。它使用 Rust 编写，通过并行处理来最大化性能，让你能轻松地对整个目录的图片进行尺寸调整、质量控制和添加高度可定制的水印。

🌟 功能特性

  • 批量处理: 递归地处理指定输入目录下的所有图片 (.jpg, .jpeg, .png, .gif, .bmp)。
  • 智能缩放:
    • 如果只提供宽度，则自动按比例计算高度，保证图片不变形。
    • 如果只提供高度，则自动按比例计算宽度。
  • 质量控制: 使用 -q 或 --quality 参数（1-100）微调输出质量，在文件大小和视觉保真度之间取得平衡。设置为 100 可获得最佳质量。
  • 强大的水印功能:
    • 多语言支持: 完美支持包含中文、日文、韩文及其他各种语言的混合文本水印。
    • 高度可定制: 在图片的九个标准位置添加文本，并自由设置字体大小。
    • 自定义颜色: 通过十六进制色码（如 RRGGBB 或 RRGGBBAA）精确控制水印颜色和透明度。
    • 智能缩放: 如果请求的水印对于图片来说过大，工具会自动缩小水印以确保其完整显示，永不裁切。
  • ⚡ 极速性能: 利用 Rayon 库并行处理图片，充分利用多核 CPU 的性能。
  • 跨平台: 可在 Windows, macOS, 和 Linux 上编译和运行。

⚙️ 安装与构建

你需要先安装 Rust 和 Cargo。

  1. 克隆仓库

    git clone https://github.com/hzbd/imagekit.git
cd imagekit

  2. 准备字体 本工具使用字体回退机制来支持多语言。请确保 assets/ 目录下包含：

    • Roboto-Regular.ttf (用于西文)
    • 一个包含 CJK 字符的字体，如 SourceHanSansSC-Regular.otf (思源黑体)。您可以从 Adobe Fonts GitHub 下载。

  3. 构建项目

    cargo build --release

  4. 找到可执行文件 构建完成后，可执行文件位于 target/release/ 目录下。

🚀 使用方法

示例

示例 1: 添加包含中英文的水印
./target/release/imagekit \
    -i ./input_photos \
    -o ./processed_photos \
    --watermark-text "你好, World! - 测试水印"
示例 2: 缩放图片并以最高质量保存

如果你希望调整尺寸但不损失图片质量，请使用 --quality 100。

./target/release/imagekit -i ./input_photos -o ./processed_photos --width 1024 --quality 100
示例 3: 添加一个不透明的黑色水印（使用默认质量 85）
./target/release/imagekit \
    -i ./input_photos \
    -o ./processed_photos \
    --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
watermark-position 的可用值:
  • nw: 左上, north: 中上, ne: 右上
  • west: 中左, center: 居中, east: 中右
  • sw: 左下, south: 中下, se: 右下

🛠️ 开发与测试

如果你想为此项目贡献代码，可以按以下步骤操作：

  1. 克隆仓库并准备字体。
  2. 做出你的修改。
  3. 运行测试以确保所有功能正常： 
    cargo test

📜 许可证

本项目使用 MIT 许可证。

avatar
文章
阅读
粉丝