macro
284 lines
6.8 KiB
Markdown
284 lines
6.8 KiB
Markdown
# cutpic - 图片裁切工具 🖼️
|
||
|
||
一个简单易用的命令行图片裁切工具，可以将图片按指定的行列数均匀分割成多个小图片。
|
||
|
||
## ✨ 功能特性
|
||
|
||
- 📐 **灵活分割**: 支持自定义水平和垂直分割数
|
||
- 🎯 **均匀裁切**: 自动计算每块尺寸，均匀分割图片
|
||
- 📁 **智能输出**: 默认在输入文件同级目录创建 dist 文件夹
|
||
- 🖼️ **多格式支持**: 支持 PNG, JPG, JPEG, BMP, GIF, WebP 等常见图片格式
|
||
- 🔢 **智能命名**: 自动生成带序号的文件名，方便识别和管理
|
||
- ⚡ **高性能**: 基于 Rust 开发，处理速度快
|
||
|
||
## 📦 安装
|
||
|
||
### 从源码编译
|
||
|
||
```bash
|
||
cd cutPic
|
||
cargo build --release
|
||
```
|
||
|
||
编译后的可执行文件位于 `target/release/cutpic.exe`
|
||
|
||
### 添加到系统路径（可选）
|
||
|
||
将 `target/release/cutpic.exe` 复制到系统 PATH 目录，或将其所在目录添加到 PATH 环境变量中。
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 基本用法
|
||
|
||
```bash
|
||
# 将图片分割成 3x2 的网格（共6块）
|
||
cutpic -i image.png -w 3 -h 2
|
||
|
||
# 将图片分割成 4x4 的网格（共16块）
|
||
cutpic -i photo.jpg -w 4 -h 4
|
||
```
|
||
|
||
### 指定输出目录
|
||
|
||
```bash
|
||
# 指定输出到 custom_output 目录
|
||
cutpic -i image.png -w 2 -h 2 --out ./custom_output
|
||
```
|
||
|
||
## 📖 命令参数
|
||
|
||
```bash
|
||
cutpic [OPTIONS] -i <INPUT>
|
||
|
||
参数:
|
||
-i, --input <FILE> 📁 输入图片路径（必需）
|
||
-w, --width <NUM> 📐 水平方向分割数（默认: 1）
|
||
-h, --height <NUM> 📏 垂直方向分割数（默认: 1）
|
||
--out <DIR> 📂 输出目录（默认: 输入文件同级的 dist 文件夹）
|
||
-h, --help 显示帮助信息
|
||
-V, --version 显示版本信息
|
||
```
|
||
|
||
## 💡 使用示例
|
||
|
||
### 示例 1: 制作拼图素材
|
||
|
||
将一张大图分割成 5x5 的拼图块：
|
||
|
||
```bash
|
||
cutpic -i puzzle.png -w 5 -h 5
|
||
```
|
||
|
||
**输出:**
|
||
- 生成 25 张图片
|
||
- 文件命名: `puzzle_1_25.png`, `puzzle_2_25.png`, ..., `puzzle_25_25.png`
|
||
- 输出位置: `./dist/` 目录
|
||
|
||
### 示例 2: 提取图标集中的单个图标
|
||
|
||
从 4x4 排列的图标集中提取每个图标：
|
||
|
||
```bash
|
||
cutpic -i icons.png -w 4 -h 4 --out ./individual_icons
|
||
```
|
||
|
||
**输出:**
|
||
- 生成 16 张单独的图标
|
||
- 输出到 `./individual_icons/` 目录
|
||
|
||
### 示例 3: 分割游戏精灵图（Sprite Sheet）
|
||
|
||
横向分割角色动画帧（8 帧动画）：
|
||
|
||
```bash
|
||
cutpic -i character.png -w 8 -h 1 --out ./animation_frames
|
||
```
|
||
|
||
**输出:**
|
||
- 生成 8 张动画帧图片
|
||
- 适合用于游戏开发中的帧动画
|
||
|
||
### 示例 4: 只进行水平分割
|
||
|
||
将横幅广告图分割成 4 部分：
|
||
|
||
```bash
|
||
cutpic -i banner.png -w 4 -h 1
|
||
```
|
||
|
||
### 示例 5: 只进行垂直分割
|
||
|
||
将长图分割成 3 段：
|
||
|
||
```bash
|
||
cutpic -i long-image.jpg -w 1 -h 3
|
||
```
|
||
|
||
## 📊 输出说明
|
||
|
||
### 文件命名规则
|
||
|
||
生成的文件遵循以下命名格式：
|
||
|
||
```
|
||
{原文件名}_{序号}_{总数}.{扩展名}
|
||
```
|
||
|
||
**示例:**
|
||
- 原文件: `image.png`
|
||
- 分割: 3x2 (共6块)
|
||
- 输出文件:
|
||
- `image_1_6.png` - 第1块
|
||
- `image_2_6.png` - 第2块
|
||
- ...
|
||
- `image_6_6.png` - 第6块
|
||
|
||
### 输出目录结构
|
||
|
||
```
|
||
项目目录/
|
||
├── image.png # 原始图片
|
||
└── dist/ # 默认输出目录
|
||
├── image_1_6.png
|
||
├── image_2_6.png
|
||
├── image_3_6.png
|
||
├── image_4_6.png
|
||
├── image_5_6.png
|
||
└── image_6_6.png
|
||
```
|
||
|
||
如果指定了 `--out` 参数：
|
||
|
||
```
|
||
项目目录/
|
||
├── image.png # 原始图片
|
||
└── my_output/ # 自定义输出目录
|
||
├── image_1_6.png
|
||
├── image_2_6.png
|
||
└── ...
|
||
```
|
||
|
||
## ⚙️ 工作原理
|
||
|
||
1. **加载图片**: 读取输入图片并获取尺寸信息
|
||
2. **计算尺寸**:
|
||
- 每块宽度 = 总宽度 ÷ 水平分割数
|
||
- 每块高度 = 总高度 ÷ 垂直分割数
|
||
3. **逐块裁切**: 按行列顺序遍历，裁切每一块
|
||
4. **处理边界**: 最后一行/列可能包含剩余像素，自动调整尺寸
|
||
5. **保存文件**: 按命名规则保存到输出目录
|
||
|
||
### 边界处理示例
|
||
|
||
假设图片尺寸为 100x100 像素，分割为 3x3：
|
||
|
||
- 理论每块: 33.33 x 33.33 像素
|
||
- 实际处理:
|
||
- 第1、2块: 33 x 33 像素
|
||
- 第3块: 34 x 34 像素（包含剩余像素）
|
||
|
||
这样确保所有像素都被保留，不会丢失任何内容。
|
||
|
||
## 🎯 应用场景
|
||
|
||
### 1. 游戏开发
|
||
- 分割 Sprite Sheet 为单独的动画帧
|
||
- 提取瓦片地图（Tilemap）的单个瓦片
|
||
- 处理角色、道具等资源图片
|
||
|
||
### 2. 网页设计
|
||
- 将大图分割成小块用于懒加载
|
||
- 制作图片拼图效果
|
||
- 优化大图的加载性能
|
||
|
||
### 3. 社交媒体
|
||
- 制作 Instagram 九宫格图片
|
||
- 分割长图为适合移动端查看的多张图片
|
||
- 创建有趣的图片分割效果
|
||
|
||
### 4. 数据处理
|
||
- 批量处理扫描文档
|
||
- 分割大幅面图纸
|
||
- 处理卫星图像或地图切片
|
||
|
||
### 5. 教育用途
|
||
- 制作教学用拼图
|
||
- 分解复杂图表
|
||
- 创建互动学习材料
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
1. **图片格式**: 输出格式与输入格式相同
|
||
2. **最小分割**: 分割数为 1x1 时，会生成原图的副本
|
||
3. **内存使用**: 处理超大图片时会占用较多内存
|
||
4. **文件数量**: 分割数越多，生成的文件越多，注意磁盘空间
|
||
5. **索引顺序**: 文件按先行后列的顺序编号（从左到右，从上到下）
|
||
|
||
## 🔧 技术细节
|
||
|
||
### 依赖库
|
||
- **clap**: 命令行参数解析
|
||
- **image**: 图片处理和裁切
|
||
|
||
### 性能特点
|
||
- 使用 Rust 编写，性能优异
|
||
- 支持多线程（取决于 image 库的实现）
|
||
- 内存效率高，逐块处理
|
||
|
||
### 平台支持
|
||
- ✅ Windows
|
||
- ✅ macOS
|
||
- ✅ Linux
|
||
|
||
## 📝 完整示例工作流
|
||
|
||
### 工作流 1: 制作 Instagram 九宫格
|
||
|
||
```bash
|
||
# 1. 准备一张正方形图片（建议 1080x1080 或更高）
|
||
# 2. 分割成 3x3 的九宫格
|
||
cutpic -i instagram-post.png -w 3 -h 3 --out ./instagram-grid
|
||
|
||
# 3. 上传生成的 9 张图片到 Instagram（按逆序上传以获得正确显示顺序）
|
||
```
|
||
|
||
### 工作流 2: 提取游戏资源
|
||
|
||
```bash
|
||
# 1. 从游戏中提取 sprite sheet
|
||
# 2. 分析 sprite sheet 的布局（例如 8x4 排列）
|
||
cutpic -i spritesheet.png -w 8 -h 4 --out ./game-assets
|
||
|
||
# 3. 重命名生成的文件为有意义的名称
|
||
# 4. 在游戏引擎中使用这些单独的资源
|
||
```
|
||
|
||
### 工作流 3: 创建拼图游戏
|
||
|
||
```bash
|
||
# 1. 选择一张有趣的图片
|
||
# 2. 根据难度选择分割数（简单: 3x3, 中等: 5x5, 困难: 8x8）
|
||
cutpic -i puzzle-image.jpg -w 5 -h 5 --out ./puzzle-pieces
|
||
|
||
# 3. 打乱文件顺序
|
||
# 4. 开发拼图游戏逻辑
|
||
```
|
||
|
||
## 🤝 贡献
|
||
|
||
欢迎提交 Issue 和 Pull Request！
|
||
|
||
## 📄 许可证
|
||
|
||
本项目采用 MIT 许可证。
|
||
|
||
## 🙏 致谢
|
||
|
||
感谢以下开源项目：
|
||
- [clap](https://github.com/clap-rs/clap) - 优秀的命令行参数解析库
|
||
- [image](https://github.com/image-rs/image) - 强大的图片处理库
|
||
|
||
---
|
||
|
||
**Made with ❤️ using Rust**
|