DFace SDK  1.8.5
dface::DfaceCompare类 参考abstract

DFace人脸比对API抽象层(DFaceCompare) 更多...

#include <dface_compare.h>

Public 成员函数

virtual float similarityByFeature (std::vector< float > &feature_1, std::vector< float > &feature_2) const =0
 
virtual float similarityByFeature (float *feature_1, float *feature_2, int feature_size=512) const =0
 
virtual void similarityByFeatureSort (std::vector< float > &feature_1, std::vector< std::vector< float > > &feature_n, std::vector< unsigned int > &idx_n, std::vector< float > &out_simi, std::vector< unsigned int > &out_idx, int top=0, float threshold=0.0) const =0
 
virtual void similarityByFeature (std::vector< float > &feature_1, std::vector< std::vector< float > > &feature_n, std::vector< float > &out_simi) const =0
 
virtual float similarityMaxByFeature (std::vector< float > &feature_1, std::vector< std::vector< float > > &feature_n) const =0
 
virtual float similarityMaxByFeature (float *feature_1, float **feature_n, int feature_count, int feature_size=512) const =0
 
virtual void similarityByFeatureSort (float *feature_1, float **feature_n, int feature_count, std::vector< unsigned int > &idx_n, std::vector< float > &out_simi, std::vector< unsigned int > &out_idx, int feature_size=512, int top=0, float threshold=0.0) const =0
 
virtual void similarityByFeature (float *feature_1, float **feature_n, int feature_count, std::vector< float > &out_simi, int feature_size=512) const =0
 
virtual void SetNumThreads (int numThreads)=0
 
virtual void SetAccuracy (int accuracy)=0
 
virtual int GetNumThreads () const =0
 

详细描述

DFace人脸比对API抽象层(DFaceCompare)

成员函数说明

virtual int dface::DfaceCompare::GetNumThreads ( ) const
pure virtual

获得当前通道并行线程数量

返回
返回并行线程数量
virtual void dface::DfaceCompare::SetAccuracy ( int  accuracy)
pure virtual

设置精度模式 (0:普通精度 1:超高精度 2:实时模式)

参数
accuracy精度模式
注解
(精度越高,越耗计算量)
virtual void dface::DfaceCompare::SetNumThreads ( int  numThreads)
pure virtual

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

参数
numThreads并行线程数量
注解
(默认单线程)
virtual float dface::DfaceCompare::similarityByFeature ( std::vector< float > &  feature_1,
std::vector< float > &  feature_2 
) const
pure virtual

根据两个人脸特征数组,判断相似度

参数
feature_1第一个特征(512或128个浮点数)
feature_2第二个特征(512或128个浮点数)
返回
返回相似度
注解
(相似度范围(0.0~1.0),值越大越相似)
virtual float dface::DfaceCompare::similarityByFeature ( float *  feature_1,
float *  feature_2,
int  feature_size = 512 
) const
pure virtual

根据两个人脸特征数组,判断相似度

参数
feature_1第一个特征(512或128个浮点数)
feature_2第二个特征(512或128个浮点数)
feature_size特征值个数(普通模式和高精度模式512,实时模式128, 默认512)
返回
返回相似度
注解
(相似度范围(0.0~1.0),值越大越相似)
virtual void dface::DfaceCompare::similarityByFeature ( std::vector< float > &  feature_1,
std::vector< std::vector< float > > &  feature_n,
std::vector< float > &  out_simi 
) const
pure virtual

比较特征值数组(1:n),返回相似度

参数
feature_11个人脸人特征(512或128个浮点数)
feature_nn个人脸特征数组
out_simi返回的相似度列表
返回
参照out_simi
注解
(相似度范围(0.0~1.0),值越大越相似)
virtual void dface::DfaceCompare::similarityByFeature ( float *  feature_1,
float **  feature_n,
int  feature_count,
std::vector< float > &  out_simi,
int  feature_size = 512 
) const
pure virtual

比较特征值数组(1:n),判断相似度(该函数支持多线程高性能并行运算)

参数
feature_11个人脸人特征(512或128个浮点数)
feature_nn个人脸特征数组
feature_count特征数组个数(size=n)
out_simi返回的相似度数组
feature_size特征值个数(普通模式和高精度模式 512,实时模式 128, 默认512)
返回
参照res_simi
注解
(相似度范围(0.0~1.0),值越大越相似)
virtual void dface::DfaceCompare::similarityByFeatureSort ( std::vector< float > &  feature_1,
std::vector< std::vector< float > > &  feature_n,
std::vector< unsigned int > &  idx_n,
std::vector< float > &  out_simi,
std::vector< unsigned int > &  out_idx,
int  top = 0,
float  threshold = 0.0 
) const
pure virtual

比较特征值数组(1:n),返回有序相似度(该函数支持多线程高性能并行运算)

参数
feature_11个人脸人特征(512或128个浮点数)
feature_nn个人脸特征数组
out_simi返回排序后的相似度
out_idx返回排序后对应的下标
top返回前top个相似度 默认0表示返回所有
threshold相似度阀值,只返回大于此阀值的相似度,默认0.0返回所有
返回
参照out_simi out_idx
注解
(相似度范围(0.0~1.0),值越大越相似)
virtual void dface::DfaceCompare::similarityByFeatureSort ( float *  feature_1,
float **  feature_n,
int  feature_count,
std::vector< unsigned int > &  idx_n,
std::vector< float > &  out_simi,
std::vector< unsigned int > &  out_idx,
int  feature_size = 512,
int  top = 0,
float  threshold = 0.0 
) const
pure virtual

比较特征值数组(1:n),返回有序相似度(该函数支持多线程高性能并行运算)

参数
feature_11个人脸人特征(512或128个浮点数)
feature_nn个人脸特征数组
feature_count1:n的n
out_simi返回排序后的相似度
out_idx返回排序后对应的下标
feature_size特征值个数(普通模式和高精度模式 512,实时模式 128, 默认512)
top返回前top个相似度 默认0表示返回所有
threshold相似度阀值,只返回大于此阀值的相似度,默认0.0返回所有
返回
参照out_simi out_idx
注解
(相似度范围(0.0~1.0),值越大越相似)
virtual float dface::DfaceCompare::similarityMaxByFeature ( std::vector< float > &  feature_1,
std::vector< std::vector< float > > &  feature_n 
) const
pure virtual

比较特征值数组(1:n),判断最大相似度

参数
feature_11个人脸人特征(512或128个浮点数)
feature_nn个人脸特征数组
返回
返回1:n的最大相似度
注解
(相似度范围(0.0~1.0),值越大越相似)
virtual float dface::DfaceCompare::similarityMaxByFeature ( float *  feature_1,
float **  feature_n,
int  feature_count,
int  feature_size = 512 
) const
pure virtual

比较特征值数组(1:n),判断最大相似度(该函数支持多线程高性能并行运算)

参数
feature_11个人脸人特征(512或128个浮点数)
feature_nn个人脸特征数组
feature_count1:n的n
feature_size特征值个数(普通模式和高精度模式512,实时模式128, 默认512)
返回
返回1:n的最大相似度
注解
(相似度范围(0.0~1.0),值越大越相似)

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