# image_cut

**Repository Path**: cbb0416/image_cut

## Basic Information

- **Project Name**: image_cut
- **Description**: 基于python和pyQT的图片切图工具
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-03
- **Last Updated**: 2025-04-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 图像剪切工具

一个功能强大的图像剪切工具，支持精确选择、多区域管理和批量处理，利用图像处理技术提供智能区域检测和背景移除功能。

## 主要功能

- **智能区域检测**: 鼠标移动时自动检测和建议可能的选择区域
- **多区域管理**: 支持在单个图像上选择和管理多个区域
- **精确调整**: 使用调整手柄或输入精确坐标调整区域
- **多种导出选项**: 支持多种图像格式和保存选项
- **背景移除**: 支持基于颜色的背景透明处理
- **批处理功能**: 批量保存多个区域
- **正确的颜色处理**: 确保图像颜色在加载、显示和保存过程中保持一致

## 安装

### 要求

- Python 3.6+
- PyQt5
- OpenCV (cv2)
- NumPy
- Pillow (PIL)

### 通过pip安装依赖

```bash
pip install -r requirements.txt
```

## 快速开始

```bash
python run.py
```

或者

```bash
cd src
python main.py
```

## 使用说明

### 打开图像

1. 点击菜单栏中的 `文件 -> 打开图片` 或使用工具栏上的打开按钮
2. 在文件对话框中选择要打开的图像文件

### 选择区域

#### 自动检测

1. 将鼠标移动到图像上，工具会自动检测并显示可能的区域（绿色虚线框）
2. 双击确认选择建议的区域

#### 手动绘制

1. 点击并拖动鼠标绘制矩形选区
2. 释放鼠标按钮确认选择

### 调整区域

1. 选择一个区域（边界会以黄色突出显示）
2. 使用调整手柄（显示为小方块）调整大小
   - 角上的手柄可调整宽度和高度
   - 边上的手柄可调整单个维度
3. 右键点击区域并选择"精确调整"输入精确坐标

### 保存区域

1. 选择一个区域
2. 点击菜单栏中的 `文件 -> 保存当前区域` 或使用快捷键 `Ctrl+S`
3. 在保存对话框中选择保存位置和格式

### 批量保存

1. 点击菜单栏中的 `文件 -> 保存所有区域` 或使用快捷键 `Ctrl+Shift+S`
2. 在对话框中设置保存选项
   - 选择保存目录
   - 选择是否在文件名中包含坐标信息
   - 选择输出格式
   - 选择是否启用背景移除（仅PNG格式）

## 颜色处理说明

本工具使用了特殊的颜色处理方法，确保图像在整个处理流程中保持正确的颜色：

1. **加载图像**: 使用PIL库加载为RGB格式
2. **显示图像**: 在Qt显示时，确保正确处理RGB数据
3. **保存图像**: 直接使用PIL从原始RGB数据保存图像

这种方法解决了PyQt和PIL/OpenCV库在RGB/BGR颜色处理方面的差异，确保最终保存的图像与原始图像颜色一致。

## 高级功能

### 背景移除

1. 选择一个区域
2. 右键点击并选择"设置背景滤除"
3. 使用拾色器选择要移除的背景颜色
4. 调整阈值滑块控制颜色匹配的精度
5. 在保存时选择PNG格式并启用"移除背景"选项

### 区域重命名

1. 右键点击区域并选择"编辑区域"
2. 在对话框中输入区域名称
3. 区域名称将用于保存时的文件命名

## 故障排除

如果遇到以下问题，请尝试相应的解决方案：

1. **图像无法加载**: 确保图像文件格式受支持，尝试使用其他格式的图像
2. **保存失败**: 检查文件路径是否存在特殊字符，确保有足够的写入权限
3. **区域选择无响应**: 尝试关闭并重新打开程序，或加载其他图像
4. **颜色不一致问题**: 使用最新版本的工具，我们已修复了颜色处理问题

## 更新日志

最近的更新内容请查看 [CHANGELOG.md](CHANGELOG.md)

## 待实现功能

请参见 [todos.txt](src/todos.txt) 了解计划中的功能和已知问题

## 贡献

欢迎贡献代码、报告问题或提出功能建议！

## 许可证

本项目采用 MIT 许可证