Class FaceRecognizer

Definition

Namespace:: Tizen.Multimedia.Vision

Assembly:: Tizen.Multimedia.Vision.dll

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

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

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

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

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

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

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

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

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

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.