[ACR-1838] Deprecate all bookmark and playlist funtions

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

diff --git a/include_product/media_info.h b/include_product/media_info.h
index e0c0f40..a75380b 100755 (executable)
--- a/include_product/media_info.h
+++ b/include_product/media_info.h
@@ -30,8 +30,7 @@ extern "C" {
  * @file media_info.h
  * @brief This file contains the media info function and related functions to proceed with it. \n
  *        You can use the functions to insert, delete, count and get list of content files from media database. \n
- *        You can get properties of content file such as size, mime_type, modified_time etc. And you can set properties such as favorite etc. \n
- *        And you can get bookmark, face, tag info related the content file.
+ *        You can get properties of content file such as size, mime_type, modified_time etc. And you can set properties such as favorite etc.
  */
 
 
@@ -248,6 +247,7 @@ int media_info_get_media_count_from_db(filter_h filter, int *media_count);
 int media_info_foreach_media_from_db(filter_h filter, media_info_cb callback, void *user_data);
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the count of media tags for the passed @a filter in the given @a media_id from the media database.
  * @details If @c NULL is passed to the @a filter, then no filtering is applied.
  *
@@ -270,9 +270,10 @@ int media_info_foreach_media_from_db(filter_h filter, media_info_cb callback, vo
  * @see media_content_connect()
  * @see media_filter_create()
  */
-int media_info_get_tag_count_from_db(const char *media_id, filter_h filter, int *tag_count);
+int media_info_get_tag_count_from_db(const char *media_id, filter_h filter, int *tag_count) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Iterates through the media tag in the given media info from the media database.
  * @details This function gets all the media tags associated with the given @a media_id and calls @a callback for every retrieved media tag. \n
  *               If @c NULL is passed to the @a filter, then no filtering is applied.
@@ -300,9 +301,10 @@ int media_info_get_tag_count_from_db(const char *media_id, filter_h filter, int
  * @see #media_tag_cb
  * @see media_filter_create()
  */
-int media_info_foreach_tag_from_db(const char *media_id, filter_h filter, media_tag_cb callback, void *user_data);
+int media_info_foreach_tag_from_db(const char *media_id, filter_h filter, media_tag_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the number of bookmarks for the passed @a filter in the given media ID from the media database.
  * @details If @c NULL is passed to the @a filter, then no filtering is applied.
  *
@@ -310,7 +312,7 @@ int media_info_foreach_tag_from_db(const char *media_id, filter_h filter, media_
  *
  * @param[in] media_id The media ID
  * @param[in] filter The handle to the media filter
- * @param[out] bookmark_count The count of the media tag
+ * @param[out] bookmark_count The count of the media bookmark
  *
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -325,9 +327,10 @@ int media_info_foreach_tag_from_db(const char *media_id, filter_h filter, media_
  * @see media_content_connect()
  * @see media_filter_create()
  */
-int media_info_get_bookmark_count_from_db(const char *media_id, filter_h filter, int *bookmark_count);
+int media_info_get_bookmark_count_from_db(const char *media_id, filter_h filter, int *bookmark_count) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Iterates through the media bookmark in the given media info from the media database.
  * @details This function gets all media bookmarks associated with the given media and calls @a callback for every retrieved media bookmark.
  *                If @c NULL is passed to the @a filter, then no filtering is applied.
@@ -355,7 +358,7 @@ int media_info_get_bookmark_count_from_db(const char *media_id, filter_h filter,
  * @see media_bookmark_cb()
  * @see media_filter_create()
  */
-int media_info_foreach_bookmark_from_db(const char *media_id, filter_h filter, media_bookmark_cb callback, void *user_data);
+int media_info_foreach_bookmark_from_db(const char *media_id, filter_h filter, media_bookmark_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since 8.0.
@@ -431,6 +434,7 @@ int media_info_foreach_face_from_db(const char *media_id, filter_h filter, media
 int media_info_get_image(media_info_h media, image_meta_h *image);
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets a video metadata handle for a given media info.
  * @details This function returns a video metadata handle retrieved from the media info handle.
  *
@@ -450,7 +454,7 @@ int media_info_get_image(media_info_h media, image_meta_h *image);
  *
  * @see video_meta_destroy()
  */
-int media_info_get_video(media_info_h media, video_meta_h *video);
+int media_info_get_video(media_info_h media, video_meta_h *video) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Gets an audio metadata handle for a given media info.
@@ -635,6 +639,7 @@ int media_info_get_added_time(media_info_h media, time_t *added_time);
 int media_info_get_modified_time(media_info_h media, time_t *time);
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the timeline of content file.
  * @details If the content file has the creation time information (like Content recorded date or Image creation date), that value is timeline. \n
  *               Otherwise, timeline value is the same as modified time.
@@ -649,7 +654,7 @@ int media_info_get_modified_time(media_info_h media, time_t *time);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_info_get_timeline(media_info_h media, time_t *time);
+int media_info_get_timeline(media_info_h media, time_t *time) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Gets the thumbnail path of content file.
@@ -673,6 +678,7 @@ int media_info_get_timeline(media_info_h media, time_t *time);
 int media_info_get_thumbnail_path(media_info_h media, char **path);
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the description of content file.
  * @details If the value is an empty string, the method returns "Unknown". \n
  *                Since 3.0, if the media info has no description, the method returns empty string.
@@ -690,9 +696,10 @@ int media_info_get_thumbnail_path(media_info_h media, char **path);
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_info_get_description(media_info_h media, char **description);
+int media_info_get_description(media_info_h media, char **description) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the longitude of content file.
  * @since_tizen 2.3
  *
@@ -705,9 +712,10 @@ int media_info_get_description(media_info_h media, char **description);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_info_get_longitude(media_info_h media, double *longitude);
+int media_info_get_longitude(media_info_h media, double *longitude) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the latitude of content file.
  * @since_tizen 2.3
  *
@@ -721,9 +729,10 @@ int media_info_get_longitude(media_info_h media, double *longitude);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  *
  */
-int media_info_get_latitude(media_info_h media, double* latitude);
+int media_info_get_latitude(media_info_h media, double* latitude) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the altitude of content file.
  * @since_tizen 2.3
  *
@@ -736,9 +745,10 @@ int media_info_get_latitude(media_info_h media, double* latitude);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_info_get_altitude(media_info_h media, double* altitude);
+int media_info_get_altitude(media_info_h media, double* altitude) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the rating of content file.
  * @since_tizen 2.3
  *
@@ -751,9 +761,10 @@ int media_info_get_altitude(media_info_h media, double* altitude);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_info_get_rating(media_info_h media, int *rating);
+int media_info_get_rating(media_info_h media, int *rating) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the favorite status of content file which User set.
  * @since_tizen 2.3
  *
@@ -769,7 +780,7 @@ int media_info_get_rating(media_info_h media, int *rating);
  *
  * @see media_info_set_favorite()
  */
-int media_info_get_favorite(media_info_h media, bool* favorite);
+int media_info_get_favorite(media_info_h media, bool* favorite) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Gets the title of content file.
@@ -792,6 +803,7 @@ int media_info_get_favorite(media_info_h media, bool* favorite);
 int media_info_get_title(media_info_h media, char **title);
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Checks whether the media is protected via DRM.
  * @since_tizen 2.3
  *
@@ -805,9 +817,10 @@ int media_info_get_title(media_info_h media, char **title);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_info_is_drm(media_info_h media, bool *is_drm);
+int media_info_is_drm(media_info_h media, bool *is_drm) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Checks whether the content file is 360 content.
  * @since_tizen 3.0
  *
@@ -821,7 +834,7 @@ int media_info_is_drm(media_info_h media, bool *is_drm);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_info_is_360_content(media_info_h media, bool *is_360);
+int media_info_is_360_content(media_info_h media, bool *is_360) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Gets the media info from the media database.
@@ -885,6 +898,7 @@ int media_info_get_media_from_db(const char *media_id, media_info_h *media);
 int media_info_get_media_from_db_by_path(const char *media_path, media_info_h *media);
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Sets the favorite of media info.
  * @details This function can mark favorite of the media. If set to @c true, this function record the time of the change moment. \n
  *                So, If you use it in order parameter, you can sort the order of the time was a favorite. \n
@@ -902,9 +916,10 @@ int media_info_get_media_from_db_by_path(const char *media_path, media_info_h *m
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int media_info_set_favorite(media_info_h media, bool favorite);
+int media_info_set_favorite(media_info_h media, bool favorite) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Updates the media info to the media database.
  *
  * @details The function updates the given media info in the media database.
@@ -937,7 +952,7 @@ int media_info_set_favorite(media_info_h media, bool favorite);
  * @see media_content_connect()
  * @see media_info_set_favorite()
  */
-int media_info_update_to_db(media_info_h media);
+int media_info_update_to_db(media_info_h media) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Moves the media info to the given destination path in the media database.