# 图片处理工具

**Repository Path**: wangju1992/image-processing-tools

## Basic Information

- **Project Name**: 图片处理工具
- **Description**: 用于图片处理，包括剪切，去黑边，压缩等
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 图像批量处理工具

一个功能强大的图像批量处理桌面应用，支持图像拼接、裁剪、压缩等多种操作，帮助您高效处理大量图片。

## ✨ 功能特点

- **图像拼接**：支持在图片顶部和底部添加自定义图片，轻松创建水印或标题
- **智能裁剪**：手动设置裁剪边距或自动去除黑边
- **批量压缩**：调整图片分辨率，优化文件大小
- **组合处理**：支持裁剪后拼接的组合操作
- **智能边框**：自动为非正方形图片添加边框，使用边缘颜色平滑过渡
- **批量处理**：一次性处理整个文件夹的图片
- **进度显示**：实时显示处理进度
- **设置记忆**：自动保存上次使用的设置

## 🖼️ 应用界面

*此处可放置应用截图*

## 🔧 安装要求

- Python 3.6 或更高版本
- PySide6 6.4.0 或更高版本
- Pillow 9.3.0 或更高版本

## 📦 安装方法

1. 克隆或下载本仓库

```bash
git clone https://github.com/yourusername/pic-tools.git
cd pic-tools
```

2. 创建并激活虚拟环境（可选但推荐）

```bash
python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# 或
.venv\Scripts\activate  # Windows
```

3. 安装依赖项

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

## 🚀 使用方法

运行应用程序：

```bash
python image_processor.py
```

### 基本操作流程

1. **选择源目录**：点击"选择目录"按钮选择包含需要处理图片的文件夹
2. **选择目标目录**：选择处理后图片的保存位置，或勾选"输出到源目录"选项
3. **配置处理选项**：
   - 图片拼接：选择顶部和/或底部图片
   - 图片裁剪：设置左、上、右、下裁剪边距，或勾选"自动去除黑边"
   - 图片压缩：勾选"启用压缩"并设置目标分辨率
4. **执行处理**：点击相应的处理按钮（图片拼接、图片裁剪或裁剪并拼接）

### 功能详解

#### 图片拼接

允许在图片的顶部和/或底部添加自定义图片。常用于添加水印、标题或版权信息。

1. 点击"选择图片"按钮选择顶部和/或底部图片
2. 点击"图片拼接"按钮执行拼接操作

#### 图片裁剪

提供两种裁剪模式：

- **手动裁剪**：通过设置左、上、右、下边距值精确裁剪图片
- **自动去除黑边**：勾选"自动去除黑边"选项，程序将自动检测并移除图片周围的黑色边框

#### 图片压缩

调整图片分辨率，优化文件大小：

1. 勾选"启用压缩"选项
2. 设置目标宽度和高度（默认为1080×1080像素）
3. 程序会在保持原始宽高比的情况下进行压缩

#### 组合处理

点击"裁剪并拼接"按钮可以一次性完成裁剪和拼接操作，提高工作效率。

### 输出文件

处理后的图片将保存在目标目录中，文件名会根据处理类型添加后缀：

- 拼接：`原文件名-merged.扩展名`
- 裁剪：`原文件名-cropped.扩展名`
- 组合处理：`原文件名-combined.扩展名`

## 📝 注意事项

- 支持的图片格式：JPG、JPEG、PNG、BMP
- 处理大量高分辨率图片时可能需要较长时间，请耐心等待
- 程序会自动记住上次使用的目录和设置，方便下次使用

## 🔄 更新日志

### v1.0.0

- 初始版本发布
- 支持图片拼接、裁剪、压缩功能
- 支持批量处理和进度显示

## 📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 [LICENSE](LICENSE) 文件

## 👨‍💻 贡献

欢迎提交问题和功能请求！如果您想贡献代码，请提交拉取请求。

## 📧 联系方式

如有任何问题或建议，请联系：[your-email@example.com](mailto:your-email@example.com)