# doc_scanner_homework

**Repository Path**: bone-zzz/doc_scanner_homework

## Basic Information

- **Project Name**: doc_scanner_homework
- **Description**: 这个项目是一个文档扫描仪应用程序，使用Python编写。它可以帮助用户加载图片并裁剪文档，提供方便的文档扫描功能。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 257
- **Created**: 2025-06-01
- **Last Updated**: 2025-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# doc_scanner

## 项目描述

这个项目是一个文档扫描仪应用程序，使用Python编写。它可以帮助用户加载图片并裁剪文档，提供方便的文档扫描功能。

## 项目运行效果截图
![输入图片说明](bde693e33b2048b6df50160e069b54d.png)

## 功能

- 选择图片：通过点击 "Select Image" 按钮选择要加载的图片。
- 裁剪文档：点击 "Crop" 按钮可以裁剪文档，将文档从图片中提取出来。
- 鼠标移动显示：勾选 "Show Mouse Move" 复选框可以在鼠标移动时显示相关信息（如果有实现）。

## 环境配置

本项目使用 Conda 进行环境管理。请按照以下步骤配置环境：

1. 安装 Anaconda 或 Miniconda (如果尚未安装)
   - Linux下载地址: https://docs.conda.io/en/latest/miniconda.html
   - 安装后确保 conda 命令可用：`conda --version`

2. 创建并激活环境：
```bash
# 创建环境
conda env create -f environment.yml

# 激活环境
conda activate doc_scanner_env
```

项目依赖以下主要库：
- tkinter：用于创建GUI应用程序
- PIL：用于处理图片
- OpenCV：用于图片处理和计算机视觉任务
- numpy：用于进行数值计算

所有依赖都已在 environment.yml 文件中指定，创建环境时会自动安装。

## 使用说明

1. 确保已激活 conda 环境：
```bash
conda activate doc_scanner_env
```

2. 运行程序：
```bash
python app.py
```

3. 使用界面：
   - 点击 "Select Image" 按钮选择要扫描的文档图片
   - 调整自动检测的文档边界（如果需要）：
     * 用鼠标拖动四个绿色角点
     * 勾选 "Show Mouse Move" 可以显示鼠标移动的调试信息
   - 点击 "Crop" 按钮执行文档透视变换
   - 在新窗口中查看处理后的文档图片
   - 点击 "Close" 按钮关闭结果窗口

## 注意事项

- 支持 Linux 和 Windows 系统
- 支持中文路径下的图片文件
- 建议使用清晰的文档照片，确保文档边界与背景有足够的对比度
- 如果无法检测到文档边界，将使用图片边界作为默认边界
- 确保已安装 Anaconda 或 Miniconda，并正确配置了环境
- 在 Linux 系统上，可能需要安装额外的 tkinter 包：
  ```bash
  sudo apt-get install python3-tk  # Ubuntu/Debian
  sudo dnf install python3-tkinter # Fedora
  ```

## 个人信息
[TODO: 此处填写个人信息]
- 学号: 202352320213
- 年级: 2023
- 专业: 智能科学与技术
- 班级: 2 班
```

请将 "TODO" 替换为适当的信息，包括项目运行效果截图的文件名。请确保将此markdown内容放置在自述文件的合适位置，并确保所有内容都在代码块中，以保留所有Markdown语法内容。