虹软人脸识别SDK的Linux版本Demo-sample实践

ReadMe.txt

ArcFace 3.0 SDK Linux_x64版本

ASFTestDemo使用说明：
1.Demo运行环境：
	Linux_x64系统；
	GLIBC 2.17及以上；
	GLIBCXX 3. 4.19及以上；
	GCC 4.8.2及以上；
	cmake 3.0及以上；

2.执行过程：
	a).将ASFTestDemo工程拷贝到Linux系统下；
	b).需要将SDK包目录下中“lib”文件夹中的两个.so文件拷贝到/ASFTestDemo/linux_so文件目录下；
	c).建议将SDK包目录下中“inc”文件夹中的.h文件替换掉/ASFTestDemo/inc下的文件；
	d).下载SDK时，将从官网中获取的APPID/SDKKEY更新到samplecode.cpp文件中；
	e).在ASFTestDemo目录下新建一个build文件夹；（在build目录下编译）
	f).进入到/ASFTestDemo/build文件目录下,执行“cmake ..”命令，找到上一级的CMakeLists.txt文件编译，makefile文件会生成在build目录下；
	g).在/ASFTestDemo/build路径下执行“make”命令，生成可执行文件；
	h).在/ASFTestDemo/build路径下执行“./arcsoft_face_engine_test”命令,运行程序（./images文件夹下提供了三张用于测试的图片）；

3.注意事项：
	a).该demo提供图片为 NV21 格式的裸数据，图片保存在/ASFTestDemo/build/images路径下；
	b).图片宽度需要满足4的倍数，YUYV/I420/NV21/NV12/GRAY格式的图片高度为2的倍数，BGR24格式的图片高度不限制；
	c).jpg等格式读图需要做图像解码，推荐使用opencv第三方库进行读取；
	

Demo结果

读取的是第二张图：640x480_2.NV21

************* ArcFace SDK Info *****************
startTime: 2020-02-14 00:00:00
endTime: 2021-02-14 00:00:00

Version:3.0.12402010101.1
BuildDate:12/31/2019
CopyRight:Copyright 2019 ArcSoft Corporation Limited. All rights reserved.

************* Face Recognition *****************
ASFOnlineActivation sucess: 90114      # 在线激活SDK
ASFInitEngine sucess: 0     # 初始化引擎
../images/640x480_2.NV21 ASFFaceFeatureExtractEx 2 sucess: 0   # 单人特征提取
ASFFaceFeatureCompare sucess: 0.076342   # 人脸特征比对，输出比对相似度

************* Face Process *****************
RGB Threshold: 0.500000   # BGR活体检测阈值
IR Threshold: 0.700000  # IR活体检测阈值
ASFProcessEx sucess: 0  # 该接口仅支持可见光图像检测
../images/640x480_2.NV21 First face age: 21 # 年龄
../images/640x480_2.NV21 First face gender: 1  # 性别（0:男性; 1:女性; -1:未知）
../images/640x480_2.NV21 First face 3dAngle: roll: 4.319518 yaw: -7.680800 pitch: -10.377542   # 3D角度：横滚角、偏航角、俯仰角
ASFGetLivenessScore sucess: 1  # 获取RGB活体信息

**********IR LIVENESS*************
Face num: 1  # 检测的人脸个数
ASFProcessEx_IR sucess: 0  # 该接口仅支持单人脸IR活体检测，超出返回未知
IR Liveness: 1   # IR活体检测（0:非真人； 1:真人；-1:不确定； -2:传入人脸数 > 1；-3:人脸过小；-4:角度过大；-5:人脸超出边界）
ASFUninitEngine sucess: 0   # 销毁SDK引擎

上述的注释参考下面的技术文档。

技术文档

参考：SDK文档>人脸识别SDK>ArcFace接入文档>Linux-C++接入文档

令人头疼的是如何打开显示YUV NV21格式的测试图片？？

Opencv？
ffplay？

ffplay -i 640x480_2.NV21 -pix_fmt nv21 -s 640x480

ffplay -video_size 640x480 640x480_2.NV21

这块 暂时还没搞定，如果是windows系统的话可以直接去下载一个工具本地读取。

参考：

1. YUV
2. 从YUV到RGB
3. YUV420到RGB的转化
4. ffplay播放YUV数据