Class DeepLearningFaceRecognizer

Definition

Namespace:: Tizen.Multimedia.Vision

Assembly:: Tizen.Multimedia.Vision.dll

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


                C#
                
                    Copy
                    
                
            
public class DeepLearningFaceRecognizer : IDisposable

Inheritance: object

DeepLearningFaceRecognizer

Implements: System.IDisposable

Constructors

View Source

DeepLearningFaceRecognizer()

Initializes a new instance of the DeepLearningFaceRecognizer class.

Declaration


                C#
                
                    Copy
                    
                
            
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

View Source

Dispose()

Releases all resources used by the DeepLearningFaceRecognizer.

Declaration


                C#
                
                    Copy
                    
                
            
public void Dispose()

View Source

Dispose(bool)

Releases the unmanaged resources used by the DeepLearningFaceRecognizer.

Declaration


                C#
                
                    Copy
                    
                
            
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.

View Source

~DeepLearningFaceRecognizer()

Finalizes an instance of the DeepLearningFaceRecognizer class.

Declaration


                C#
                
                    Copy
                    
                
            
protected ~DeepLearningFaceRecognizer()

View Source

Recognize(MediaVisionSource)

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

Declaration


                C#
                
                    Copy
                    
                
            
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.

View Source

RegisterFace(MediaVisionSource, string)

Registers face data to internal database.

Declaration


                C#
                
                    Copy
                    
                
            
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.

View Source

UnregisterFace(string)

Unregisters face data from internal database.

Declaration


                C#
                
                    Copy
                    
                
            
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