Class FaceTrackingModel

Definition

Namespace:

Tizen.Multimedia.Vision

Assembly:

Tizen.Multimedia.Vision.dll

API Level:

4

Feature:

http://tizen.org/feature/vision.face_recognition

Represents the face tracking model.

public class FaceTrackingModel : IDisposable

Inheritance

Object

FaceTrackingModel

Implements

IDisposable

Constructors

FaceTrackingModel()

Initializes a new instance of the FaceTrackingModel class.

Declaration

public FaceTrackingModel()

Exceptions

Type	Condition
NotSupportedException	The feature is not supported.

API Level: 4

FaceTrackingModel(String)

Initializes a new instance of the FaceTrackingModel class with the specified path.

Declaration

public FaceTrackingModel(string modelPath)

Parameters

Type	Name	Description
String	modelPath	Path to the model to load.

Remarks

Models saved by Save(String) can be loaded.

Exceptions

Type	Condition
ArgumentNullException	modelPath is null.
FileNotFoundException	modelPath is invalid.
NotSupportedException	The feature is not supported. -or- modelPath is not supported format.
UnauthorizedAccessException	No permission to access the specified file.

See Also

Save(String)

API Level: 4

Methods

Dispose()

Releases all the resources used by the FaceTrackingModel object.

Declaration

public void Dispose()

API Level: 4

Dispose(Boolean)

Releases the resources used by the FaceTrackingModel object.

Declaration

protected virtual void Dispose(bool disposing)

Parameters

Type	Name	Description
Boolean	disposing	true to release both managed and unmanaged resources; otherwise false to release only unmanaged resources.

API Level: 4

Finalize()

Finalizes an instance of the FaceTrackingModel class.

Declaration

protected void Finalize()

Prepare(MediaVisionSource, Quadrangle)

Initializes the tracking model by the location of the face to be tracked.

It is usually called once after the tracking model is created, and each time before tracking is started for the new sequence of sources, which is not the direct continuation of the sequence for which tracking has been performed before. But, it is allowed to call it between tracking sessions to allow Media Vision start to track more accurately.

Declaration

public void Prepare(MediaVisionSource source, Quadrangle region)

Parameters

Type	Name	Description
MediaVisionSource	source	The source where face location is specified. Usually it is the first frame of the video or the first image in the continuous image sequence planned to be used for tracking.
Quadrangle	region	The region determining position of the face to be tracked on the source. If null, then tracking model will try to find previously tracked face by itself.

Remarks

region needs to be the position of the face to be tracked when called first time for the tracking model. region is fitted to the valid region of source if region has invalid points.

Exceptions

Type	Condition
ArgumentNullException	source is null.
ObjectDisposedException	The FaceTrackingModel has already been disposed of. -or- source has already bean disposed of.

API Level: 4

Save(String)

Saves the tracking model to the file.

Declaration

public void Save(string path)

Parameters

Type	Name	Description
String	path	Path to the file to save the model.

Exceptions

Type	Condition
ArgumentNullException	path is null.
UnauthorizedAccessException	No permission to write to the specified path.
ObjectDisposedException	The FaceTrackingModel has already been disposed of.
DirectoryNotFoundException	The directory for path does not exist.

API Level: 4

Implements

System.IDisposable