[ACR-1811] Deprecate underutilized fields

[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..ee26ef7 100755 (executable)
--- a/include_product/media_info.h
+++ b/include_product/media_info.h
@@ -248,6 +248,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 +271,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,7 +302,7 @@ 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;
 
 /**
  * @brief Gets the number of bookmarks for the passed @a filter in the given media ID from the media database.
@@ -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
@@ -635,6 +637,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 +652,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 +676,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 +694,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 +710,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 +727,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 +743,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 +759,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 +778,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 +801,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 +815,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 +832,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 +896,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 +914,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 +950,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.