图像分割工具

Appearance

安装使用 ​

📋 系统要求 ​

操作系统 ​

  • Windows 10 或更高版本
  • macOS 10.14 或更高版本
  • Linux (Ubuntu 18.04+ 或其他主流发行版)

Python环境 ​

  • Python 3.7 或更高版本
  • pip 包管理器

依赖库 ​

  • ttkbootstrap - 现代化UI界面
  • Pillow - 图像处理
  • pypdf - PDF操作
  • reportlab - PDF生成
  • pyinstaller - 打包工具（可选）

🚀 安装指南 ​

方式一：直接运行源码 ​

1. 获取项目代码 ​

bash
# 克隆项目
git clone https://github.com/catmcbe/imagesplit.git
cd image-splitter-main

# 或者下载ZIP文件并解压

2. 安装依赖 ​

bash
pip install -r requirements.txt

3. 运行程序 ​

bash
python image_splitter.py

方式二：使用打包后的可执行文件 ​

  1. 访问 releases 页面
  2. 下载适合您操作系统的可执行文件
  3. 直接运行，无需安装Python环境

📖 使用说明 ​

1. 基本操作流程 ​

📂 选择图片文件 ​

  1. 启动程序后，点击"📁 选择文件"按钮
  2. 在文件选择对话框中选择一张或多张图片
  3. 支持的格式：JPG、JPEG、PNG、BMP、GIF、TIFF
  4. 选择的文件会显示在文件列表中，包含文件名、大小和类型信息

⚙️ 设置分割参数 ​

  1. 设置分割尺寸：

    • 使用"列数"和"行数"输入框调整参数（范围：1-20）
    • 或使用快速预设按钮（2×2、3×3、4×4、2×3、3×2）

  2. 选择保存模式：

    • 📁 每张图片单独文件夹：为每张图片创建独立文件夹
    • 📅 按日期统一文件夹：按日期时间统一管理所有分割图片

🚀 开始分割 ​

  1. 确认参数设置后，点击"🎯 开始分割"按钮
  2. 程序会自动处理选中的图片，显示进度条和状态信息
  3. 分割完成后会弹出询问框，询问是否合并为PDF

2. 高级功能使用 ​

👁️ 分割演示 ​

  • 点击"👁️ 分割演示"按钮查看分割效果预览
  • 演示窗口中：
    • 红色线条显示分割边界
    • 白色数字显示网格位置（格式：行,列）
    • 黑色背景模拟图片区域

📂 输出文件夹 ​

  • 点击"📂 输出文件夹"按钮打开分割结果保存位置
  • 默认保存位置：程序目录下的splits文件夹
  • 文件夹结构根据选择的保存模式自动创建

🗑️ 清空列表 ​

  • 点击"🗑️ 清空列表"按钮清除已选择的文件
  • 清空后需要重新选择文件才能进行分割

3. 设置选项 ​

在"⚙️ 设置"标签页中可以调整以下选项：

输出设置 ​

  • 输出格式：选择PNG、JPEG、BMP
    • PNG：无损压缩，文件较大但质量最高
    • JPEG：有损压缩，文件较小
    • BMP：未压缩位图，文件最大
  • 图片质量：拖动滑块调整输出质量（1-100%）
    • 仅对JPEG格式有效
    • 质量越高文件越大

高级设置 ​

  • 保持宽高比：勾选后分割时会保持原图比例
  • 自动预览：启用自动预览功能（开发中）

4. PDF合并功能 ​

自动合并 ​

  • 图片分割完成后，系统会弹出确认对话框
  • 选择"是"将自动合并本次分割的所有图片为PDF文件
  • PDF文件保存在splits文件夹中，文件名格式：merged_images_时间戳.pdf

手动合并 ​

  1. 确保splits文件夹中有分割后的图片
  2. 点击"🎯 开始分割"按钮（即使没有新文件）
  3. 系统会检测现有图片并询问是否合并为PDF

PDF合并说明 ​

  • 合并顺序：按文件名字母顺序排列
  • 支持格式：PNG、JPG、JPEG、BMP、GIF
  • 页面大小：自动适应图片尺寸
  • 合并完成后可选择是否立即打开PDF文件

📁 文件管理 ​

输入文件 ​

  • 原始文件会自动复制到uploads文件夹
  • 文件名保持不变，避免修改原始文件

输出文件 ​

单独文件夹模式 ​

splits/
├── 图片1/
│   ├── tile_0_0.png
│   ├── tile_0_1.png
│   ├── tile_1_0.png
│   └── tile_1_1.png
├── 图片2/
│   ├── tile_0_0.png
│   └── ...
└── merged_images_20241023_143022.pdf

统一文件夹模式 ​

splits/
├── 2024-10-23_14-30-22/
│   ├── tile_图片1_0_0.png
│   ├── tile_图片1_0_1.png
│   ├── tile_图片2_0_0.png
│   └── ...
└── merged_images_20241023_143022.pdf

🔧 故障排除 ​

常见问题 ​

Q: 程序无法启动怎么办？ ​

A: 请检查以下项目：

  1. Python环境是否正确安装（建议Python 3.8+）
  2. 是否安装了所有依赖包：
    bash
    pip install -r requirements.txt
  3. 确认在正确的目录下运行程序

Q: 依赖安装失败怎么办？ ​

A: 尝试以下解决方案：

  1. 更新pip：
    bash
    python -m pip install --upgrade pip
  2. 使用国内镜像源：
    bash
    pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/
  3. 逐个安装依赖包，查看具体错误信息

Q: 支持哪些图片格式？ ​

A: 目前支持以下格式：

  • JPG/JPEG：常见照片格式
  • PNG：无损压缩格式
  • BMP：位图格式
  • GIF：动画图片格式（只处理第一帧）
  • TIFF：高质量图像格式

Q: 分割后的图片保存在哪里？ ​

A: 默认保存在程序目录下的splits文件夹中：

  • 单独文件夹模式：splits/图片名/
  • 统一文件夹模式：splits/日期时间/

Q: 如何调整输出图片质量？ ​

A: 在"设置"标签页中：

  1. 选择输出格式（建议PNG或JPEG）
  2. 对于JPEG格式，可调节质量滑块（1-100%）
  3. 质量越高，文件越大，但图像质量更好

Q: PDF合并失败怎么办？ ​

A: 请检查以下项目：

  1. 确认splits文件夹中有分割后的图片
  2. 检查图片格式是否受支持
  3. 确保磁盘空间充足
  4. 关闭可能正在使用PDF文件的其他程序

Q: 程序界面显示异常怎么办？ ​

A: 尝试以下解决方案：

  1. 确保窗口尺寸不小于900×600像素
  2. 检查系统DPI设置是否过高
  3. 重启程序或重启计算机

性能优化建议 ​

处理大量文件时 ​

  1. 建议一次处理不超过50张图片
  2. 单张图片大小建议不超过50MB
  3. 关闭其他占用内存的程序

提高处理速度 ​

  1. 使用SSD存储可以提高文件读写速度
  2. 增加系统内存有助于处理大图片
  3. 选择较小的分割数量可以减少处理时间

📞 技术支持 ​

如果遇到问题无法解决，可以：

  1. 查看程序运行日志
  2. 检查系统错误日志
  3. 在GitHub上提交Issue
  4. 联系开发团队获取帮助

基于 MIT 许可证发布

Copyright © 2025 ImageSplit Team