Class FaceDetector

Definition

Namespace:

Tizen.Multimedia.Vision

Assembly:

Tizen.Multimedia.Vision.dll

Provides the ability to detect faces on image sources.

[Obsolete("Deprecated since API12. Will be removed in API15.")]
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

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

[Obsolete("Deprecated since API12. Will be removed in API15.")]
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.

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

[Obsolete("Deprecated since API12. Will be removed in API15.")]
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

InferenceModelConfiguration

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

[Obsolete("Deprecated since API12. Will be removed in API15.")]
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.