Umi-CUT 安装和配置指南

1. 项目基础介绍和主要编程语言

项目基础介绍

Umi-CUT 是一个开源的图片批量去黑边/裁剪/压缩工具，具有用户友好的界面。它能够批量处理本地图片，支持范围裁剪、自动去除黑/白边、调整大小和压缩体积等功能。通过范围裁剪和去黑边两种功能配合，可以绕过图片边缘的干扰色块，提取图片中部的所需内容。

主要编程语言

Umi-CUT 主要使用 Python 编程语言开发。

2. 项目使用的关键技术和框架

关键技术

• Python 3.x: 项目的主要编程语言。
• OpenCV: 用于图像处理的关键库，提供了丰富的图像处理功能。
• Tkinter: 用于创建图形用户界面（GUI）。

框架

• OpenCV: 用于图像处理的核心框架。
• Tkinter: 用于构建用户界面的框架。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

1. 安装 Python 3.x: 确保你的系统上已经安装了 Python 3.x。如果没有安装，可以从 Python 官方网站 下载并安装。
2. 安装 Git: 用于克隆项目代码。如果没有安装，可以从 Git 官方网站 下载并安装。
3. 安装依赖库: 项目依赖于 OpenCV 和 Tkinter，这些库可以通过 pip 安装。

详细安装步骤

步骤 1: 克隆项目代码

首先，打开终端或命令提示符，使用 Git 克隆项目代码：

git clone https://github.com/hiroi-sora/Umi-CUT.git

步骤 2: 进入项目目录

进入克隆下来的项目目录：

cd Umi-CUT

步骤 3: 安装依赖库

使用 pip 安装项目所需的依赖库：

pip install -r requirements.txt

步骤 4: 运行项目

在项目目录下，运行主程序文件 main.py：

python main.py

配置指南

1. 打开主程序: 运行 main.py 后，会弹出 Umi-CUT 的主界面。
2. 拖入图片或文件夹: 将需要处理的图片或包含图片的文件夹拖入窗口中的白色背景表格区域，或点击左上方的“浏览”按钮选择图片。
3. 开始任务: 点击右上方的“开始任务”按钮，等待进度条走完。
4. 查看输出: 处理完成后，在第一张图片的目录下的 # 裁剪 文件夹中查看输出图片。

其他参数设置

1. 设置选项卡: 点击“设置”选项卡。
2. 参数设置: 点击“参数设置”打开配置窗口，根据提示调整参数。
3. 手动裁剪范围: 红色框为手动裁剪的范围，虚线框是在手动裁剪基础上自动去除剩下黑边的范围。
4. 自动裁切边缘颜色: 可切换自动裁切边缘的颜色为黑色/白色。
5. 中值滤波参数: 若待处理图片的黑边中含有少量杂色、噪点，调高中值滤波参数（但滤波值太高可能导致留下很窄的黑边）。
6. 阈值参数: 若待处理图片的黑边不是纯“黑”，调高阈值参数（但阈值太高可能导致需要保留的部分也被裁剪）。

通过以上步骤，你可以顺利安装和配置 Umi-CUT，并开始批量处理图片。