ArcFaceSharp
ArcFace引擎句柄
APP_ID
SDK_KEY
版本信息
人脸检测模式 Video or Image
用到的引擎组合
检测脸部角度的优先值
ArcFace构造函数,在这里将完成ArcFace引擎的初始化
APP_ID
SDK_KEY
video模式或者image模式
要用到的引擎组合 定义的常量在ArcFaceFunction下
检测脸部角度的优先值 默认仅0度
最大检测人脸的个数[1,50] 默认25
数值化的最小人脸尺寸,视频[2,16]/图片[2,32],推荐值16 默认16
当返回值不为成功时会引发异常
引擎激活及初始化
APP_ID
SDK_KEY
video模式或者image模式
要用到的引擎组合 定义的常量在ArcFaceFunction下
检测脸部角度的优先值 默认仅0度
最大检测人脸的个数[1,50] 默认25
数值化的最小人脸尺寸,视频[2,16]/图片[2,32],推荐值16 默认16
当返回值不为成功时会引发异常
人脸检测 后续如需要人脸识别则不推荐使用这个接口,建议用 ImageDataConverter 转换成 ImageData 再使用别的接口
返回结果是否进行深拷贝,默认为true,若设置为false则每次调用会覆盖上一次的结果(内存覆盖)
当返回值不为成功时会引发异常
人脸检测
图像数据 可用 ImageDataConverter 转换
返回结果是否进行深拷贝,默认为true,若设置为false则每次调用会覆盖上一次的结果(内存覆盖)
当返回值不为成功时会引发异常
人脸检测
图片宽度,必须为4的倍数
YUYV/I420/NV21/NV12格式的图片高度为2的倍数,BGR24格式的图片高度不限制
颜色空间格式
图片数据
返回结果是否进行深拷贝,默认为true,若设置为false则每次调用会覆盖上一次的结果(内存覆盖)
当返回值不为成功时会引发异常
单人脸特征提取
单张人脸位置和角度信息
返回结果是否进行深拷贝,默认为true,若设置为false则每次调用会覆盖上一次的结果(内存覆盖)
当返回值不为成功时会引发异常
人脸特征信息
单人脸特征提取
图像数据 可用 ImageDataConverter 转换
单张人脸位置和角度信息
返回结果是否进行深拷贝,默认为true,若设置为false则每次调用会覆盖上一次的结果(内存覆盖)
当返回值不为成功时会引发异常
人脸特征信息
单人脸特征提取
图片宽度为4的倍数且大于0
YUYV/I420/NV21/NV12格式的图片高度为2的倍数,BGR24格式的图片高度不限制
颜色空间格式
图片数据
单张人脸位置和角度信息
返回结果是否进行深拷贝,默认为true,若设置为false则每次调用会覆盖上一次的结果(内存覆盖)
当返回值不为成功时会引发异常
人脸特征信息
人脸特征比对
待比对的人脸特征
待比对的人脸特征
当返回值不为成功时会引发异常
人脸对结果值,为 0-1 之间的浮点数
人脸信息检测(年龄/性别/人脸3D角度)最多支持4张人脸信息检测,超过部分返回未知
检测到的人脸信息
初始化中参数combinedMask与ASF_AGE| ASF_GENDER| ASF_FACE3DANGLE的交集的子集
人脸信息检测(年龄/性别/人脸3D角度)最多支持4张人脸信息检测,超过部分返回未知
图像数据 可用 ImageDataConverter 转换
检测到的人脸信息
初始化中参数combinedMask与ASF_AGE| ASF_GENDER| ASF_FACE3DANGLE的交集的子集
人脸信息检测(年龄/性别/人脸3D角度)最多支持4张人脸信息检测,超过部分返回未知
图片宽度为4的倍数且大于0
YUYV/I420/NV21/NV12格式的图片高度为2的倍数,BGR24格式的图片高度不限制
颜色空间格式
图片数据
检测到的人脸信息
初始化中参数combinedMask与ASF_AGE| ASF_GENDER| ASF_FACE3DANGLE的交集的子集
获取年龄信息
当返回值不为成功时会引发异常
年龄信息列表
获取性别信息
当返回值不为成功时会引发异常
性别信息列表 0男,1女,-1未知
获取3D角度信息
当返回值不为成功时会引发异常
3D角度信息列表
获取版本信息
获取版本信息
引擎 handle
销毁引擎
ResultCode 错误码类型的异常
将指针转换为结构体数组
结构体类型
指针
数组长度
结构体数组
将指针转换为结构体
结构体类型
指针
结构体实例
将结构体数组转换为指针,指针需要释放
结构体的非托管指针
用来转换成ImageData
Bitmap转ImageData同时将宽度不为4的倍数的图像进行调整,注意ImageData在用完之后要用Dispose释放掉
图像格式 默认PixelFormat.Format24bppRgb
激活SDK
0:激活成功,0x16002表示已经激活
初始化引擎(每次使用虹软只调用一次即可)
video模式或者image模式
检测脸部较低的优先值
数值化的最小人脸尺寸,视频[2,16]/图片[2,32],推荐值16
最大检测人脸的个数[1,50]
要用到的引擎组合
初始化返回的引擎handle
获取版本信息
引擎 handle
人脸检测
引擎handle
图片宽度4的倍数,大于0
YUYV/I420/NV21/NV12格式的图片高度为2的倍数,BGR24格式的图片高度不限制
颜色空间格式
图片数据
检测到的人脸信息
单人脸特征提取
引擎handle
图片宽度为4的倍数且大于0
YUYV/I420/NV21/NV12格式的图片高度为2的倍数,BGR24格式的图片高度不限制
颜色空间格式
图片数据
单张人脸位置和角度信息
人脸特征
人脸特征比对
引擎handle
待比对的人脸特征
待比对的人脸特征
比对结果,置信度数值
销毁引擎
人脸信息检测(年龄/性别/人脸3D角度)最多支持4张人脸信息检测
引擎handle
图片宽度为4的倍数且大于0
YUYV/I420/NV21/NV12格式的图片高度为2的倍数,BGR24格式的图片高度不限制
颜色空间格式
图片数据
检测到的人脸信息
初始化中参数combinedMask与ASF_AGE| ASF_GENDER| ASF_FACE3DANGLE的交集的子集
获取年龄信息
引擎handle
检测到的年龄信息
获取性别信息
引擎handle
检测到的性别信息
获取3D角度信息
引擎handle
检测到脸部3D 角度信息
检测方向的优先级
检测到的人脸角度
结果代码
引擎的工作模式
Video模式,一般用于多帧连续检测
Image模式,一般用于静态图的单次检测
人脸检测 此处detect可以是tracking或者detection两个引擎之一,具体的选择由detect mode 确定
人脸识别
年龄检测
性别检测
人脸角度检测
ASVL_PAF_RGB16_B5G6R5 -> 0x101
ASVL_PAF_RGB16_B5G5R5 -> 0x102
ASVL_PAF_RGB16_B4G4R4 -> 0x103
ASVL_PAF_RGB16_B5G5R5T -> 0x104
ASVL_PAF_RGB16_R5G6B5 -> 0x105
ASVL_PAF_RGB16_R5G5B5 -> 0x106
ASVL_PAF_RGB16_R4G4B4 -> 0x107
ASVL_PAF_RGB24_B8G8R8 -> 0x201
ASVL_PAF_RGB24_B6G6R6 -> 0x202
ASVL_PAF_RGB24_B6G6R6T -> 0x203
ASVL_PAF_RGB24_R8G8B8 -> 0x204
ASVL_PAF_RGB24_R6G6B6 -> 0x205
ASVL_PAF_RGB32_B8G8R8 -> 0x301
ASVL_PAF_RGB32_B8G8R8A8 -> 0x302
ASVL_PAF_RGB32_R8G8B8 -> 0x303
ASVL_PAF_RGB32_A8R8G8B8 -> 0x304
ASVL_PAF_RGB32_R8G8B8A8 -> 0x305
ASVL_PAF_YUV -> 0x401
ASVL_PAF_YVU -> 0x402
ASVL_PAF_UVY -> 0x403
ASVL_PAF_VUY -> 0x404
ASVL_PAF_YUYV -> 0x501
ASVL_PAF_YVYU -> 0x502
ASVL_PAF_UYVY -> 0x503
ASVL_PAF_VYUY -> 0x504
ASVL_PAF_YUYV2 -> 0x505
ASVL_PAF_YVYU2 -> 0x506
ASVL_PAF_UYVY2 -> 0x507
ASVL_PAF_VYUY2 -> 0x508
ASVL_PAF_YYUV -> 0x509
ASVL_PAF_I420 -> 0x601
ASVL_PAF_I422V -> 0x602
ASVL_PAF_I422H -> 0x603
ASVL_PAF_I444 -> 0x604
ASVL_PAF_YV12 -> 0x605
ASVL_PAF_YV16V -> 0x606
ASVL_PAF_YV16H -> 0x607
ASVL_PAF_YV24 -> 0x608
ASVL_PAF_GRAY -> 0x701
ASVL_PAF_NV12 -> 0x801
ASVL_PAF_NV21 -> 0x802
ASVL_PAF_LPI422H -> 0x803
ASVL_PAF_LPI422H2 -> 0x804
ASVL_PAF_NV41 -> 0x805
ASVL_PAF_NEG_UYVY -> 0x901
ASVL_PAF_NEG_I420 -> 0x902
ASVL_PAF_MONO_UYVY -> 0xa01
ASVL_PAF_MONO_I420 -> 0xa02
ASVL_PAF_P8_YUYV -> 0xb03
ASVL_PAF_SP16UNIT -> 0xc01
ASVL_PAF_DEPTH_U16 -> 0xc02
ASVL_PAF_RAW10_RGGB_10B -> 0xd01
ASVL_PAF_RAW10_GRBG_10B -> 0xd02
ASVL_PAF_RAW10_GBRG_10B -> 0xd03
ASVL_PAF_RAW10_BGGR_10B -> 0xd04
ASVL_PAF_RAW12_RGGB_12B -> 0xd05
ASVL_PAF_RAW12_GRBG_12B -> 0xd06
ASVL_PAF_RAW12_GBRG_12B -> 0xd07
ASVL_PAF_RAW12_BGGR_12B -> 0xd08
ASVL_PAF_RAW10_RGGB_16B -> 0xd09
ASVL_PAF_RAW10_GRBG_16B -> 0xd0A
ASVL_PAF_RAW10_GBRG_16B -> 0xd0B
ASVL_PAF_RAW10_BGGR_16B -> 0xd0C
ASVL_PAF_RAW10_GRAY_10B -> 0xe01
ASVL_PAF_RAW10_GRAY_16B -> 0xe81
版本和授权信息
版本号
构建日期
版权说明
单人脸信息
人脸框
人脸角度
多人脸信息
人脸框数组
人脸角度数组
检测到的人脸个数
年龄信息
年龄结果
检测到人脸的个数
性别信息
0男,1女,-1未知
检测到的人脸的个数
人脸特征信息
特征信息
人脸特征的长度
3D角度信息
横滚角度
偏航角度
俯仰角度
0为正常
检测到人脸的个数
人脸框信息
左距离
上距离
右距离
下距离
横滚角度
偏航角度
俯仰角度
0为正常
多人脸信息
多人脸信息
单人脸信息List