Remove deprecated APIs from test code

[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 c969990..6d9e538 100755 (executable)
--- a/include_product/media_video.h
+++ b/include_product/media_video.h
@@ -37,10 +37,11 @@ extern "C" {
  */
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Clones the video metadata.
  * @details This function copies the video metadata handle from a source to destination.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @a dst should be released using video_meta_destroy().
  *
@@ -56,15 +57,16 @@ extern "C" {
  *
  * @see video_meta_destroy()
  */
-int video_meta_clone(video_meta_h *dst, video_meta_h src);
+int video_meta_clone(video_meta_h *dst, video_meta_h src) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Destroys the video metadata.
  * @details This function frees all resources related to the video metadata handle. This handle
  *          no longer can be used to perform any operations. A new handle has to
  *          be created before the next use.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] video The handle to the video metadata
  *
@@ -78,11 +80,12 @@ int video_meta_clone(video_meta_h *dst, video_meta_h src);
  *
  * @see video_meta_clone()
  */
-int video_meta_destroy(video_meta_h video);
+int video_meta_destroy(video_meta_h video) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the ID of the media of the given video metadata.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @a media_id should be released using free().
  *
@@ -96,14 +99,15 @@ int video_meta_destroy(video_meta_h video);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  */
-int video_meta_get_media_id(video_meta_h video, char **media_id);
+int video_meta_get_media_id(video_meta_h video, char **media_id) TIZEN_DEPRECATED_API;
 
 /**
+ * @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.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @a album should be released using free().
  *
@@ -117,14 +121,15 @@ 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.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @a artist should be released using free().
  *
@@ -138,14 +143,15 @@ 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.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @a album_artist should be released using free().
  *
@@ -159,14 +165,15 @@ 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.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @a genre should be released using free().
  *
@@ -180,14 +187,15 @@ 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.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @a composer should be released using free().
  *
@@ -201,14 +209,15 @@ 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.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @a year should be released using free().
  *
@@ -222,14 +231,15 @@ 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.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @a recorded_date should be released using free().
  *
@@ -243,14 +253,15 @@ 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.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @a copyright should be released using free().
  *
@@ -264,14 +275,15 @@ 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.
  *
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @remarks The @a track_num should be released using free().
  *
@@ -285,11 +297,12 @@ 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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] video The handle to the video metadata
  * @param[out] bit_rate The video bit rate in bit per second [bps]
@@ -300,11 +313,12 @@ 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 @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] video The handle to the video metadata
  * @param[out] duration The video duration in milliseconds
@@ -315,11 +329,12 @@ 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;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the width of the given video metadata.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] video The handle to the video metadata
  * @param[out] width The video width in pixels
@@ -330,11 +345,12 @@ int video_meta_get_duration(video_meta_h video, int *duration);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int video_meta_get_width(video_meta_h video, int *width);
+int video_meta_get_width(video_meta_h video, int *width) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the height of the given video metadata.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
  *
  * @param[in] video The handle to the video metadata
  * @param[out] height The video height in pixels
@@ -345,9 +361,10 @@ int video_meta_get_width(video_meta_h video, int *width);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int video_meta_get_height(video_meta_h video, int *height);
+int video_meta_get_height(video_meta_h video, int *height) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the rotation of the given video metadata.
  * @since_tizen 4.0
  *
@@ -360,7 +377,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;
 
 /**
  *@}