FaceApi (faceapi-码云(gitee.com))

All Known Implementing Classes:

BaseFaceApi, BaseFaceApiLocal, FaceApiDecorator, FaceApiGenericDecorator, FaceApiThriftClient
```
public interface FaceApi
```
人脸识别SDK核心接口
此接口中mat前缀的方法图像数据参数为图像矩阵(要求图像宽高必须为偶数), 其他方法中所有byte[]类型的图像参数都指未解码的图像格式(如jpg,bmp,png...),
目前支持的图像格式类型依赖于JDK的支持能力

Author:

guyadong

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`double`	`compare2Face(byte[] imgData1, CodeInfo facePos1, byte[] imgData2, CodeInfo facePos2)` 对人脸图像提取特征码，返回比较相似度结果 imgData1和imgData2相等或imgData2为`null`时,即比较同一张图像中的两张人脸的相似度调用该方法时假设图像(`imgData1`和`imgData2`)能正常解码, 所以当对图像解码出现异常时，将`ImageErrorException`异常对象封装到`RuntimeException`抛出任何参数为`null`则抛出`IllegalArgumentException`
`double`	`compareCode(byte[] code1, byte[] code2)` 特征码比对参数为`null`或长度不一致则抛出`IllegalArgumentException`异常,返回两个特征码之间的相似度（0.0~1）
`double[]`	`compareCodes(byte[] code1, CodeInfo[] codes)` 特征码比对1:N 返回对应的特征码相似度数组
`CompareResult`	`compareFaces(byte[] code, byte[] imgData, int faceNum)` 特征码比对1:N 对`imgData`图像数据检测人脸并提取特征，然后与`code`特征进行比对, 返回包含比对相似度结果的`CompareResult`实例
`java.util.List<java.lang.Double>`	`compareFeatures(byte[] code1, java.util.List<byte[]> codes)` 特征码比对1:N
`double`	`detectAndCompare2Face(byte[] imgData1, FRect detectRect1, byte[] imgData2, FRect detectRect2)` 对两个图像指定范围(`FRect`)进行人脸检测,找到并提取唯一的人脸特征码,然后比较相似度,返回相似度结果 imgData1和imgData2相等或imgData2为`null`时, 即比较同一张图像中的两张人脸的相似度,这种情况下detectRect1和detectRect2都不能为`null` imgData1和imgData2不相等且都不为`null`时,detectRect1和detectRect2被忽略
`CodeInfo[]`	`detectAndGetCodeInfo(byte[] imgData, int faceNum)` 先对图像数据`imgData`进行人脸检测，然后提取人脸特征码返回所有成功提取特征码的`CodeInfo`数组, 与`getCodeInfo(byte[], int, CodeInfo[])`的返回结果有差别，返回结果中不包含检测到人脸但提取特征码失败的对象
`CodeInfo`	`detectCenterFace(byte[] imgData)` 检测最中心的人脸返回人脸位置数据对象`CodeInfo`
`CodeInfo[]`	`detectFace(byte[] imgData)` 对图像(`imgData`)进行人脸检测，返回人脸位置数据对象`CodeInfo`数组没有检测到人脸则返回空数组
`CodeInfo`	`detectMaxFace(byte[] imgData)` 检测最大的人脸返回人脸位置数据对象`CodeInfo`
`CodeInfo`	`getCodeInfo(byte[] imgData, CodeInfo facePos)` 根据`facePos`提供的人脸信息位置, 在`imgData`图像中提取特征码返回包含人脸特征的`CodeInfo`对象，提取特征失败则返回`null`
`CodeInfo[]`	`getCodeInfo(byte[] imgData, int faceNum, CodeInfo[] facePos)` 根据`facePos`提供的人脸信息位置, 在`imgData`图像中提取特征码与 `detectAndGetCodeInfo(byte[], int)`不同, 本方法不对图像数据`imgData`进行人脸检测, 假设`facePos`是 `detectFace(byte[])`或 `#detectFaceAgain(byte[], FRect[])` 的返回结果返回facePos,如果没有提取到特征码,则对应元素`CodeInfo.getCode()`返回`null`
`byte[]`	`getFeature(java.util.Map<java.nio.ByteBuffer,CodeInfo> faces)` 多张人脸提取特征(用于多张人脸合成一个特征的算法) 返回人脸特征数据 `#multiFaceFeature()`返回`false`时代表此方法未被实现，执行会抛出异常
`boolean`	`hasFace(byte[] imgData)` 判断图像是否能提取到人脸特征码为`true`则能检测到人脸并能提取特征码
`boolean`	`isLocal()` 返回当前接口实现方式 false WebService类型 true 本地实现
`CodeInfo[]`	`matDetectAndGetCodeInfo(net.gdface.image.MatType matType, byte[] matData, int width, int height, int faceNum)` 先对图像矩阵数据`imgData`进行人脸检测，然后提取人脸特征码返回包含人脸特征数据的`CodeInfo`数组
`CodeInfo[]`	`matDetectFace(net.gdface.image.MatType matType, byte[] matData, int width, int height)` 对图像矩阵进行人脸检测返回人脸信息对象列表，没有检测到人脸返回空表
`CodeInfo`	`matDetectMaxFace(net.gdface.image.MatType matType, byte[] matData, int width, int height)` 检测最大的人脸返回人脸位置数据对象`CodeInfo`
`CodeInfo`	`matGetCodeInfo(net.gdface.image.MatType matType, byte[] matData, int width, int height, CodeInfo facePos)` 根据`facePos`提供的人脸信息位置, 在图像矩阵中提取特征码返回包含人脸特征的`CodeInfo`对象，提取特征失败则返回`null`
`CodeInfo[]`	`matGetCodeInfo(net.gdface.image.MatType matType, byte[] matData, int width, int height, int facenum, CodeInfo[] facePos)` 根据facePos提供的人脸信息位置, 在图像矩阵中提取特征码包含人脸特征数据的facePos
`boolean`	`matHasFace(net.gdface.image.MatType matType, byte[] matData, int width, int height)` 判断图像矩阵是否能提取到人脸特征码返回为`true`则能检测到人脸并能提取特征码
`FseResult[]`	`matSearchFaces(net.gdface.image.MatType matType, byte[] matData, int width, int height, CodeInfo facePos, double similarty, int rows)` 1:N 人脸图像搜索对`facePos`指定的人脸位置提取特征码,然后在数据库中搜索相似的人脸返回搜索结果。返回包含相似度计算结果的FseResult数组相似度值通过 FseResult.getSimilartys() 获取对应的人脸特征ID由 FseResult.getFeatureIds()获取
`java.lang.Boolean`	`matWearMask(net.gdface.image.MatType matType, byte[] matData, int width, int height, CodeInfo faceInfo)` 检测指定的人脸是否戴口罩返回值有三种状态: `true` 戴口罩返回 `false` 未戴口罩返回 `null` 不知道
`java.util.Map<java.lang.String,java.lang.String>`	`sdkCapacity()` 返回当前SDK特性(能力)描述,已定义字段: SDK_VERSION [string]SDK版本号 MULTI_FACE_FEATURE [boolean]算法是否支持多人脸合成特征 FACE_LIVE [boolean]是否支持活体检测 WEAR_MASK [boolean]是否支持口罩检测 FDDATA_SIZE [int]人脸检测数据的(byte)长度 FEATURE_SIZE [int]人脸特征数据(byte)长度 MAX_FACE_COUNT [int]最大检测人脸数目 FSE_ENABLE [boolean]是否支持特征内存搜索引擎 CODEINFO_RELOCATE [boolean]是否支持CodeInfo对象重定位 LOCAL_DETECT [boolean] 人脸检测是否为本地实现,未定义则为false 以上字段名常量定义参见`CapacityFieldConstant`
`FseResult[]`	`searchFaces(byte[] imgData, CodeInfo facePos, double similarty, int rows)` 1:N 人脸图像搜索对`facePos`指定的人脸位置提取特征码,然后在数据库中搜索相似的人脸返回搜索结果。返回包含相似度计算结果的FseResult数组相似度值通过 FseResult.getSimilartys() 获取对应的人脸特征ID由 FseResult.getFeatureIds()获取
`FseResult[]`	`searchFeatures(byte[] feature, double similarty, int rows)` 1:N 人脸特征搜索搜索与`code`相似度大于`similarty`的记录(最多返回前`rows`个结果) 返回包含相似度计算结果的`FseResult`数组,返回结果以相似度降序排列相似度值通过 `FseResult#getSimilartys()` 获取对应的人脸特征ID由 `FseResult#getFeatureIds()`获取
`java.lang.Boolean`	`wearMask(byte[] imgData, CodeInfo faceInfo)` 检测指定的人脸是否戴口罩返回值有三种状态: `true` 戴口罩返回 `false` 未戴口罩返回 `null` 不知道

- Method Detail
  - compare2Face
```
double compare2Face(byte[] imgData1,
                    CodeInfo facePos1,
                    byte[] imgData2,
                    CodeInfo facePos2)
             throws NotFaceDetectedException,
                    net.gdface.image.ImageErrorException
```
    对人脸图像提取特征码，返回比较相似度结果
    imgData1和imgData2相等或imgData2为null时,即比较同一张图像中的两张人脸的相似度调用该方法时假设图像(imgData1和imgData2)能正常解码,
    所以当对图像解码出现异常时，将ImageErrorException异常对象封装到RuntimeException抛出
    任何参数为null则抛出IllegalArgumentException
    
    Parameters:
    
    imgData1 - 图像1数据(jpg,png...)字节数组
    
    facePos1 - 检测到的人脸/眼睛位置
    
    imgData2 - 图像1数据(jpg,png...)字节数组
    
    facePos2 - 检测到的人脸/眼睛位置
    
    Returns:
    
    两张人脸之间的相似度(0.0~1)
    
    Throws:
    
    NotFaceDetectedException
    
    net.gdface.image.ImageErrorException
    
    See Also:
    
    getCodeInfo(byte[], int, CodeInfo[]), compareCode(byte[], byte[])
  - detectAndCompare2Face
```
double detectAndCompare2Face(byte[] imgData1,
                             FRect detectRect1,
                             byte[] imgData2,
                             FRect detectRect2)
                      throws net.gdface.image.ImageErrorException,
                             NotFaceDetectedException
```
    对两个图像指定范围(FRect)进行人脸检测,找到并提取唯一的人脸特征码,然后比较相似度,返回相似度结果
    imgData1和imgData2相等或imgData2为null时, 即比较同一张图像中的两张人脸的相似度,这种情况下detectRect1和detectRect2都不能为null
    imgData1和imgData2不相等且都不为null时,detectRect1和detectRect2被忽略
    
    Parameters:
    
    imgData1 - 图像1数据(jpg,png...)字节数组,为null则抛出IllegalArgumentException
    
    detectRect1 - 图片检测范围，为null时全图检测
    
    imgData2 - 图像2数据(jpg,png...)字节数组
    
    detectRect2 - 图片检测范围，为null时全图检测
    
    Returns:
    
    两张人脸之间的相似度(0.0~1)
    
    Throws:
    
    net.gdface.image.ImageErrorException
    
    NotFaceDetectedException
    
    See Also:
    
    detectAndGetCodeInfo(byte[], int), compareCode(byte[], byte[])
  - compareCode
```
double compareCode(byte[] code1,
                   byte[] code2)
```
    特征码比对
    参数为null或长度不一致则抛出IllegalArgumentException异常,返回两个特征码之间的相似度（0.0~1）
    
    Parameters:
    
    code1 - 待比对的特征码
    
    code2 - 待比对的特征码
    
    Returns:
    
    相似度（0.0~1）
  - compareCodes
```
double[] compareCodes(byte[] code1,
                      CodeInfo[] codes)
```
    特征码比对1:N
    返回对应的特征码相似度数组
    
    Parameters:
    
    code1 - 待比对的特征码
    
    codes - 包含人脸特征的CodeInfo数组
    
    Returns:
    
    特征码相似度数组
  - compareFaces
```
CompareResult compareFaces(byte[] code,
                           byte[] imgData,
                           int faceNum)
                    throws NotFaceDetectedException,
                           net.gdface.image.ImageErrorException
```
    特征码比对1:N
    对imgData图像数据检测人脸并提取特征，然后与code特征进行比对, 返回包含比对相似度结果的CompareResult实例
    
    Parameters:
    
    code - 人脸特征数据
    
    imgData - 待比对的图像(jpg,png...)(可能有多张人脸)
    
    faceNum - 参见 getCodeInfo(byte[], int, CodeInfo[])
    
    Returns:
    
    CompareResult实例
    
    Throws:
    
    NotFaceDetectedException - 没有检测到人脸
    
    net.gdface.image.ImageErrorException
    
    See Also:
    
    compareCodes(byte[], CodeInfo[]), detectAndGetCodeInfo(byte[], int)
  - compareFeatures
```
java.util.List<java.lang.Double> compareFeatures(byte[] code1,
                                                 java.util.List<byte[]> codes)
```
    特征码比对1:N
    
    Parameters:
    
    code1 - 人脸特征数据
    
    codes - 一组人脸特征
    
    Returns:
    
    返回对应的特征码相似度列表
  - detectAndGetCodeInfo
```
CodeInfo[] detectAndGetCodeInfo(byte[] imgData,
                                int faceNum)
                         throws net.gdface.image.ImageErrorException,
                                NotFaceDetectedException
```
    先对图像数据imgData进行人脸检测，然后提取人脸特征码
    返回所有成功提取特征码的CodeInfo数组, 与getCodeInfo(byte[], int, CodeInfo[])的返回结果有差别，返回结果中不包含检测到人脸但提取特征码失败的对象
    
    Parameters:
    
    imgData - 图像数据(jpg,png...)字节数组,为null则抛出IllegalArgumentException
    
    faceNum - 参见 getCodeInfo(byte[], int, CodeInfo[])
    
    Returns:
    
    CodeInfo数组
    
    Throws:
    
    net.gdface.image.ImageErrorException
    
    NotFaceDetectedException - 没有检测人脸或提取到特征码的人脸数目不是要求的人脸数目(faceNum>0)
  - wearMask
```
java.lang.Boolean wearMask(byte[] imgData,
                           CodeInfo faceInfo)
                    throws net.gdface.image.ImageErrorException
```
    检测指定的人脸是否戴口罩
    返回值有三种状态:
    - true 戴口罩返回
    - false 未戴口罩返回
    - null 不知道
    Parameters:
    
    imgData - 图像数据(jpg,png...)字节数组,为null则抛出 IllegalArgumentException
    
    faceInfo - 可见光图像人脸信息
    
    Returns:
    
    返回口罩检测结果
    
    Throws:
    
    net.gdface.image.ImageErrorException
    
    Since:
    
    2.1.9
  - detectFace
```
CodeInfo[] detectFace(byte[] imgData)
               throws net.gdface.image.ImageErrorException
```
    对图像(imgData)进行人脸检测，返回人脸位置数据对象CodeInfo数组
    没有检测到人脸则返回空数组
    
    Parameters:
    
    imgData - 图像数据(jpg,png...)字节数组,为null则抛出IllegalArgumentException
    
    Returns:
    
    CodeInfo数组
    
    Throws:
    
    net.gdface.image.ImageErrorException - 图像读取错误
  - detectCenterFace
```
CodeInfo detectCenterFace(byte[] imgData)
                   throws NotFaceDetectedException,
                          net.gdface.image.ImageErrorException
```
    检测最中心的人脸
    返回人脸位置数据对象CodeInfo
    
    Parameters:
    
    imgData - 图像数据(jpg,png...)字节数组,为null则抛出IllegalArgumentException
    
    Returns:
    
    CodeInfo
    
    Throws:
    
    NotFaceDetected - 没有检测到人脸
    
    ImageError - 图像读取错误
    
    NotFaceDetectedException
    
    net.gdface.image.ImageErrorException
  - detectMaxFace
```
CodeInfo detectMaxFace(byte[] imgData)
                throws NotFaceDetectedException,
                       net.gdface.image.ImageErrorException
```
    检测最大的人脸
    返回人脸位置数据对象CodeInfo
    
    Parameters:
    
    imgData - 图像数据(jpg,png...)字节数组,为null则抛出IllegalArgumentException
    
    Returns:
    
    CodeInfo
    
    Throws:
    
    NotFaceDetected - 没有检测到人脸
    
    ImageError - 图像读取错误
    
    NotFaceDetectedException
    
    net.gdface.image.ImageErrorException
  - getCodeInfo
```
CodeInfo[] getCodeInfo(byte[] imgData,
                       int faceNum,
                       CodeInfo[] facePos)
                throws NotFaceDetectedException
```
    根据facePos提供的人脸信息位置, 在imgData图像中提取特征码
    与 detectAndGetCodeInfo(byte[], int)不同, 本方法不对图像数据imgData进行人脸检测,
    假设facePos是 detectFace(byte[])或 #detectFaceAgain(byte[], FRect[]) 的返回结果
    返回facePos,如果没有提取到特征码,则对应元素CodeInfo.getCode()返回null
    
    Parameters:
    
    imgData - 图像数据(jpg,png...)字节数组,为null则抛出 IllegalArgumentException
    
    faceNum - 要求返回的人脸特征码数目
    大于0时，如果实际提取到的人脸特征码数目不等于faceNum,则抛出NotFaceDetectedException
    小于等于0时，返回所有提取到到人脸特征码
    
    facePos - 检测到的人脸位置对象列表
    为null或数组长度为0时抛出IllegalArgumentException
    如果元素为null,则跳过
    
    Returns:
    
    返回facePos
    
    Throws:
    
    NotFaceDetectedException - 提取特征码的人脸数目为0或没有提取到指定数目(faceNum大于0时)的特征码
  - getCodeInfo
```
CodeInfo getCodeInfo(byte[] imgData,
                     CodeInfo facePos)
```
    根据facePos提供的人脸信息位置, 在imgData图像中提取特征码
    返回包含人脸特征的CodeInfo对象，提取特征失败则返回null
    
    Parameters:
    
    imgData - 图像数据(jpg,png...)字节数组,为null则抛出 IllegalArgumentException
    
    facePos - 人脸位置信息对象，为null则抛出异常
    
    Returns:
    
    CodeInfo or null
  - getFeature
```
byte[] getFeature(java.util.Map<java.nio.ByteBuffer,CodeInfo> faces)
           throws NotFaceDetectedException
```
    多张人脸提取特征(用于多张人脸合成一个特征的算法)
    返回人脸特征数据 #multiFaceFeature()返回false时代表此方法未被实现，执行会抛出异常
    
    Parameters:
    
    faces - 人脸图像数据(jpg,png...)与人脸位置信息对象的映射
    
    Returns:
    
    人脸特征数据
    
    Throws:
    
    NotFaceDetectedException
  - hasFace
```
boolean hasFace(byte[] imgData)
         throws net.gdface.image.ImageErrorException
```
    判断图像是否能提取到人脸特征码
    为true则能检测到人脸并能提取特征码
    
    Parameters:
    
    imgData - 图像数据(jpg,png...)字节数组,为null则抛出IllegalArgumentException
    
    Returns:
    
    为true则能检测到人脸并能提取特征码
    
    Throws:
    
    net.gdface.image.ImageErrorException
    
    See Also:
    
    detectAndGetCodeInfo(byte[], int)
  - searchFeatures
```
FseResult[] searchFeatures(byte[] feature,
                           double similarty,
                           int rows)
```
    1:N 人脸特征搜索
    搜索与code相似度大于similarty的记录(最多返回前rows个结果)
    返回包含相似度计算结果的FseResult数组,返回结果以相似度降序排列
    相似度值通过 FseResult#getSimilartys() 获取
    对应的人脸特征ID由 FseResult#getFeatureIds()获取
    
    Parameters:
    
    feature - 要搜索的特征码
    
    similarty - 相似度阀值
    
    rows - 最多返回的记录数目
    
    Returns:
    
    包含相似度计算结果的FseResult数组
    
    Throws:
    
    java.lang.UnsupportedOperationException - 没有人脸识别算法(FaceApi实例)支持
    
    Since:
    
    3.0.0
  - searchFaces
```
FseResult[] searchFaces(byte[] imgData,
                        CodeInfo facePos,
                        double similarty,
                        int rows)
                 throws NotFaceDetectedException,
                        net.gdface.image.ImageErrorException
```
    1:N 人脸图像搜索
    对facePos指定的人脸位置提取特征码,然后在数据库中搜索相似的人脸返回搜索结果。
    返回包含相似度计算结果的FseResult数组
    相似度值通过 FseResult.getSimilartys() 获取
    对应的人脸特征ID由 FseResult.getFeatureIds()获取
    
    Parameters:
    
    imgData - 图片字节数组
    
    facePos - 人脸位置对象
    为null时,先做人脸检测再提取特征码
    不为null时,直接在指定的位置提取特征码
    
    similarty - 相似度阀值
    
    rows - 最多返回的记录数目
    
    Returns:
    
    包含相似度计算结果的FseResult数组
    
    Throws:
    
    NotFaceDetectedException - -
    
    net.gdface.image.ImageErrorException - -
    
    java.lang.UnsupportedOperationException - 没有人脸识别算法(FaceApi实例)支持
    
    Since:
    
    3.0.0
    
    See Also:
    
    getCodeInfo(byte[], int, CodeInfo[]), searchFeatures(byte[], double, int)
  - matDetectFace
```
CodeInfo[] matDetectFace(net.gdface.image.MatType matType,
                         byte[] matData,
                         int width,
                         int height)
```
    对图像矩阵进行人脸检测
    返回人脸信息对象列表，没有检测到人脸返回空表
    
    Parameters:
    
    matType - 图像矩阵类型
    
    matData - 图像矩阵
    
    width - 图像宽度
    
    height - 图像高度
    
    Returns:
    
    人脸信息对象列表
    
    Since:
    
    2.1.9
  - matDetectMaxFace
```
CodeInfo matDetectMaxFace(net.gdface.image.MatType matType,
                          byte[] matData,
                          int width,
                          int height)
                   throws NotFaceDetectedException
```
    检测最大的人脸
    返回人脸位置数据对象CodeInfo
    
    Parameters:
    
    imgData - 图像数据(jpg,png...)字节数组,为null则抛出IllegalArgumentException
    
    Returns:
    
    CodeInfo
    
    Throws:
    
    NotFaceDetected - 没有检测到人脸
    
    NotFaceDetectedException
    
    Since:
    
    2.1.9
  - matGetCodeInfo
```
CodeInfo matGetCodeInfo(net.gdface.image.MatType matType,
                        byte[] matData,
                        int width,
                        int height,
                        CodeInfo facePos)
```
    根据facePos提供的人脸信息位置, 在图像矩阵中提取特征码
    返回包含人脸特征的CodeInfo对象，提取特征失败则返回null
    
    Parameters:
    
    matType - 图像矩阵类型
    
    matData - 图像矩阵
    
    width - 图像宽度
    
    height - 图像高度
    
    facePos - 人脸位置信息对象，为null则抛出异常
    
    Returns:
    
    CodeInfo or null
  - matGetCodeInfo
```
CodeInfo[] matGetCodeInfo(net.gdface.image.MatType matType,
                          byte[] matData,
                          int width,
                          int height,
                          int facenum,
                          CodeInfo[] facePos)
                   throws NotFaceDetectedException
```
    根据facePos提供的人脸信息位置, 在图像矩阵中提取特征码
    包含人脸特征数据的facePos
    
    Parameters:
    
    matType - 图像矩阵类型
    
    matData - 图像矩阵
    
    width - 图像宽度
    
    height - 图像高度
    
    facenum - 要求返回的人脸特征码数目
    大于0时，如果实际提取到的人脸特征码数目不等于faceNum,则抛出NotFaceDetectedException
    小于等于0时，返回所有提取到到人脸特征码
    
    facePos - 人脸位置信息对象,不可为null
    
    Returns:
    
    always facePos
    
    Throws:
    
    NotFaceDetectedException - 提取特征码的人脸数目为0或没有提取到指定数目(faceNum大于0时)的特征码
    
    Since:
    
    2.1.9
  - matDetectAndGetCodeInfo
```
CodeInfo[] matDetectAndGetCodeInfo(net.gdface.image.MatType matType,
                                   byte[] matData,
                                   int width,
                                   int height,
                                   int faceNum)
                            throws NotFaceDetectedException
```
    先对图像矩阵数据imgData进行人脸检测，然后提取人脸特征码
    返回包含人脸特征数据的CodeInfo数组
    
    Parameters:
    
    matType - 图像矩阵类型
    
    matData - 图像矩阵
    
    width - 图像宽度
    
    height - 图像高度
    
    faceNum - 参见 getCodeInfo(byte[], int, CodeInfo[])
    
    Returns:
    
    CodeInfo数组
    
    Throws:
    
    NotFaceDetectedException
    
    Since:
    
    2.1.9
  - matWearMask
```
java.lang.Boolean matWearMask(net.gdface.image.MatType matType,
                              byte[] matData,
                              int width,
                              int height,
                              CodeInfo faceInfo)
```
    检测指定的人脸是否戴口罩
    返回值有三种状态:
    - true 戴口罩返回
    - false 未戴口罩返回
    - null 不知道
    Parameters:
    
    matType - 图像矩阵类型
    
    matData - 图像矩阵
    
    width - 图像宽度
    
    height - 图像高度
    
    faceInfo - 人脸位置信息
    
    Returns:
    
    返回口罩检测结果
    
    Since:
    
    2.1.9
  - matHasFace
```
boolean matHasFace(net.gdface.image.MatType matType,
                   byte[] matData,
                   int width,
                   int height)
```
    判断图像矩阵是否能提取到人脸特征码
    返回为true则能检测到人脸并能提取特征码
    
    Parameters:
    
    matType - 图像矩阵类型
    
    matData - 图像矩阵,为null则抛出IllegalArgumentException
    
    width - 图像宽度
    
    height - 图像高度
    
    Returns:
    
    为true则能检测到人脸并能提取特征码
    
    Since:
    
    2.1.9
  - matSearchFaces
```
FseResult[] matSearchFaces(net.gdface.image.MatType matType,
                           byte[] matData,
                           int width,
                           int height,
                           CodeInfo facePos,
                           double similarty,
                           int rows)
                    throws NotFaceDetectedException,
                           net.gdface.image.ImageErrorException
```
    1:N 人脸图像搜索
    对facePos指定的人脸位置提取特征码,然后在数据库中搜索相似的人脸返回搜索结果。
    返回包含相似度计算结果的FseResult数组
    相似度值通过 FseResult.getSimilartys() 获取
    对应的人脸特征ID由 FseResult.getFeatureIds()获取
    
    Parameters:
    
    matType - 图像矩阵类型
    
    matData - 图像矩阵
    
    width - 图像宽度
    
    facePos - 人脸位置对象
    为null时,先做人脸检测再提取特征码
    不为null时,直接在指定的位置提取特征码
    
    similarty - 相似度阀值
    
    rows - 最多返回的记录数目
    
    Returns:
    
    包含相似度计算结果的FseResult数组
    
    Throws:
    
    NotFaceDetectedException - -
    
    net.gdface.image.ImageErrorException - -
    
    java.lang.UnsupportedOperationException - 没有人脸识别算法(FaceApi实例)支持
    
    Since:
    
    3.0.0
    
    See Also:
    
    getCodeInfo(byte[], int, CodeInfo[]), searchFeatures(byte[], double, int)
  - sdkCapacity
```
java.util.Map<java.lang.String,java.lang.String> sdkCapacity()
```
    返回当前SDK特性(能力)描述,已定义字段:
    - SDK_VERSION [string]SDK版本号
    - MULTI_FACE_FEATURE [boolean]算法是否支持多人脸合成特征
    - FACE_LIVE [boolean]是否支持活体检测
    - WEAR_MASK [boolean]是否支持口罩检测
    - FDDATA_SIZE [int]人脸检测数据的(byte)长度
    - FEATURE_SIZE [int]人脸特征数据(byte)长度
    - MAX_FACE_COUNT [int]最大检测人脸数目
    - FSE_ENABLE [boolean]是否支持特征内存搜索引擎
    - CODEINFO_RELOCATE [boolean]是否支持CodeInfo对象重定位
    - LOCAL_DETECT [boolean] 人脸检测是否为本地实现,未定义则为false
    以上字段名常量定义参见CapacityFieldConstant
    Returns:
    
    key-value 对描述算法能力的映射
    
    Since:
    
    2.2.7
  - isLocal
```
boolean isLocal()
```
    返回当前接口实现方式
    false WebService类型
    true 本地实现
    
    Returns:
    
    boolean

Interface FaceApi

Method Summary

Method Detail

compare2Face

detectAndCompare2Face

compareCode

compareCodes

compareFaces

compareFeatures

detectAndGetCodeInfo

wearMask

detectFace

detectCenterFace

detectMaxFace

getCodeInfo

getCodeInfo

getFeature

hasFace

searchFeatures

searchFaces

matDetectFace

matDetectMaxFace

matGetCodeInfo

matGetCodeInfo

matDetectAndGetCodeInfo

matWearMask

matHasFace

matSearchFaces

sdkCapacity

isLocal