Class DeepLearningFaceRecognizer

Definition

Namespace:

Tizen.Multimedia.Vision

Assembly:

Tizen.Multimedia.Vision.dll

Provides the ability to recognize face based on previously registered face data.

public class DeepLearningFaceRecognizer : IDisposable

Inheritance

object

DeepLearningFaceRecognizer

Implements

System.IDisposable

Constructors

DeepLearningFaceRecognizer()

Initializes a new instance of the DeepLearningFaceRecognizer class.

Declaration

public DeepLearningFaceRecognizer()

Remarks

This class is different from FaceRecognizer in aspect of using internal machine learning algorithm.

Exceptions

Type	Condition
System.NotSupportedException	The required features are not supported.

Methods

Dispose()

Releases all resources used by the DeepLearningFaceRecognizer.

Declaration

public void Dispose()

Dispose(bool)

Releases the unmanaged resources used by the DeepLearningFaceRecognizer.

Declaration

protected virtual void Dispose(bool disposing)

Parameters

Type	Name	Description
bool	disposing	true to release both managed and unmanaged resources; false to release only unmanaged resources.

~DeepLearningFaceRecognizer()

Finalizes an instance of the DeepLearningFaceRecognizer class.

Declaration

protected ~DeepLearningFaceRecognizer()

Recognize(MediaVisionSource)

Recognizes a face in by finding the closest match among the registered faces and returns the label of the found face.

Declaration

public DeepLearningFaceRecognitionResult Recognize(MediaVisionSource source)

Parameters

Type	Name	Description
MediaVisionSource	source	The face data to recognize.

Returns

Type	Description
DeepLearningFaceRecognitionResult	A label of recognized face.

Remarks

If there's no recognized face, Label will be System.String.Empty.

Exceptions

Type	Condition
System.ObjectDisposedException	The DeepLearningFaceRecognizer already has been disposed.
System.ArgumentNullException	source is null.
System.InvalidOperationException	In case of any invalid operations.

RegisterFace(MediaVisionSource, string)

Registers face data to internal database.

Declaration

public void RegisterFace(MediaVisionSource source, string label)

Parameters

Type	Name	Description
MediaVisionSource	source	The face data to register.
string	label	The name of face data.

Exceptions

Type	Condition
System.ObjectDisposedException	The DeepLearningFaceRecognizer already has been disposed.
System.ArgumentNullException	source or label is null.
System.InvalidOperationException	In case of any invalid operations.

UnregisterFace(string)

Unregisters face data from internal database.

Declaration

public void UnregisterFace(string label)

Parameters

Type	Name	Description
string	label	The name of face data.

Exceptions

Type	Condition
System.ObjectDisposedException	The DeepLearningFaceRecognizer already has been disposed.
System.ArgumentNullException	label is null.
System.InvalidOperationException	In case of any invalid operations.

Implements

System.IDisposable