colinchang/arcface repository overview

⁠ArcFace.Net

虹软人脸识别.NET工具库(.Net Standard 2.1)。基于ArcFace 3.x C++ SDK, 支持Windows x86/x64和Linux x64. 支持人脸库属性检测、人脸特征提取、人脸库维护、人脸搜索、活体检测等功能。

⁠Nuget

https://www.nuget.org/packages/ArcFace.Net/⁠

⁠平台支持

1. Windows x86/x64

2. Linux x64

   • 该程序基于ArcFace 3.x C++ SDK开发，DllImport引入C++动态库时依赖于Linux系统库(libdl.so.2)，因此低配Linux环境(如alpine等)可能存在兼容性问题。 经测试以下可以正常运行。
     • Debian 10 +
     • Ubuntu20.04 +
     • CentOS 8 +
   • Linux环境中图像处理依赖libgdiplus包，需要手动安装到系统中。需要特别注意的是，libgdiplus是基于Mono框架开发的，系统中务必要安装 Mono⁠ 框架，否则可能会导致 Graphics 等对象申请的内存无法被回收最终导致内存溢出。

     # Debian 10
     sudo apt install apt-transport-https dirmngr gnupg ca-certificates
     sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
     echo "deb https://download.mono-project.com/repo/debian stable-buster main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list
     sudo apt update
     sudo apt install mono-devel
     sudo apt install libgdiplus/stable
     
     # Ubuntu 20.04
     sudo apt install gnupg ca-certificates
     sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
     echo "deb https://download.mono-project.com/repo/ubuntu stable-focal main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list
     sudo apt update
     sudo apt install mono-devel
     sudo apt install libgdiplus/focal
     
     # CentOS 8
     rpmkeys --import "http://pool.sks-keyservers.net/pks/lookup?op=get&search=0x3fa7e0328081bff6a14da29aa6a19b38d3d831ef"
     su -c 'curl https://download.mono-project.com/repo/centos8-stable.repo | tee /etc/yum.repos.d/mono-centos8-stable.repo'
     sudo yum install mono-devel
     sudo yum install libgdiplus-devel.x86_64
     

     Copy

3. Docker

   我们为本程序库的运行环境打包了Docker镜像，有需要的读者可以点此获取⁠，也可以使用 Dockerfiles⁠ 中的不同版本的 Dockerfile 文件自行编译。

⁠SDK

从 虹软开发者中心⁠或此处⁠下载需要的SDK 3.x文件并放置同特定目录。

• Windows 需要将SDK dll文件拷贝到执行程序所在目录，或环境变量配置的目录
• Linux 需要将SDK so文件拷贝到 /lib 系统程序目录，或环境变量配置的目录

从 虹软开发者中心⁠ 获取授权信息(AppId/SdkKey)，通过ArcFaceOptions传入配置。具体用法参见 示例程序⁠。

⁠资源回收

• 工具中自动维护引擎池进行资源回收利用，无需手动管理。
• 工具支持多并发操作。
• 推荐使用单例方式使用。
• ArcFace 实现 IDisposable，使用完毕后需要 Dispose() 以销毁引擎回收其它相关内存。

⁠图像质量要求

• 图片尺寸大于2K且小于10MB
• 图片格式支持 .jpg, .png, .bmp
• 图片中人脸尺寸不小于50 x 50像素
• 建议待检测的图像人脸角度上、下、左、右转向小于30度

⁠人脸3D角度

俯仰角（pitch）， 横滚角（roll）， 偏航角（yaw）

⁠错误码

⁠问题

• 人脸检测和特性提取目前进识别到的人脸角度不准确，目前识别到的角度均为0度。
• 视频模式人脸追踪未开发
• 活体检测未开发

⁠参考文档

https://github.com/colin-chang/ArcFace.Net/blob/main/sdk_3.0.pdf⁠