cv::FaceRecognizerSF Class Reference

DNN-based face recognizer. More...

#include <opencv2/objdetect/face.hpp>

Collaboration diagram for cv::FaceRecognizerSF:

Public Types
enum	DisType {   FR_COSINE =0 ,   FR_NORM_L2 =1 }
	Definition of distance used for calculating the distance between two face features. More...

Public Member Functions
virtual	~FaceRecognizerSF ()
virtual void	alignCrop (InputArray src_img, InputArray face_box, OutputArray aligned_img) const =0
	Aligning image to put face on the standard position.
virtual void	feature (InputArray aligned_img, OutputArray face_feature)=0
	Extracting face feature from aligned image.
virtual double	match (InputArray face_feature1, InputArray face_feature2, int dis_type=FaceRecognizerSF::FR_COSINE) const =0
	Calculating the distance between two face features.

Static Public Member Functions
static Ptr< FaceRecognizerSF >	create (CV_WRAP_FILE_PATH const String &model, CV_WRAP_FILE_PATH const String &config, int backend_id=0, int target_id=0)
	Creates an instance of this class with given parameters.

Detailed Description

DNN-based face recognizer.

model download link: https://github.com/opencv/opencv_zoo/tree/master/models/face_recognition_sface

Member Enumeration Documentation

DisType

enum cv::FaceRecognizerSF::DisType

Definition of distance used for calculating the distance between two face features.

Enumerator
FR_COSINE
FR_NORM_L2

Constructor & Destructor Documentation

~FaceRecognizerSF()

virtual cv::FaceRecognizerSF::~FaceRecognizerSF ( )

inlinevirtual

Member Function Documentation

alignCrop()

virtual void cv::FaceRecognizerSF::alignCrop ( InputArray  src_img, InputArray  face_box, OutputArray  aligned_img  ) const

pure virtual

Python:
	cv.FaceRecognizerSF.alignCrop(	src_img, face_box[, aligned_img]	) ->	aligned_img

Aligning image to put face on the standard position.

Parameters

src_img	input image
face_box	the detection result used for indicate face in input image
aligned_img	output aligned image

create()

static Ptr< FaceRecognizerSF > cv::FaceRecognizerSF::create ( CV_WRAP_FILE_PATH const String &  model, CV_WRAP_FILE_PATH const String &  config, int  backend_id = 0, int  target_id = 0  )

static

Python:
	cv.FaceRecognizerSF.create(	model, config[, backend_id[, target_id]]	) ->	retval
	cv.FaceRecognizerSF_create(	model, config[, backend_id[, target_id]]	) ->	retval

Creates an instance of this class with given parameters.

Parameters

model	the path of the onnx model used for face recognition
config	the path to the config file for compability, which is not requested for ONNX models
backend_id	the id of backend
target_id	the id of target device

feature()

virtual void cv::FaceRecognizerSF::feature ( InputArray  aligned_img, OutputArray  face_feature  )

pure virtual

Python:
	cv.FaceRecognizerSF.feature(	aligned_img[, face_feature]	) ->	face_feature

Extracting face feature from aligned image.

Parameters

aligned_img	input aligned image
face_feature	output face feature

match()

virtual double cv::FaceRecognizerSF::match ( InputArray  face_feature1, InputArray  face_feature2, int  dis_type = FaceRecognizerSF::FR_COSINE  ) const

pure virtual

Python:
	cv.FaceRecognizerSF.match(	face_feature1, face_feature2[, dis_type]	) ->	retval

Calculating the distance between two face features.

Parameters

face_feature1	the first input feature
face_feature2	the second input feature of the same size and the same type as face_feature1
dis_type	defining the similarity with optional values "FR_OSINE" or "FR_NORM_L2"

---

The documentation for this class was generated from the following file:

• opencv2/objdetect/face.hpp