# image_adjust

**Repository Path**: ipa-project01-palette/image_adjust

## Basic Information

- **Project Name**: image_adjust
- **Description**: 使用Python和Tkinter创建一个简单的图形用户界面，可以调整图像的亮度和对比度，并显示调整后的直方图。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 274
- **Created**: 2025-04-27
- **Last Updated**: 2025-04-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 图像亮度和对比度调整APP
使用Python和Tkinter创建一个简单的图形用户界面，可以调整图像的亮度和对比度，并始终显示并更新直方图。

## 项目描述
本项目使用Python的图形用户界面库Tkinter，图像处理库Pillow和OpenCV，以及Matplotlib绘图库，实现了一个简单的图像编辑器。用户可以通过此编辑器打开本地图片文件，通过滑动条调整图片的亮度和对比度，并查看调整后的直方图。具体功能如下：

- 载入本地图片
- 调整图片亮度
- 调整图片对比度
- 显示调整后的直方图

## 项目结构
```
image_adjust/
│  README.md
│  adjust_image_app.py    # 主程序文件
│  requirements.txt       # 依赖清单
│
└─screenshots/           # 截图文件夹
    └─screenshot.png     # 运行效果图
```

## 环境要求
- Windows/Linux/MacOS
- Python 3.6+
- pip 包管理工具

## 安装步骤
1. 克隆或下载项目到本地：
```bash
git clone <repository-url>
cd image_adjust
```

2. 安装所需依赖：
```bash
pip install -r requirements.txt
```

## 依赖详情
- Python 3.6+
- Pillow >= 8.0.0
- OpenCV (cv2) >= 4.5.0
- Tkinter (Python内置)
- Matplotlib >= 3.3.0

## 使用说明
1. 确保已完成上述安装步骤
2. 在项目目录下运行程序：
```bash
python adjust_image_app.py
```
3. 通过界面按钮加载图片
4. 使用滑动条调整参数：
   - 亮度滑块：调整范围 -100 到 100
   - CLAHE clipLimit滑块：调整范围 1.0 到 5.0

## 功能说明

### 载入本地图片
通过点击 "Load Image" 按钮，选择本地图片文件，载入编辑器。

### 调整图片亮度
通过拖动 "亮度" 滑块，实时调整图片的亮度。滑块范围从-100到100，0为原始亮度。

### 调整图片对比度
通过拖动 "CLAHE clipLimit" 滑块，实时调整图片的对比度。使用CLAHE（对比度受限的自适应直方图均衡）算法，clipLimit范围从1.0到5.0。

### 显示调整后的直方图
在调整图片亮度和对比度时，实时更新图片的直方图。

## 技术实现
- 使用Tkinter构建图形界面
- 使用OpenCV的CLAHE算法处理图像对比度
- 使用Pillow库进行图像基础处理
- 使用Matplotlib实现直方图的实时显示

## 注意事项
- 支持的图片格式：JPG、PNG、BMP
- 建议处理的图片分辨率不超过 2000x2000
- 由于GUI库Tkinter的限制，此项目仅支持在Python解释器下运行，不支持Jupyter Notebook等交互式环境

## 开发信息
- 开发时间：2023年
- 开发环境：Python 3.8
- 操作系统：Windows 11

## 个人信息
- 学号: 202352320205
- 年级: 2023
- 专业: 智能科学与技术
- 班级: 2班