net.gdface.mtfsdk

类 FaceApiMtfAndroid

java.lang.Object

net.gdface.sdk.BaseFaceApi

net.gdface.sdk.BaseFaceApiLocal

net.gdface.mtfsdk.FaceApiMtfAndroid

所有已实现的接口:

net.gdface.sdk.FaceApi

public class FaceApiMtfAndroid
extends net.gdface.sdk.BaseFaceApiLocal

MTFSDK android/arm平台 FaceApi接口实现类(线程安全)
基于commons-pools将非线程安全的MtfAndroidArmBridge实例用资源池GenericObjectPool管理, 每次调用前从资源池申请一个MtfAndroidArmBridge实例来使用，用完后归还资源池， 以实现对MtfAndroidArmBridge实例线程安全的调用

作者:

guyadong

字段概要

从类继承的字段 net.gdface.sdk.BaseFaceApiLocal

auxTool, concurrentLock, NOTFACEDETECTED_INSTANCE_DEFAULT

构造器概要

构造器

限定符	构造器和说明
protected	FaceApiMtfAndroid()

方法概要

方法

限定符和类型	方法和说明
net.gdface.sdk.CodeInfo[]	detectAndGetCodeInfo(android.graphics.Bitmap bitmap, int faceNum) 检测并提取人脸特征
java.util.List<net.gdface.sdk.CodeInfo>	detectFace(android.graphics.Bitmap bitmap) 检测人脸
NativeFaceInfo	detectMaxFace(android.graphics.Bitmap bitmap) 已过时。 replaced by detectMaxFace(Bitmap, int)
NativeFaceInfo	detectMaxFace(android.graphics.Bitmap bitmap, int detectMod)
int	facePosInterrelate(int faceNums, double rectRate, double[] faceRect, double[] faceRectInfo) 位置关联 在人脸检测函数后用到，无论有无检测到人脸，均需要调用，从属于检测系列
net.gdface.sdk.CodeInfo	getCodeInfo(android.graphics.Bitmap bitmap, net.gdface.sdk.CodeInfo facePos) 提取单个人脸特征
java.util.List<net.gdface.sdk.CodeInfo>	getCodeInfo(android.graphics.Bitmap bitmap, int faceNum, java.util.List<net.gdface.sdk.CodeInfo> facePos) 提取特征
int	getDetectInfo(byte[] BGR, int width, int height, double[] rect, double[] rectinfo) 已过时。 人脸检测原始数据中已经包含了人脸角度,不再需要此函数
net.gdface.sdk.fse.FeatureSe	getFeatureSe()
static net.gdface.sdk.FaceApiGenericDecorator	getGenericInstance() 返回支持泛型封闭的单实例
static FaceApiMtfAndroid	getInstance() 返回单实例
static net.gdface.license.LicenseManager	licenseManager()
boolean	liveProcess(android.graphics.Bitmap bitmap, NativeFaceInfo faceinfo)
protected double	nativeCompareCode(byte[] code1, byte[] code2)
void	nativeDetectFace(byte[] imgMatrix, int width, int height, java.util.List<net.gdface.sdk.CodeInfo> faceInfo) 人脸检测，最多返回三张人脸
void	nativeDetectFace(byte[] imgMatrix, int width, int height, java.util.List<net.gdface.sdk.CodeInfo> faceInfo, int detectMod) 人脸检测，最多返回三张人脸
NativeFaceInfo	nativeDetectMaxFace(byte[] imgMatrix, int width, int height) 已过时。 replaced by nativeDetectMaxFace(byte[], int, int, int)
NativeFaceInfo	nativeDetectMaxFace(byte[] imgMatrix, int width, int height, int detectMod) 执行单人脸检测，返回最大人脸位置信息
byte[]	nativeGetFaceFeature(byte[] imgMatrix, int width, int height, net.gdface.sdk.CodeInfo faceInfo)
boolean	nativeLiveProcess(byte[] BGR, int width, int height, double[] rect) 执行活体检测
java.lang.String	sdkVersion()
int	setFacePosStatus(int facePos, int flag)

从类继承的方法 net.gdface.sdk.BaseFaceApiLocal

compareCode, detectAndGetCodeInfo, detectAndGetCodeInfo, detectFace, detectFace, getCodeInfo, getCodeInfo, getCodeInfo, getCodeInfo, getMatrixData, isLocal, makeOpenedLazyImage, nativeDetectAndGetFeatures, nativeGetFaceFeatures, setAuxTool

从类继承的方法 net.gdface.sdk.BaseFaceApi

compare2Face, compareCodes, compareFaces, compareFeatures, detectAndCompare2Face, detectCenterFace, getFeature, getFeatureSeInstance, hasFace, multiFaceFeature

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

FaceApiMtfAndroid

protected FaceApiMtfAndroid()

方法详细资料

getInstance

public static FaceApiMtfAndroid getInstance()

返回单实例

返回:

the instance

getGenericInstance

public static net.gdface.sdk.FaceApiGenericDecorator getGenericInstance()

返回支持泛型封闭的单实例

返回:

licenseManager

public static net.gdface.license.LicenseManager licenseManager()

返回:

返回SDK的授权信息管理实例

sdkVersion

public final java.lang.String sdkVersion()

指定者:

sdkVersion 在接口中 net.gdface.sdk.FaceApi

覆盖:

sdkVersion 在类中 net.gdface.sdk.BaseFaceApi

nativeCompareCode

protected double nativeCompareCode(byte[] code1,
                       byte[] code2)

指定者:

nativeCompareCode 在类中 net.gdface.sdk.BaseFaceApiLocal

nativeDetectFace

public void nativeDetectFace(byte[] imgMatrix,
                    int width,
                    int height,
                    java.util.List<net.gdface.sdk.CodeInfo> faceInfo)

人脸检测，最多返回三张人脸

指定者:

nativeDetectFace 在类中 net.gdface.sdk.BaseFaceApiLocal

nativeGetFaceFeature

public byte[] nativeGetFaceFeature(byte[] imgMatrix,
                          int width,
                          int height,
                          net.gdface.sdk.CodeInfo faceInfo)

指定者:

nativeGetFaceFeature 在类中 net.gdface.sdk.BaseFaceApiLocal

nativeDetectFace

public void nativeDetectFace(byte[] imgMatrix,
                    int width,
                    int height,
                    java.util.List<net.gdface.sdk.CodeInfo> faceInfo,
                    int detectMod)

人脸检测，最多返回三张人脸

另请参阅:

MtfAndroidArmBridge.detect(byte[], int, int, int, double[])

nativeDetectMaxFace

public NativeFaceInfo nativeDetectMaxFace(byte[] imgMatrix,
                                 int width,
                                 int height)

已过时。 replaced by nativeDetectMaxFace(byte[], int, int, int)

nativeDetectMaxFace

public NativeFaceInfo nativeDetectMaxFace(byte[] imgMatrix,
                                 int width,
                                 int height,
                                 int detectMod)

执行单人脸检测，返回最大人脸位置信息

参数:

imgMatrix -

width -

height -

detectMod - 0:用于检测图片,1:用于视频的循环检测

返回:

detectMaxFace

public NativeFaceInfo detectMaxFace(android.graphics.Bitmap bitmap)

已过时。 replaced by detectMaxFace(Bitmap, int)

detectMaxFace

public NativeFaceInfo detectMaxFace(android.graphics.Bitmap bitmap,
                           int detectMod)

另请参阅:

nativeDetectMaxFace(byte[], int, int, int)

facePosInterrelate

public int facePosInterrelate(int faceNums,
                     double rectRate,
                     double[] faceRect,
                     double[] faceRectInfo)

位置关联 在人脸检测函数后用到，无论有无检测到人脸，均需要调用，从属于检测系列

参数:

faceNums - 人脸个数

rectRate -

faceRect - 人脸信息(人脸检测数据rect) 21个元素

faceRectInfo - [out]返回的标记，最后一个元素为是否成功比对的标志，其他为人脸信息

返回:

位置关联总个数

getDetectInfo

public int getDetectInfo(byte[] BGR,
                int width,
                int height,
                double[] rect,
                double[] rectinfo)

已过时。 人脸检测原始数据中已经包含了人脸角度,不再需要此函数

从检测原始数据获取人脸角度

参数:

BGR -

width -

height -

rect - 人脸检测原始数据

rectinfo - [out] leng>=3,不可为null,返回3个元素 1: roll 2: yaw 3: pitch

返回:

setFacePosStatus

public int setFacePosStatus(int facePos,
                   int flag)

nativeLiveProcess

public boolean nativeLiveProcess(byte[] BGR,
                        int width,
                        int height,
                        double[] rect)

执行活体检测

参数:

BGR - 输入的BGR格式图像

width - 图像宽度

height - 图像高度

rect - nativeDetectFace(byte[], int, int, List)方法返回的人脸检测信息原始数据， 参见NativeFaceInfo.getNativeData()

返回:

false--非活体,true--活体

liveProcess

public boolean liveProcess(android.graphics.Bitmap bitmap,
                  NativeFaceInfo faceinfo)

另请参阅:

nativeLiveProcess(byte[], int, int, double[])

detectFace

public java.util.List<net.gdface.sdk.CodeInfo> detectFace(android.graphics.Bitmap bitmap)

检测人脸

参数:

bitmap -

返回:

另请参阅:

BaseFaceApiLocal.detectFace(net.gdface.image.BaseLazyImage)

getCodeInfo

public java.util.List<net.gdface.sdk.CodeInfo> getCodeInfo(android.graphics.Bitmap bitmap,
                                                  int faceNum,
                                                  java.util.List<net.gdface.sdk.CodeInfo> facePos)
                                                    throws net.gdface.sdk.NotFaceDetectedException

提取特征

参数:

bitmap -

faceNum -

facePos -

返回:

抛出:

net.gdface.sdk.NotFaceDetectedException

另请参阅:

BaseFaceApiLocal.getCodeInfo(net.gdface.image.BaseLazyImage, int, List)

getCodeInfo

public net.gdface.sdk.CodeInfo getCodeInfo(android.graphics.Bitmap bitmap,
                                  net.gdface.sdk.CodeInfo facePos)

提取单个人脸特征

参数:

bitmap -

facePos -

返回:

detectAndGetCodeInfo

public net.gdface.sdk.CodeInfo[] detectAndGetCodeInfo(android.graphics.Bitmap bitmap,
                                             int faceNum)
                                               throws net.gdface.sdk.NotFaceDetectedException

检测并提取人脸特征

参数:

bitmap -

faceNum -

返回:

抛出:

net.gdface.sdk.NotFaceDetectedException

另请参阅:

BaseFaceApiLocal#detectAndGetCodeInfo(net.gdface.image.BaseLazyImage, int)}

getFeatureSe

public net.gdface.sdk.fse.FeatureSe getFeatureSe()

覆盖:

getFeatureSe 在类中 net.gdface.sdk.BaseFaceApiLocal