[MediaVision] Add APIs for inference detectors and classifier (#985)
[platform/core/csapi/tizenfx.git] / src / Tizen.Multimedia.Vision / MediaVision / FaceTrackingModel.cs
index 6653921..6f52d1e 100755 (executable)
@@ -23,7 +23,8 @@ namespace Tizen.Multimedia.Vision
     /// <summary>
     /// Represents the face tracking model.
     /// </summary>
-    /// <since_tizen> 3 </since_tizen>
+    /// <feature>http://tizen.org/feature/vision.face_recognition</feature>
+    /// <since_tizen> 4 </since_tizen>
     public class FaceTrackingModel : IDisposable
     {
         private IntPtr _handle = IntPtr.Zero;
@@ -33,7 +34,7 @@ namespace Tizen.Multimedia.Vision
         /// Initializes a new instance of the <see cref="FaceTrackingModel"/> class.
         /// </summary>
         /// <exception cref="NotSupportedException">The feature is not supported.</exception>
-        /// <since_tizen> 3 </since_tizen>
+        /// <since_tizen> 4 </since_tizen>
         public FaceTrackingModel()
         {
             InteropModel.Create(out _handle).Validate("Failed to create FaceTrackingModel.");
@@ -49,13 +50,13 @@ namespace Tizen.Multimedia.Vision
         /// <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.\n
-        ///     -or-\n
+        ///     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> 3 </since_tizen>
+        /// <since_tizen> 4 </since_tizen>
         public FaceTrackingModel(string modelPath)
         {
             if (modelPath == null)
@@ -65,6 +66,9 @@ namespace Tizen.Multimedia.Vision
             InteropModel.Load(modelPath, out _handle).Validate("Failed to load FaceTrackingModel from file.");
         }
 
+        /// <summary>
+        /// Finalizes an instance of the FaceTrackingModel class.
+        /// </summary>
         ~FaceTrackingModel()
         {
             Dispose(false);
@@ -100,11 +104,11 @@ namespace Tizen.Multimedia.Vision
         ///     If null, then tracking model will try to find previously tracked face by itself.</param>
         /// <exception cref="ArgumentNullException"><paramref name="source"/> is null.</exception>
         /// <exception cref="ObjectDisposedException">
-        ///     The <see cref="FaceTrackingModel"/> has already been disposed of.\n
-        ///     -or-\n
+        ///     The <see cref="FaceTrackingModel"/> has already been disposed of.<br/>
+        ///     -or-<br/>
         ///     <paramref name="source"/> has already bean disposed of.
         /// </exception>
-        /// <since_tizen> 3 </since_tizen>
+        /// <since_tizen> 4 </since_tizen>
         public void Prepare(MediaVisionSource source, Quadrangle region)
         {
             if (source == null)
@@ -121,9 +125,9 @@ namespace Tizen.Multimedia.Vision
         /// <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="FaceRecognitionModel"/> has already been disposed of.</exception>
+        /// <exception cref="ObjectDisposedException">The <see cref="FaceTrackingModel"/> has already been disposed of.</exception>
         /// <exception cref="DirectoryNotFoundException">The directory for <paramref name="path"/> does not exist.</exception>
-        /// <since_tizen> 3 </since_tizen>
+        /// <since_tizen> 4 </since_tizen>
         public void Save(string path)
         {
             if (path == null)
@@ -144,6 +148,7 @@ namespace Tizen.Multimedia.Vision
         /// <summary>
         /// Releases all the resources used by the <see cref="FaceTrackingModel"/> object.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         public void Dispose()
         {
             Dispose(true);
@@ -156,6 +161,7 @@ namespace Tizen.Multimedia.Vision
         /// <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)