[ACR-1811] Deprecate underutilized fields

[platform/core/api/media-content.git] / include_product / media_video.h

diff --git a/include_product/media_video.h b/include_product/media_video.h
index 75756b5..e1600be 100755 (executable)
--- a/include_product/media_video.h
+++ b/include_product/media_video.h
@@ -99,6 +99,7 @@ int video_meta_destroy(video_meta_h video);
 int video_meta_get_media_id(video_meta_h video, char **media_id);
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the album of the given video metadata.
  * @details If the value is an empty string, the method returns "Unknown". \n
  *          Since 3.0, if the media content has no album info, the method returns empty string.
@@ -117,9 +118,10 @@ int video_meta_get_media_id(video_meta_h video, char **media_id);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int video_meta_get_album(video_meta_h video, char **album);
+int video_meta_get_album(video_meta_h video, char **album) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the artist of the given video metadata.
  * @details If the value is an empty string, the method returns "Unknown". \n
  *          Since 3.0, if the media content has no artist info, the method returns empty string.
@@ -138,9 +140,10 @@ int video_meta_get_album(video_meta_h video, char **album);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int video_meta_get_artist(video_meta_h video, char **artist);
+int video_meta_get_artist(video_meta_h video, char **artist) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the video album artist.
  * @details If the value is an empty string, the method returns "Unknown". \n
  *          Since 3.0, if the media content has no album artist info, the method returns empty string.
@@ -159,9 +162,10 @@ int video_meta_get_artist(video_meta_h video, char **artist);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int video_meta_get_album_artist(video_meta_h video, char **album_artist);
+int video_meta_get_album_artist(video_meta_h video, char **album_artist) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the genre of the given video metadata.
  * @details If the value is an empty string, the method returns "Unknown". \n
  *          Since 3.0, if the media content has no genre info, the method returns empty string.
@@ -180,9 +184,10 @@ int video_meta_get_album_artist(video_meta_h video, char **album_artist);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int video_meta_get_genre(video_meta_h video, char **genre);
+int video_meta_get_genre(video_meta_h video, char **genre) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the composer of the given video metadata.
  * @details If the value is an empty string, the method returns "Unknown". \n
  *          Since 3.0, if the media content has no composer info, the method returns empty string.
@@ -201,9 +206,10 @@ int video_meta_get_genre(video_meta_h video, char **genre);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int video_meta_get_composer(video_meta_h video, char **composer);
+int video_meta_get_composer(video_meta_h video, char **composer) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the year of the given video metadata.
  * @details If the value is an empty string, the method returns "Unknown". \n
  *          Since 3.0, if the media content has no year info, the method returns empty string.
@@ -222,9 +228,10 @@ int video_meta_get_composer(video_meta_h video, char **composer);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int video_meta_get_year(video_meta_h video, char **year);
+int video_meta_get_year(video_meta_h video, char **year) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the recorded date of the given video metadata.
  * @details The format of the recorded date may vary depending on the file format. \n
  *          For more details on the recorded date format, refer to the file format specification.
@@ -243,9 +250,10 @@ int video_meta_get_year(video_meta_h video, char **year);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int video_meta_get_recorded_date(video_meta_h video, char **recorded_date);
+int video_meta_get_recorded_date(video_meta_h video, char **recorded_date) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the copyright notice of the given video metadata.
  * @details If the value is an empty string, the method returns "Unknown". \n
  *          Since 3.0, if the media content has no copyright info, the method returns empty string.
@@ -264,9 +272,10 @@ int video_meta_get_recorded_date(video_meta_h video, char **recorded_date);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int video_meta_get_copyright(video_meta_h video, char **copyright);
+int video_meta_get_copyright(video_meta_h video, char **copyright) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the track number of the given video metadata.
  * @details If the value is an empty string, the method returns "Unknown". \n
  *          Since 3.0, if the media content has no track info, the method returns empty string.
@@ -285,9 +294,10 @@ int video_meta_get_copyright(video_meta_h video, char **copyright);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int video_meta_get_track_num(video_meta_h video, char **track_num);
+int video_meta_get_track_num(video_meta_h video, char **track_num) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the bitrate of the given video metadata in bitrate per second.
  * @since_tizen 2.3
  *
@@ -300,9 +310,10 @@ int video_meta_get_track_num(video_meta_h video, char **track_num);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int video_meta_get_bit_rate(video_meta_h video, int *bit_rate);
+int video_meta_get_bit_rate(video_meta_h video, int *bit_rate) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the track duration of the given video metadata.
  * @since_tizen 2.3
  *
@@ -315,7 +326,7 @@ int video_meta_get_bit_rate(video_meta_h video, int *bit_rate);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int video_meta_get_duration(video_meta_h video, int *duration);
+int video_meta_get_duration(video_meta_h video, int *duration) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Gets the width of the given video metadata.
@@ -348,6 +359,7 @@ int video_meta_get_width(video_meta_h video, int *width);
 int video_meta_get_height(video_meta_h video, int *height);
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the rotation of the given video metadata.
  * @since_tizen 4.0
  *
@@ -360,7 +372,7 @@ int video_meta_get_height(video_meta_h video, int *height);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int video_meta_get_rotation(video_meta_h video, int *rotation);
+int video_meta_get_rotation(video_meta_h video, int *rotation) TIZEN_DEPRECATED_API;
 
 /**
  *@}