/// <summary>
/// Initializes a new instance of the <see cref="ImageTrackingModel"/> class with the specified path.
/// </summary>
/// <remarks>
/// Model saved by <see cref="Save(string)"/> can be loaded.
/// </remarks>
/// <param name="modelPath">Path to the model to load.</param>
/// <exception cref="ArgumentNullException"><paramref name="modelPath"/> is null.</exception>
/// <exception cref="FileNotFoundException"><paramref name="modelPath"/> is invalid.</exception>
/// <exception cref="NotSupportedException">
/// The feature is not supported.<br/>
/// -or-<br/>
/// <paramref name="modelPath"/> is not supported format.
/// </exception>
/// <exception cref="UnauthorizedAccessException">No permission to access the specified file.</exception>
/// <seealso cref="Save(string)"/>
/// <since_tizen> 4 </since_tizen>
public ImageTrackingModel(string modelPath)
{
if (modelPath == null)
{
throw new ArgumentNullException(nameof(modelPath));
}
InteropModel.Load(modelPath, out _handle).Validate("Failed to load ImageTrackingModel from file");
}
/// <summary>
/// Sets the target of the image tracking model.<br/>
/// Sets the image object which will be tracked by using tracking functionality with this tracking model.
/// </summary>
/// <param name="imageObject">Image object which will be set as the target for tracking.</param>
/// <exception cref="ArgumentNullException"><paramref name="imageObject"/> is null.</exception>
/// <exception cref="ObjectDisposedException">
/// The <see cref="ImageTrackingModel"/> has already been disposed of.<br/>
/// -or-<br/>
/// <paramref name="imageObject"/> has already been disposed of.
/// </exception>
/// <since_tizen> 4 </since_tizen>
public void SetTarget(ImageObject imageObject)
{
if (imageObject == null)
{
throw new ArgumentNullException(nameof(imageObject));
}
InteropModel.SetTarget(imageObject.Handle, Handle).
Validate("Failed to set target of image tracking model");
}
/// <summary>
/// Releases the resources used by the <see cref="ImageTrackingModel"/> object.
/// </summary>
/// <param name="disposing">
/// true to release both managed and unmanaged resources; otherwise false to release only unmanaged resources.
/// </param>
/// <since_tizen> 4 </since_tizen>
protected virtual void Dispose(bool disposing)
{
if (_disposed)
{
return;
}
InteropModel.Destroy(_handle);
_disposed = true;
}
/// <summary>
/// Saves the tracking model to the file.
/// </summary>
/// <param name="path">Path to the file to save the model.</param>
/// <exception cref="ArgumentNullException"><paramref name="path"/> is null.</exception>
/// <exception cref="UnauthorizedAccessException">No permission to write to the specified path.</exception>
/// <exception cref="ObjectDisposedException">The <see cref="ImageTrackingModel"/> has already been disposed of.</exception>
/// <exception cref="DirectoryNotFoundException">The directory for <paramref name="path"/> does not exist.</exception>
/// <since_tizen> 4 </since_tizen>
public void Save(string path)
{
if (path == null)
{
throw new ArgumentNullException(path);
}
var ret = InteropModel.Save(path, Handle);
if (ret == MediaVisionError.InvalidPath)
{
throw new DirectoryNotFoundException($"The directory for the path({path}) does not exist.");
}
ret.Validate("Failed to save tracking model to file");
}
/// <summary>
/// Initializes a new instance of the <see cref="ImageTrackingModel"/> class.
/// </summary>
/// <exception cref="NotSupportedException">The feature is not supported.</exception>
/// <since_tizen> 4 </since_tizen>
public ImageTrackingModel()
{
InteropModel.Create(out _handle).Validate("Failed to create FaceTrackingModel");
}
/// <summary>
/// Refreshes the state of image tracking model.<br/>
/// Clears the moving history and change state to undetected. It is usually called 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.
/// Tracking algorithm will try to find image by itself.
/// </summary>
/// <exception cref="ObjectDisposedException">The <see cref="ImageTrackingModel"/> has already been disposed of.</exception>
/// <since_tizen> 4 </since_tizen>
public void Refresh()
{
InteropModel.Refresh(Handle, IntPtr.Zero).Validate("Failed to refresh state");
}
