# imagecropping

**Repository Path**: suguangnet/imagecropping

## Basic Information

- **Project Name**: imagecropping
- **Description**: 图片裁减软件 功能如下：1、调整宽度，高度自动 来调整图片尺寸；2、压缩图片质量来调整图片大小。 
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-09-09
- **Last Updated**: 2025-12-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 图片裁减软件 使用说明

## 软件简介
图片裁减软件是一款用于批量调整图片尺寸和文件大小的工具，支持两种处理模式：
1. 按宽度调整图片尺寸（高度自动调整，保持宽高比）
2. 按文件大小限制图片大小（自动计算合适的尺寸）

## 功能特点
- ✅ 批量处理文件夹中的图片（包括所有子目录）
- ✅ 支持主流图片格式：JPEG、PNG、BMP、TIFF、WebP等
- ✅ 保持图片宽高比，不变形
- ✅ 目录结构保持：输出目录完全保持原有的子目录结构
- ✅ 智能跳过：小于目标尺寸或大小的图片会被跳过但复制到输出目录
- ✅ 文件替换：输出目录中的同名文件会被直接替换
- ✅ 质量保证：图片质量最低限制为80，确保高质量输出
- ✅ 实时进度显示和处理日志
- ✅ 可随时停止处理
- ✅ 窗体居中显示，简洁易用的图形界面

## 安装要求
- Python 3.6 或更高版本
- Pillow 图片处理库

## 安装步骤
1. 确保已安装 Python 3.6+
2. 安装依赖包：
   ```
   pip install -r requirements.txt
   ```
   或者：
   ```
   pip install Pillow
   ```

## 使用方法

### 1. 启动软件
```
python image_resizer.py
```

### 2. 选择文件夹
- **源文件夹**：选择包含待处理图片的文件夹
- **输出文件夹**：选择处理后图片的保存位置

### 3. 选择处理模式

#### 模式一：按宽度调整尺寸
- 适用场景：需要统一图片宽度
- 设置参数：目标宽度（像素）
- 处理效果：所有图片宽度调整为指定值，高度按比例自动调整

#### 模式二：按文件大小限制
- 适用场景：需要控制图片文件大小
- 设置参数：目标文件大小（MB）
- 处理效果：自动调整图片尺寸和质量，使文件大小不超过指定值

### 4. 开始处理
1. 点击"开始处理"按钮
2. 软件会自动扫描源文件夹中的所有图片
3. 实时显示处理进度和日志
4. 处理完成后显示结果统计

### 5. 停止处理
- 如需中途停止，点击"停止处理"按钮

## 支持的图片格式
- JPEG (.jpg, .jpeg)
- PNG (.png)
- BMP (.bmp)
- TIFF (.tiff, .tif)
- WebP (.webp)

![输入图片说明](%E5%9B%BE%E7%89%87.png)

## 注意事项
1. **备份原图**：建议在处理前备份原始图片
2. **输出文件夹**：输出文件夹可以与源文件夹相同，但建议使用不同文件夹避免意外覆盖
3. **文件权限**：确保对源文件夹和输出文件夹有读写权限
4. **大量文件**：处理大量图片时可能需要较长时间，请耐心等待
5. **内存使用**：处理大尺寸图片时可能占用较多内存
7. **跳过文件复制**：跳过处理的图片会被复制到输出目录，输出目录包含所有原始文件
8. **输出目录排除**：当输出目录是源目录的子目录时，自动排除已处理的文件

## 技术参数
- **按宽度调整**：使用 Lanczos 重采样算法，保证图片质量
- **按大小限制**：智能调整质量参数（80-95）和尺寸比例，优先保持尺寸
- **文件格式**：输出格式与输入格式保持一致
- **质量设置**：JPEG 图片默认质量为 95%，最低不低于 80%

## 常见问题

### Q: 处理后的图片质量如何？
A: 软件使用高质量的 Lanczos 重采样算法，按宽度调整时质量设为95%，按大小限制时会在50-95%之间自动调整。

### Q: 可以处理子文件夹中的图片吗？
A: 是的，软件会自动扫描源文件夹及其所有子文件夹中的图片文件。

### Q: 软件是否支持子目录？
A: 是的！软件会递归扫描选定文件夹及其所有子目录中的图片，并在输出目录中完全保持原有的目录结构。

### Q: 子目录中的同名文件会冲突吗？
A: 不会。软件会保持完整的目录结构，所以不同子目录中的同名文件会被正确分开存放。

### Q: 如果输出文件夹中已有同名文件怎么办？
A: 软件会直接替换同名文件，并在日志中显示“替换”标记。建议在处理前先备份重要文件。

### Q: 处理大量图片时软件卡住了怎么办？
A: 这是正常现象，处理大量图片需要时间。可以查看日志了解当前处理进度，或点击"停止处理"中断操作。

## 更新日志

### v1.7 (2024-09-09)
- 日志信息增强：在处理完成统计信息后添加“全部已输出到目标文件夹”提示
- 用户体验优化：明确告知用户所有文件已成功输出到指定目录

### v1.6 (2024-09-09)
- 输出目录排除修复：解决输出目录为源目录子目录时的重复扫描问题
- 图片数量统计修复：确保显示的图片数量准确，不包含已处理的图片
- 防止循环处理：智能排除输出目录中的文件，避免无限循环

### v1.5 (2024-09-09)
- 子目录支持增强：支持递归处理选定目录下的所有子目录中的图片
- 目录结构保持：输出目录中完全保持原有的子目录结构
- 批量处理优化：可一次性处理复杂目录结构中的所有图片

### v1.4 (2024-09-09)
- 质量保证优化：图片质量最低限制设为80，确保输出图片保持高质量
- 智能压缩策略：优先降低质量到80，然后通过缩小尺寸进一步压缩

### v1.3 (2024-09-09)
- 跳过文件复制功能：跳过处理的图片会被复制到输出目录，方便统计
- 完整文件复制：输出目录中包含所有原始文件（处理后或原始副本）

### v1.2 (2024-09-09)
- 智能跳过功能：当原图尺寸或文件大小小于等于目标值时自动跳过处理
- 文件替换功能：输出目录中已存在同名文件时直接替换
- 优化处理日志：显示跳过、替换等详细信息

### v1.1 (2024-09-09)
- 窗体居中显示功能
- 添加版权信息显示

### v1.0 (2024-09-09)
- 首次发布
- 实现按宽度调整功能
- 实现按文件大小限制功能
- 支持批量处理
- 图形用户界面
- 进度显示和日志记录

## 联系方式
如有问题或建议，请联系开发者速光网络软件开发 关注抖音号：dubaishun12

---
*图片裁减软件 - 让图片处理更简单*