Class FaceRecognizer

View Source

Definition

Namespace:
Tizen.Multimedia.Vision
Assembly:
Tizen.Multimedia.Vision.dll

Provides the ability to recognize faces, face expressions, and eye condition on image sources.


                
C#

                

                    
Copy

                    

                

            
[Obsolete("Deprecated since API12. Will be removed in API15.")]
public static class FaceRecognizer
Inheritance
object
FaceRecognizer

Methods

View Source

RecognizeAsync(MediaVisionSource, FaceRecognitionModel, Rectangle, FaceRecognitionConfiguration)

Performs face recognition on the source with FaceRecognitionModel, FaceRecognitionConfiguration and a bounding box.

Declaration

                
C#

                

                    
Copy

                    

                

            
[Obsolete("Deprecated since API12. Will be removed in API15.")]
public static Task<FaceRecognitionResult> RecognizeAsync(MediaVisionSource source, FaceRecognitionModel recognitionModel, Rectangle bound, FaceRecognitionConfiguration config)
Parameters
Type Name Description
MediaVisionSource source

The MediaVisionSource of the media to recognize faces for.
FaceRecognitionModel recognitionModel

The FaceRecognitionModel to be used for recognition.
Rectangle bound

Rectangular box bounding face image on the source.
FaceRecognitionConfiguration config

The FaceRecognitionConfiguration used for recognition. This value can be null.
Returns
Type Description
System.Threading.Tasks.Task<TResult><FaceRecognitionResult>

A task that represents the asynchronous recognition operation.
Exceptions
Type Condition
System.ArgumentNullException

source is null.
-or-
recognitionModel is null.
System.NotSupportedException

The feature is not supported.
System.ObjectDisposedException

source has already been disposed of.
-or-
config has already been disposed of.
System.InvalidOperationException

recognitionModel is untrained model.
View Source

RecognizeAsync(MediaVisionSource, FaceRecognitionModel, Rectangle)

Performs face recognition on the source with FaceRecognitionModel and a bounding box.

Declaration

                
C#

                

                    
Copy

                    

                

            
[Obsolete("Deprecated since API12. Will be removed in API15.")]
public static Task<FaceRecognitionResult> RecognizeAsync(MediaVisionSource source, FaceRecognitionModel recognitionModel, Rectangle bound)
Parameters
Type Name Description
MediaVisionSource source

The MediaVisionSource of the media to recognize faces for.
FaceRecognitionModel recognitionModel

The FaceRecognitionModel to be used for recognition.
Rectangle bound

Rectangular box bounding face image on the source.
Returns
Type Description
System.Threading.Tasks.Task<TResult><FaceRecognitionResult>

A task that represents the asynchronous recognition operation.
Exceptions
Type Condition
System.ArgumentNullException

source is null.
-or-
recognitionModel is null.
System.NotSupportedException

The feature is not supported.
System.ObjectDisposedException

source has already been disposed of.
System.InvalidOperationException

recognitionModel is untrained model.
View Source

RecognizeAsync(MediaVisionSource, FaceRecognitionModel, FaceRecognitionConfiguration)

Performs face recognition on the source with FaceRecognitionModel and FaceRecognitionConfiguration.

Declaration

                
C#

                

                    
Copy

                    

                

            
[Obsolete("Deprecated since API12. Will be removed in API15.")]
public static Task<FaceRecognitionResult> RecognizeAsync(MediaVisionSource source, FaceRecognitionModel recognitionModel, FaceRecognitionConfiguration config)
Parameters
Type Name Description
MediaVisionSource source

The MediaVisionSource of the media to recognize faces for.
FaceRecognitionModel recognitionModel

The FaceRecognitionModel to be used for recognition.
FaceRecognitionConfiguration config

The configuration used for recognition. This value can be null.
Returns
Type Description
System.Threading.Tasks.Task<TResult><FaceRecognitionResult>

A task that represents the asynchronous recognition operation.
Exceptions
Type Condition
System.ArgumentNullException

source is null.
-or-
recognitionModel is null.
System.NotSupportedException

The feature is not supported.
System.ObjectDisposedException

source has already been disposed of.
-or-
config has already been disposed of.
System.InvalidOperationException

recognitionModel is untrained model.
View Source

RecognizeAsync(MediaVisionSource, FaceRecognitionModel)

Performs face recognition on the source with FaceRecognitionModel.

Declaration

                
C#

                

                    
Copy

                    

                

            
[Obsolete("Deprecated since API12. Will be removed in API15.")]
public static Task<FaceRecognitionResult> RecognizeAsync(MediaVisionSource source, FaceRecognitionModel recognitionModel)
Parameters
Type Name Description
MediaVisionSource source

The MediaVisionSource of the media to recognize faces for.
FaceRecognitionModel recognitionModel

The FaceRecognitionConfiguration to be used for recognition.
Returns
Type Description
System.Threading.Tasks.Task<TResult><FaceRecognitionResult>

A task that represents the asynchronous recognition operation.
Exceptions
Type Condition
System.ArgumentNullException

source is null.
-or-
recognitionModel is null.
System.NotSupportedException

The feature is not supported.
System.ObjectDisposedException

source has already been disposed of.
System.InvalidOperationException

recognitionModel is untrained model.
View Source

RecognizeEyeConditionAsync(MediaVisionSource, Rectangle, FaceRecognitionConfiguration)

Determines eye-blink condition on the media source.

Declaration

                
C#

                

                    
Copy

                    

                

            
[Obsolete("Deprecated since API12. Will be removed in API15.")]
public static Task<EyeCondition> RecognizeEyeConditionAsync(MediaVisionSource source, Rectangle bound, FaceRecognitionConfiguration config)
Parameters
Type Name Description
MediaVisionSource source

The source of the media to recognize eye-blink condition for.
Rectangle bound

The bounding the face at the source.
FaceRecognitionConfiguration config

The configuration used for eye-blink condition recognition. This value can be null.
Returns
Type Description
System.Threading.Tasks.Task<TResult><EyeCondition>

A task that represents the asynchronous recognition operation.
Exceptions
Type Condition
System.ArgumentNullException

source is null.
System.ObjectDisposedException

source has already been disposed of.
-or-
config has already been disposed of.
System.NotSupportedException

The feature is not supported.
View Source

RecognizeEyeConditionAsync(MediaVisionSource, Rectangle)

Determines eye-blink condition on media source.

Declaration

                
C#

                

                    
Copy

                    

                

            
[Obsolete("Deprecated since API12. Will be removed in API15.")]
public static Task<EyeCondition> RecognizeEyeConditionAsync(MediaVisionSource source, Rectangle bound)
Parameters
Type Name Description
MediaVisionSource source

The source of the media to recognize eye-blink condition for.
Rectangle bound

The bounding the face at the source.
Returns
Type Description
System.Threading.Tasks.Task<TResult><EyeCondition>

A task that represents the asynchronous recognition operation.
Exceptions
Type Condition
System.ArgumentNullException

source is null.
System.ObjectDisposedException

source has already been disposed of.
System.NotSupportedException

The feature is not supported.
View Source

RecognizeFacialExpressionAsync(MediaVisionSource, Rectangle, FaceRecognitionConfiguration)

Determines facial expression on media source.

Declaration

                
C#

                

                    
Copy

                    

                

            
[Obsolete("Deprecated since API12. Will be removed in API15.")]
public static Task<FacialExpression> RecognizeFacialExpressionAsync(MediaVisionSource source, Rectangle bound, FaceRecognitionConfiguration config)
Parameters
Type Name Description
MediaVisionSource source

The source of the media to recognize facial expression for.
Rectangle bound

The location bounding the face at the source.
FaceRecognitionConfiguration config

The configuration used for expression recognition. This value can be null.
Returns
Type Description
System.Threading.Tasks.Task<TResult><FacialExpression>

A task that represents the asynchronous recognition operation.
Exceptions
Type Condition
System.ArgumentNullException

source is null.
System.ObjectDisposedException

source has already been disposed of.
-or-
config has already been disposed of.
System.NotSupportedException

The feature is not supported.
View Source

RecognizeFacialExpressionAsync(MediaVisionSource, Rectangle)

Determines facial expression on media source.

Declaration

                
C#

                

                    
Copy

                    

                

            
[Obsolete("Deprecated since API12. Will be removed in API15.")]
public static Task<FacialExpression> RecognizeFacialExpressionAsync(MediaVisionSource source, Rectangle bound)
Parameters
Type Name Description
MediaVisionSource source

The source of the media to recognize facial expression for.
Rectangle bound

The location bounding the face at the source.
Returns
Type Description
System.Threading.Tasks.Task<TResult><FacialExpression>

A task that represents the asynchronous recognition operation.
Exceptions
Type Condition
System.ArgumentNullException

source is null.
System.ObjectDisposedException

source has already been disposed of.
System.NotSupportedException

The feature is not supported.