Class FaceDetector

Definition

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

Provides the ability to detect faces on image sources.

public static class FaceDetector
Inheritance
object
FaceDetector
Remarks

If you want to use face detection based on inference engine(InferenceBackendType), please use DetectAsync(MediaVisionSource, InferenceModelConfiguration).

Methods

View Source

DetectAsync(MediaVisionSource, FaceDetectionConfiguration)

Detects faces on the source.
Each time when DetectAsync is called, a set of the detected faces at the media source are received asynchronously.

Declaration
public static Task<Rectangle[]> DetectAsync(MediaVisionSource source, FaceDetectionConfiguration config)
Parameters
Type Name Description
MediaVisionSource source

The source of the media where faces will be detected.
FaceDetectionConfiguration config

The configuration of engine will be used for detecting. This value can be null.
Returns
Type Description
System.Threading.Tasks.Task<TResult><Rectangle[]>

A task that represents the asynchronous detect operation.
Remarks

If you want to use face detection based on inference engine(InferenceBackendType), please use DetectAsync(MediaVisionSource, InferenceModelConfiguration).

Exceptions
Type Condition
System.ArgumentNullException

source is null.
System.NotSupportedException

The feature is not supported.
View Source

DetectAsync(MediaVisionSource, InferenceModelConfiguration)

Detects faces on the source image using inference engine set in config.
Each time when DetectAsync is called, a set of the detected faces at the media source are received asynchronously.

Declaration
public static Task<IEnumerable<FaceDetectionResult>> DetectAsync(MediaVisionSource source, InferenceModelConfiguration config)
Parameters
Type Name Description
MediaVisionSource source

The source of the media where faces will be detected.
InferenceModelConfiguration config

The engine's configuration that will be used for detecting.
Returns
Type Description
System.Threading.Tasks.Task<TResult><System.Collections.Generic.IEnumerable<T><FaceDetectionResult>>

A task that represents the asynchronous detect operation.
If there's no detected face, empty collection will be returned.
Remarks

If there's no detected face, empty collection will be returned.

Exceptions
Type Condition
System.ArgumentNullException

source or config is null.
System.InvalidOperationException

Internal error.
System.NotSupportedException

The feature is not supported.
System.UnauthorizedAccessException

The caller has no required privilege.
See Also
View Source

DetectAsync(MediaVisionSource)

Detects faces on the source.
Each time when DetectAsync is called, a set of the detected faces at the media source are received asynchronously.

Declaration
public static Task<Rectangle[]> DetectAsync(MediaVisionSource source)
Parameters
Type Name Description
MediaVisionSource source

The source of the media where faces will be detected.
Returns
Type Description
System.Threading.Tasks.Task<TResult><Rectangle[]>

A task that represents the asynchronous detect operation.
Remarks

If you want to use face detection based on inference engine(InferenceBackendType), please use DetectAsync(MediaVisionSource, InferenceModelConfiguration).

Exceptions
Type Condition
System.ArgumentNullException

source is null.
System.NotSupportedException

The feature is not supported.
-or-
The format of source is not supported.