# face_recognition

**Repository Path**: cing3/face_recognition

## Basic Information

- **Project Name**: face_recognition
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-22
- **Last Updated**: 2026-10-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 实时人脸识别最终项目

这是最终大项目的独立交付文件夹。现在采用 **MATLAB GUI 内嵌显示 + Python 后台识别引擎** 的形式：明面上只有 MATLAB GUI，后台引擎不弹 OpenCV 摄像头窗口，也不会在任务栏显示单独的 Python 窗口。

## 推荐启动方式

在 MATLAB 中运行：

```matlab
cd('D:\Desktop\homework\face_id\realtime_face_recognition_project')
run_final_face_gui
```

然后点击 GUI 中的：

```text
启动识别
```

实时画面会显示在 MATLAB GUI 内部。

## 附加小项目\n\n### 附加小项目 1：向日葵头套特效

GUI 右侧新增了：

```text
附加小项目 1 -> 向日葵头套特效
```

勾选后，实时识别到主脸时，会叠加长发、腮红、唇色、柔化等视觉特征转换效果。该效果和实时识别显示在同一个画面中，不额外弹窗。

附加小项目文件统一收纳在：

```text
runtime\addons\gender_transform
```

其中包含：

```text
runtime\addons\gender_transform\gender_transform.py
runtime\addons\gender_transform\docs\README.md
runtime\addons\gender_transform\assets\preview_gender_transform.jpg
```

### 附加小项目 2：大眼特效\n\nGUI 右侧新增 `Big Eye` 开关和一个滑条。勾选后，可通过滑条控制眼睛放大程度，效果直接显示在实时画面中。\n\n文件位置：\n\n```text\nruntime\\addons\\big_eye\n```\n\n包含：\n\n```text\nruntime\\addons\\big_eye\\big_eye.py\nruntime\\addons\\big_eye\\docs\\README.md\nruntime\\addons\\big_eye\\assets\\preview_big_eye.jpg\n```\n\n## 关闭方式

点击 GUI 中的：

```text
停止识别
```

或者直接关闭 MATLAB GUI 窗口。关闭时会写入 `runtime\cache\stream\stop.flag`，后台识别引擎检测到后自动释放摄像头并退出。

## 目录说明

```text
realtime_face_recognition_project
├── run_final_face_gui.m                  # MATLAB GUI 入口
├── FaceRecognitionFinalGUI.m             # MATLAB 展示界面，内嵌实时画面和附加小项目开关
├── launch_realtime_face_recognition.m    # 后台启动函数
├── runtime                               # 后台运行组件、模型和附加模块
│   ├── engine                            # 识别运行模块
│   ├── models                            # 人脸检测/识别模型
│   ├── cache                             # 已构建人脸库、配置和实时帧缓存
│   ├── addons                            # 附加小项目模块
│   ├── logs                              # 后台运行日志
│   └── bin                               # 隐藏启动脚本
├── output                                # 验证报告和截图输出
└── archive                               # 旧版/备用材料归档
```

## 现场约束

- 现场不重新训练。
- 现场不补拍入库。
- 现场只加载提前构建好的人脸库。
- 后台识别引擎使用 `pythonw.exe` + 文件流模式运行，不弹 Python/OpenCV 窗口。

## 当前识别方案

内部使用 YuNet 人脸检测与 SFace 人脸特征匹配。该部分被封装在 `runtime` 中，MATLAB GUI 只作为课程项目展示和启动入口。

## 验证结果

严格留出验证报告位于：

```text
output\reports\sface_validation_report.txt
```

当前结果：

```text
SFace 严格留出验证准确率：1.0000
验证样本数：100，跳过：0
```