DFace SDK  1.8.5
com.dface.DfaceDetect类 参考

DFace人脸检测API抽象层(DFaceDetect) 更多...

Public 成员函数

native int identify ()
 
native boolean initLoad (String model_path)
 
native boolean uninitLoad ()
 
native List< Bboxdetection (DFaceMat img, boolean square)
 
native List< Bboxdetection (String img_path, boolean square)
 
native List< BboxdetectionMaxFace (DFaceMat img, boolean square)
 
native List< BboxdetectionMaxFace (String img_path, boolean square)
 
native DFaceMat alignFace (DFaceMat face)
 
native FaceMatBbox detectionMaxFaceAndCrop (DFaceMat img)
 
native List< FaceMatBboxdetectionAndCrop (DFaceMat img)
 
native DFaceMat cropFace (DFaceMat img, Rect rect)
 
native DFaceMat cropFace (DFaceMat img, Bbox bbox)
 
native double[] predictBlur (DFaceMat img, List< Rect > bboxs)
 
native int[] predictLight (DFaceMat img, List< Rect > bboxs)
 
native void SetNumThreads (int numThreads)
 
native void SetMinFace (int minSize)
 

详细描述

DFace人脸检测API抽象层(DFaceDetect)

成员函数说明

native DFaceMat com.dface.DfaceDetect.alignFace ( DFaceMat  face)

对齐人脸

参数
face被裁剪的人脸数据,人脸Size可任意
返回
参照out_face
注解
(返回人脸 Size(112x112), 一般用于人脸识别通道特征提取和比对输入)
native DFaceMat com.dface.DfaceDetect.cropFace ( DFaceMat  img,
Rect  rect 
)

裁剪人脸矩形框,从原图中抠出人脸图片

参数
img被裁剪的图片
rect需要被裁剪的矩形区域
返回
返回的被裁剪人脸数据
注解
(被裁减返回的人脸Size依据输入的rect)
native DFaceMat com.dface.DfaceDetect.cropFace ( DFaceMat  img,
Bbox  bbox 
)

裁剪人脸矩形框,从原图中抠出人脸图片

参数
img被裁剪的图片
bbox被检测到的人脸边框信息
返回
返回的被裁剪人脸数据
注解
(被裁减返回的人脸Size依据输入的rect)
native List<Bbox> com.dface.DfaceDetect.detection ( DFaceMat  img,
boolean  square 
)

检测图片所有的人脸,返回边框,五官定位,可信度

参数
img图片数据,以Mat格式输入
返回
返回所有人脸边框信息数组
注解
(当未检测到人脸,finalBbox为空List)
native List<Bbox> com.dface.DfaceDetect.detection ( String  img_path,
boolean  square 
)

检测图片所有的人脸,返回边框,五官定位,可信度

参数
img_path图片地址
返回
返回所有n个人脸边框信息数组
注解
(当未检测到人脸,finalBbox为空列表)
native List<FaceMatBbox> com.dface.DfaceDetect.detectionAndCrop ( DFaceMat  img)

检测人脸并裁剪对齐

参数
img图片数据,以Mat格式输入
返回
返回人脸数据(输出人脸尺寸 112*112),包括回归框,关键点信息
注解
(返回人脸 Size(112x112), 一般用于人脸识别通道的人脸特征提取和人脸比对输入)
native List<Bbox> com.dface.DfaceDetect.detectionMaxFace ( DFaceMat  img,
boolean  square 
)

被检测到的人脸数据,高精度调整人脸信息

参数
img已经被检测到的人脸图片数据(图片只包含一个人脸,且已经被裁剪对齐)
finalBbox返回高精度人脸边框信息
返回
参考参考finalBbox
注解
(当未检测到人脸,finalBbox为空vector) 检测图片的最大人脸,返回边框,五官定位,可信度
参数
img图片数据,以Mat格式输入
返回
参考finalBbox
注解
(当未检测到人脸,finalBbox为空列表)
native List<Bbox> com.dface.DfaceDetect.detectionMaxFace ( String  img_path,
boolean  square 
)

输入1张图片地址, 返回被检测到的最大1个人脸参数,包括边框,五官定位,可信度

参数
img_path图片地址
返回
返回人脸边框信息数组(size=1)
注解
(当未检测到人脸,finalBbox为空列表)
native FaceMatBbox com.dface.DfaceDetect.detectionMaxFaceAndCrop ( DFaceMat  img)

检测最大人脸并裁剪对齐

参数
img图片数据,以Mat格式输入
返回
返回人脸数据,包括回归框,关键点信息
注解
(返回人脸 Size(112x112), 一般用于人脸识别通道的人脸特征提取和人脸比对输入)
native boolean com.dface.DfaceDetect.initLoad ( String  model_path)

通道初始化

参数
model_path模型目录
返回
初始化成功标志
native double [] com.dface.DfaceDetect.predictBlur ( DFaceMat  img,
List< Rect bboxs 
)

判断人脸清晰度

参数
img图片数据,以DFaceMat格式输入
bboxs人脸在图像中对应的边框信息
返回
返回每个人脸对应的清晰度 note (正常人脸清晰度500以上,较模糊的人脸3清晰度在30~300之间)
native int [] com.dface.DfaceDetect.predictLight ( DFaceMat  img,
List< Rect bboxs 
)

判断人脸光照质量

参数
img图片数据,以DFaceMat格式输入
bboxs人脸在图像中对应的边框信息
返回
返回每个人脸对应的光照质量, 0:人脸光照正常 1:人脸光照太暗,曝光太少 2:人脸光照太亮,过度曝光 note (0:人脸光照正常 1:人脸光照太暗,曝光太少 2:人脸光照太亮,过度曝光)
native void com.dface.DfaceDetect.SetMinFace ( int  minSize)

保留 调整需要被检测的最小人脸Size,该值越大,往往检测速度越快,但会漏检小于该尺寸的人脸

参数
minSize最小人脸尺寸
注解
(默认60,可按输入的图片分辨率适当调整,640*480P建议40-60 1280*960P建议100-160)
native void com.dface.DfaceDetect.SetNumThreads ( int  numThreads)

调整并行线程数量,可根据目标机器cpu内核数手动调整

参数
numThreads并行线程数量
注解
(默认单线程)
native boolean com.dface.DfaceDetect.uninitLoad ( )

卸载通道

返回
卸载化成功标志

该类的文档由以下文件生成: