批量图片处理系统

一个功能强大的批量图像处理工具，支持图像增强、格式转换和批量处理等功能，提供命令行和图形界面两种操作方式。

功能特性

• 图形化界面：直观的用户界面，支持图像预览和参数调整
• 批量处理：高效处理大量图像文件
• 图像增强：调整亮度、对比度、锐化等参数
• 格式转换：支持多种图像格式之间的转换
• 预设管理：保存和加载处理参数预设
• 进度显示：实时显示处理进度
• 跨平台兼容：支持Windows、macOS和Linux系统

技术栈

• 语言：Python 3.7+
• 核心库：
  • Pillow (图像处理)
  • NumPy (数值计算)
  • PyQt5 (图形界面)
  • Matplotlib (数据可视化)

安装说明

系统要求

• Python 3.7 或更高版本
• 足够的磁盘空间用于虚拟环境和图像文件

Windows 安装步骤

1. 确保已安装 Python 3.7 或更高版本
2. 克隆或下载本仓库到本地
3. 双击运行 setup.ps1 脚本
4. 脚本会自动：
   • 检查并创建虚拟环境
   • 安装所需依赖
   • 启动图形界面

手动安装（适用于所有平台）

1. 克隆仓库

   git clone https://github.com/yourusername/batch-image-processor.git
   cd batch-image-processor

2. 创建虚拟环境

   # Windows
   python -m venv .venv
   .venv\Scripts\activate
   
   # macOS/Linux
   python3 -m venv .venv
   source .venv/bin/activate

3. 安装依赖

   pip install --upgrade pip
   pip install -r requirements.txt

使用说明

图形界面模式

运行 setup.ps1 脚本，或手动激活虚拟环境后运行：

python image_processor_ui.py

图形界面提供以下功能：

• 选择图像文件夹
• 调整处理参数（亮度、对比度、锐化等）
• 预览处理效果
• 保存和加载参数预设
• 批量处理选定图像或整个目录

命令行模式

激活虚拟环境后运行：

python batch_image_processor.py --input_dir "path/to/images" [options]

命令行参数：

• --input_dir：输入图像文件夹路径（必需）
• --output_dir：输出文件夹路径（可选）
• --format：输出图像格式（可选，如 png, jpg）
• --quality：输出图像质量（可选，1-100）

配置文件

• config.json：存储预设参数配置

项目结构

batch-image-processor/
├── batch_image_processor.py  # 核心处理模块和命令行接口
├── image_processor_ui.py     # 图形界面实现
├── config.json              # 预设配置文件
├── requirements.txt         # 项目依赖
├── setup.ps1               # Windows安装和启动脚本
└── .venv/                  # Python虚拟环境（自动创建）

贡献指南

欢迎贡献代码或提出改进建议！

如何贡献

1. Fork 本仓库
2. 创建你的特性分支 (git checkout -b feature/amazing-feature)
3. 提交你的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

代码规范

• 遵循 PEP 8 代码规范
• 添加适当的注释和文档字符串
• 确保新功能有良好的测试覆盖

许可证

本项目采用 MIT 许可证 - 详情请查看 LICENSE 文件

联系方式

如有问题或建议，请通过以下方式联系：

• GitHub Issues: https://github.com/yourusername/batch-image-processor/issues

Acknowledgements

感谢所有为本项目做出贡献的开发者和用户！