[2024/08/06 更新][开源] LiYing 证件照自动处理程序
本帖最后由 奥怪 于 2024-8-6 16:14 编辑# LiYing
LiYing 是一套适用于自动化完成一般照相馆后期流程的照片自动处理的程序。
## 介绍
LiYing 可以完成人体、人脸自动识别，角度自动纠正，自动更换任意背景色，任意尺寸证件照自动裁切，并自动排版。
LiYing 可以完全离线运行。所有图像处理操作都在本地运行。
### 简单工作流说明
### 效果展示
**注：本项目仅针对证件照图像处理，而非要求任意照片图像都可以完美执行，所以该项目的输入图片应该是符合一般要求的单人肖像照片。**
**如果您使用复杂图片制作证件照出现意外情况属于正常现象。**
## 开始使用
### 整合包
如果你是 Windows 用户且没有代码阅览需求，可以[下载整合包](https://github.com/aoguai/LiYing/releases/latest)（已在 Windows 7 SP1 &Windows 10），解压将图片或目录拖入 run.bat 即可启动 LiYing。
这是一个整合好的 Windows 整合包，它适用于 Windows 7 SP1 及以上版本
您可以在(https://github.com/aoguai/LiYing/releases/latest) 直接下载
同时提供以下其他下载方式：
| 文件类型 | 链接 | 提取码/备注 |
|----------|------|-------------|
| 百度网盘 | (https://pan.baidu.com/s/1nBGMvRWBtJYMK9FyI7cAXw?pwd=d15a) | d15a |
| Google Drive | (https://drive.google.com/file/d/1VDdkNIgtvWYYbpiw-P4KwfjaZPHy6tJq/view?usp=sharing) | - |
### 设置和安装
您可以按照以下说明进行安装和配置，从而在本地环境中使用 LiYing。
#### 先决条件
LiYing 依赖于 AGPicCompress ，而 AGPicCompress 需要依赖于 mozjpeg 和 pngquant
其中你可能需要手动安装 pngquant，你可以参考 (https://pngquant.org/)并将其添加到对应位置
LiYing 会在以下位置检测 pngquant 是否存在，你可以自由配置
- 环境变量（推荐）
- LiYing/src 目录下
- LiYing/src 目录下的 `ext` 目录
以便 AGPicCompress 能够找到 pngquant 并使用它进行 PNG 图片的压缩。
#### Microsoft Visual C++ Redistributable 依赖
您需要安装最新 (https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist)
如果您使用的是 Windows 系统，您的最低版本应该是 Windows 7 SP1 及以上。
对于 Window 用户，项目提供了 bat 运行脚本方便您使用:
```shell
cd LiYing
run.bat ./images/test1.jpg
```
#### CIL 参数信息与帮助
```shell
python main.py --help
Usage: main.py IMG_PATH
图像处理 CLI 工具
IMG_PATH: 输入图像路径
Options:
-y, --yolov8-model-path PATH YOLOv8 模型路径
-u, --yunet-model-path PATH YuNet 模型路径
-r, --rmbg-model-path PATH RMBG 模型路径
-b, --bgr-list BGR_LIST BGR 通道值列表（逗号分隔），用于图像合成
-s, --save-path PATH 保存路径
-p, --photo-type TEXT 照片类型
--photo-sheet-size 选择照片表格的尺寸（五寸或六寸）
-c, --compress / --no-compress是否压缩图像
-sc, --save-corrected / --no-save-corrected
是否保存修正图像后的图片
-bg, --change-background / --no-change-background
是否替换背景
-sb, --save-background / --no-save-background
是否保存替换背景后的图像
-sr, --sheet-rows INTEGER 照片表格的行数
-sc, --sheet-cols INTEGER 照片表格的列数
--rotate / --no-rotate 是否旋转照片90度
-rs, --resize / --no-resize 是否调整图像尺寸
-srz, --save-resized / --no-save-resized
是否保存调整尺寸后的图像
--help Show this message and exit.
```
#### 其他配置
在该版本中，在`data/data.ini`中设置了常规的证件照配置，您可以在`photo-type`参数中使用。
同时你可以修改该配置文件，自定义证件照类型。其格式为
```text
打印尺寸 = XXXcm x XXXcm
电子版尺寸 = XXXpx x XXXpx
分辨率 = XXXdpi
```
其中节名称及``和`电子版尺寸 = XXXpx x XXXpx`是必须的。
其中节名称代表了其`photo-type`参数。
目前，针对尺寸大小的 `key` 只支持固定中文 `电子版尺寸`，将在以后版本改进。
## 贡献
LiYing 是一个开源项目，非常欢迎社区的参与。要为该项目做出贡献。欢迎各位大佬点⭐️
github项目地址：https://github.com/aoguai/LiYing
## License 说明
(https://github.com/aoguai/LiYing) 使用 AGPL-3.0 license 进行开源。
## 更新日志
- **2024/08/06 更新**
- 新增 photo-type 和 photo-sheet-size 支持直接输入宽高像素，支持使用 data.ini 配置
- 修复 部分 i18n 导致的已知问题，现在可以兼容中英文配置
- 修复 其他已知BUG
「2024/08/06更新」吾爱专用文叔叔下载链接：
https://f.ws28.cn/f/erwgq30ycml 密码:8284 如果您闪退请参考下面的方式使用 `cmd` 运行，确保命令行不会自动退出，从而拿到报错信息。
否则没有报错信息，我这边测试一切正常，不知道是什么原因导致的。 本帖最后由 fanicy 于 2024-8-13 22:39 编辑
很实用的工具,找了一圈,最主要的是想要自动排版,
但是我这里测试的时候,win11,bat拖放文件后闪退,使用cmd命令,只有默认参数能成功输出,只要更改任何一个默认参数,都没有生成文件,使用的中文bat......
希望后期改进,或者要求过分点,能有个gui或者网页gui...
最后还是感谢,能够免费提供这个工具.
或者有没有考虑出个小巧点的自动排版工具?
现在ai抠图或者换背景改大小的的工具有很多,但是自动排版的没几个,而且基本都是收费.
比如,7英寸相纸上排版一寸照片....之类的,排好我就能直接打印了. 谢谢楼主分享，先收藏 感谢发布原创作品 辛苦了 新鲜的。感谢分享，第一个是直接配置好的是吧。 Noangler 发表于 2024-8-3 14:44
新鲜的。感谢分享，第一个是直接配置好的是吧。
是的，整合包是配置好的 感谢楼主分享，先收藏 和证照之星xe功能类似 好东西，谢谢分享！ 感谢分享，试用一下 好东西，感谢分项。