seal_ocr_c/c/README.md

# Seal Processing - 印章处理模块

印章检测与处理的 C++ 模块，包含印章提取和边框移除功能。

## 环境要求

- **CMake** >= 3.10
- **MinGW-w64** (通过 MSYS2 安装)
- **OpenCV** >= 4.0 (通过 MSYS2 安装: `mingw-w64-x86_64-opencv`)

### 安装依赖（MSYS2）

```bash
pacman -S mingw-w64-x86_64-toolchain
pacman -S mingw-w64-x86_64-cmake
pacman -S mingw-w64-x86_64-opencv
```

---

## 项目结构

```
Final project/
├── image/                  # 测试图片目录
│   ├── 1.png
│   └── 2.png
│
└── c/                      # C++ 项目目录
    ├── CMakeLists.txt      # CMake 配置文件
    ├── build.bat           # 一键编译脚本
    ├── README.md           # 说明文档
    │
    ├── common.cpp          # 公共函数
    ├── common.h
    ├── image_utilities.cpp # 图像工具
    ├── image_utilities.h
    │
    ├── extract_seal_main/  # 印章提取模块
    │   ├── extract_seal_main.cpp
    │   ├── extract_seal_main.h
    │   ├── adjust_image.cpp
    │   ├── adjust_image.h
    │   ├── color_filter.cpp
    │   ├── color_filter.h
    │   ├── hsv_color.cpp
    │   ├── hsv_color.h
    │   ├── image_morphology.cpp
    │   ├── image_morphology.h
    │   └── test_extract_seal.cpp
    │
    └── remove_border/      # 边框移除模块
        ├── remove_border.cpp
        ├── remove_border.h
        ├── remove_border_main.cpp
        ├── remove_border_main.h
        └── test_remove_border.cpp
```

**编译后生成的目录（不会被 Git 追踪）：**
- `c/build/` - 编译输出目录，包含可执行文件
- `c/extract_seal_main/test_image/` - 印章提取测试输出
- `c/remove_border/test_image/` - 边框移除测试输出

---

## 编译

### 方法1：使用 build.bat（在 cmd.exe 中运行）

在 **命令提示符 (cmd)** 中运行：

```cmd
cd "c:\Users\用户名\Desktop\Final project\c"
build.bat
```

或在 **PowerShell** 中运行：

```powershell
cd "c:\Users\用户名\Desktop\Final project\c"
cmd /c .\build.bat
```

### 方法2：手动 CMake 编译（推荐）

```powershell
cd "c:\Users\用户名\Desktop\Final project\c"
mkdir build -ErrorAction SilentlyContinue
cd build
cmake .. -G "MinGW Makefiles" -DOpenCV_DIR="C:/msys64/mingw64/lib/cmake/opencv4"
cmake --build .
```

**注意：** 请将 `用户名` 替换为您的 Windows 用户名。

---

## 运行 test_extract_seal（印章提取）

### 功能
从图片中提取印章，输出裁剪后的印章图像。

### 运行命令

```powershell
cd "c:\Users\用户名\Desktop\Final project\c\build"
.\test_extract_seal.exe
```

### 程序会自动处理

**输入：**
- 从 `build/` 目录运行时，程序会扫描 `../../image/` 目录
- 即 `Final project/image/` 目录下的图片
- 支持格式：`.png`, `.jpg`, `.jpeg`, `.bmp`

**输出：**
- 自动保存在 `../extract_seal_main/test_image/` 目录
- 即 `Final project/c/extract_seal_main/test_image/` 目录
- 每个印章生成 3 个文件：
  - `seal_{图片名}_{序号}_cropped.png` - 原始裁剪区域
  - `seal_{图片名}_{序号}_ex_img.png` - 提取后的印章图像
  - `seal_{图片名}_{序号}_adj_img.png` - 校正后的印章图像

### 关于检测数据

程序内部已预设了 `1.png` 和 `2.png` 的印章检测数据（det）。如需使用其他图片，请参考"测试说明"章节。

---

## 运行 test_remove_border（边框移除）

### 功能
对提取的印章进行边框移除处理。

### 运行命令

```powershell
cd "c:\Users\用户名\Desktop\Final project\c\build"
.\test_remove_border.exe
```

---

## 测试说明

### 关于印章检测数据（det）

目前 C++ 程序**不包含印章检测功能**（即原 Python 项目 seal_ocr 中的 detect 部分）。

程序中使用的印章边框数据（det）是通过运行**原 Python 项目**获得后，在 C++ 代码中进行了硬编码设定。

**如需使用自己的测试图片：**
1. 使用原 Python 项目 seal_ocr 运行图片，获取检测数据（det）
2. 修改 C++ 测试文件中硬编码的 det 数据
3. 重新编译并运行程序

### 各测试程序的差异

| 测试程序 | 处理范围 | 检测数据 | 说明 |
|---------|---------|----------|------|
| `test_extract_seal.cpp` | 多张图片 | 预设 1.png, 2.png | 自动扫描 `image/` 目录，但仅对预设的图片有检测数据 |
| `test_remove_border.cpp` | 单张图片 | 预设 1.png | 仅处理 1.png，需要手动修改代码中的图片路径和 det 数据 |

**注意：** 两个测试程序都预设了检测数据（det），如需处理其他图片，需要先使用原 Python 项目获取 det 数据，然后修改代码。

---

## 快速开始

```powershell
# 1. 进入项目目录
cd "c:\Users\用户名\Desktop\Final project\c"

# 2. 编译（使用 CMake）
mkdir build -ErrorAction SilentlyContinue
cd build
cmake .. -G "MinGW Makefiles" -DOpenCV_DIR="C:/msys64/mingw64/lib/cmake/opencv4"
cmake --build .

# 3. 运行印章提取测试
.\test_extract_seal.exe

# 4. 运行边框移除测试
.\test_remove_border.exe
```

**注意：** 请将 `用户名` 替换为您的 Windows 用户名。

---

## 常见问题

### 1. `cd` 命令报错：找不到路径

**原因：** 路径中有空格 `Final project`

**解决：** 用引号包围路径
```powershell
cd "c:\Users\用户名\Desktop\Final project\c"
```

### 2. CMake 找不到 OpenCV

确保指定正确的 OpenCV 路径：
```powershell
cmake .. -G "MinGW Makefiles" -DOpenCV_DIR="C:/msys64/mingw64/lib/cmake/opencv4"
```

### 3. 编译失败

检查：
- MinGW-w64 是否已正确安装
- 环境变量 PATH 是否包含 `C:\msys64\mingw64\bin`

### 4. 运行时找不到 DLL

将 `C:\msys64\mingw64\bin` 添加到系统 PATH，或复制相关 DLL 到可执行文件目录。