[ACR-1838] Deprecate all bookmark and playlist funtions

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

diff --git a/include_product/media_content_type.h b/include_product/media_content_type.h
index 49f9fa6..22795ea 100755 (executable)
--- a/include_product/media_content_type.h
+++ b/include_product/media_content_type.h
@@ -155,30 +155,29 @@ typedef enum {
  * @since_tizen 2.3
  */
 typedef enum {
-       MEDIA_CONTENT_GROUP_DISPLAY_NAME = 0,    /**< Media group ID for display name */
-       MEDIA_CONTENT_GROUP_TYPE,                /**< Media group ID for a media type */
-       MEDIA_CONTENT_GROUP_MIME_TYPE,           /**< Media group ID for a mime type */
-       MEDIA_CONTENT_GROUP_SIZE,                /**< Media group ID for content size */
-       MEDIA_CONTENT_GROUP_ADDED_TIME,          /**< Media group ID for the added time */
-       MEDIA_CONTENT_GROUP_MODIFIED_TIME,       /**< Media group ID for the modified time */
-       MEDIA_CONTENT_GROUP_TITLE,               /**< Media group ID for a content title */
+       MEDIA_CONTENT_GROUP_DISPLAY_NAME = 0,    /**< @deprecated Media group ID for display name. Deprecated since 9.0*/
+       MEDIA_CONTENT_GROUP_TYPE,                /**< @deprecated Media group ID for a media type. Deprecated since 9.0*/
+       MEDIA_CONTENT_GROUP_MIME_TYPE,           /**< @deprecated Media group ID for a mime type. Deprecated since 9.0*/
+       MEDIA_CONTENT_GROUP_SIZE,                /**< @deprecated Media group ID for content size. Deprecated since 9.0*/
+       MEDIA_CONTENT_GROUP_ADDED_TIME,          /**< @deprecated Media group ID for the added time. Deprecated since 9.0*/
+       MEDIA_CONTENT_GROUP_MODIFIED_TIME,       /**< @deprecated Media group ID for the modified time. Deprecated since 9.0*/
+       MEDIA_CONTENT_GROUP_TITLE,               /**< @deprecated Media group ID for a content title. Deprecated since 9.0*/
        MEDIA_CONTENT_GROUP_ARTIST,              /**< Media group ID for an artist*/
        MEDIA_CONTENT_GROUP_ALBUM_ARTIST,        /**< Media group ID for an album artist */
        MEDIA_CONTENT_GROUP_GENRE,               /**< Media group ID for a genre*/
-       MEDIA_CONTENT_GROUP_COMPOSER,            /**< Media group ID for a composer*/
+       MEDIA_CONTENT_GROUP_COMPOSER,            /**< @deprecated Media group ID for a composer. Deprecated since 9.0*/
        MEDIA_CONTENT_GROUP_YEAR,                /**< Media group ID for a year*/
-       MEDIA_CONTENT_GROUP_RECORDED_DATE,       /**< Media group ID for the recorded date*/
-       MEDIA_CONTENT_GROUP_COPYRIGHT,           /**< Media group ID for the copyright*/
-       MEDIA_CONTENT_GROUP_TRACK_NUM,           /**< Media group ID for a track number*/
-       MEDIA_CONTENT_GROUP_DESCRIPTION,         /**< Media group ID for a description */
-       MEDIA_CONTENT_GROUP_LONGITUDE,           /**< Media group ID for the longitude*/
-       MEDIA_CONTENT_GROUP_LATITUDE,            /**< Media group ID for the latitude*/
-       MEDIA_CONTENT_GROUP_ALTITUDE,            /**< Media group ID for the altitude*/
-       MEDIA_CONTENT_GROUP_RATING = 20,              /**< Media group ID for a rating*/
-       MEDIA_CONTENT_GROUP_MODIFIED_MONTH = 29,                 /**< Media group ID for the modified time*/
-       MEDIA_CONTENT_GROUP_MODIFIED_DATE,               /**< Media group ID for the modified date*/
+       MEDIA_CONTENT_GROUP_RECORDED_DATE,       /**< @deprecated Media group ID for the recorded date. Deprecated since 9.0*/
+       MEDIA_CONTENT_GROUP_COPYRIGHT,           /**< @deprecated Media group ID for the copyright. Deprecated since 9.0*/
+       MEDIA_CONTENT_GROUP_TRACK_NUM,           /**< @deprecated Media group ID for a track number. Deprecated since 9.0*/
+       MEDIA_CONTENT_GROUP_DESCRIPTION,         /**< @deprecated Media group ID for a description. Deprecated since 9.0*/
+       MEDIA_CONTENT_GROUP_LONGITUDE,           /**< @deprecated Media group ID for the longitude. Deprecated since 9.0*/
+       MEDIA_CONTENT_GROUP_LATITUDE,            /**< @deprecated Media group ID for the latitude. Deprecated since 9.0*/
+       MEDIA_CONTENT_GROUP_ALTITUDE,            /**< @deprecated Media group ID for the altitude. Deprecated since 9.0*/
+       MEDIA_CONTENT_GROUP_RATING = 20,         /**< @deprecated Media group ID for a rating. Deprecated since 9.0*/
+       MEDIA_CONTENT_GROUP_MODIFIED_DATE = 29,          /**< Media group ID for the modified date*/
        MEDIA_CONTENT_GROUP_ALBUM,
-       MEDIA_CONTENT_GROUP_MAX,                /**< Invalid media group ID*/
+       MEDIA_CONTENT_GROUP_MAX,                /**< @deprecated Invalid media group ID. Deprecated since 9.0*/
        MEDIA_PVR_GROUP_DURATION,
        MEDIA_PVR_GROUP_TIME_ZONE,
        MEDIA_PVR_GROUP_PTC,
@@ -260,6 +259,7 @@ typedef struct media_info_s *media_info_h;
 typedef struct media_folder_s *media_folder_h;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
  * @brief The structure type for the Media playlist handle.
  * @since_tizen 2.3
@@ -275,6 +275,7 @@ typedef struct media_playlist_s *media_playlist_h;
 typedef struct media_tag_s *media_tag_h;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
  * @brief The structure type for the Media bookmark handle.
  * @since_tizen 2.3
@@ -296,6 +297,7 @@ typedef struct media_album_s *media_album_h;
 typedef struct image_meta_s *image_meta_h;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @ingroup CAPI_CONTENT_MEDIA_VIDEO_META_MODULE
  * @brief The structure type for the Video metadata handle.
  * @since_tizen 2.3
@@ -410,13 +412,10 @@ typedef void (*media_content_db_update_cb)(
  * @return @c true to continue with the next iteration of the loop,
  *         otherwise @c false to break out of the loop
  *
- * @pre media_tag_foreach_media_from_db(), media_playlist_foreach_media_from_db(), media_genre_foreach_media_from_db(),
- *      media_info_foreach_media_from_db(), media_folder_foreach_media_from_db() will invoke this function.
+ * @pre media_info_foreach_media_from_db(), media_folder_foreach_media_from_db() will invoke this function.
  *
  * @see media_info_clone()
  * @see media_album_foreach_media_from_db()
- * @see media_playlist_foreach_media_from_db()
- * @see media_tag_foreach_media_from_db()
  * @see media_info_foreach_media_from_db()
  * @see media_folder_foreach_media_from_db()
  */
@@ -498,6 +497,7 @@ typedef void (*media_face_detection_completed_cb)(media_content_error_e error, c
 typedef bool (*media_folder_cb)(media_folder_h folder, void *user_data);
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
  * @brief Called for every playlist in the obtained list of playlists.
  * @details Iterates over a playlist list.
@@ -521,6 +521,7 @@ typedef bool (*media_folder_cb)(media_folder_h folder, void *user_data);
 typedef bool (*media_playlist_cb)(media_playlist_h playlist, void *user_data);
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @ingroup CAPI_CONTENT_MEDIA_PLAYLIST_MODULE
  * @brief Called for every media info with playlist member ID in the obtained list of media info.
  * @details Iterates over playlist members.
@@ -570,6 +571,7 @@ typedef bool (*playlist_member_cb)(int playlist_member_id, media_info_h media, v
 typedef bool (*media_tag_cb)(media_tag_h tag, void *user_data);
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @ingroup CAPI_CONTENT_MEDIA_BOOKMARK_MODULE
  * @brief Called for every bookmark in the obtained list of bookmarks.
  * @details Iterates over a bookmark list.
@@ -955,6 +957,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define FOLDER_NAME "FOLDER_NAME"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Playlist name.
  * @details You can use above define to set the condition of playlist filter and order keyword.
  * @since_tizen 2.3
@@ -962,6 +965,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define PLAYLIST_NAME "PLAYLIST_NAME"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Playlist id.
  * @details You can use above define to set the condition of playlist filter and order keyword.
  * @since_tizen 4.0
@@ -969,6 +973,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_PLAYLIST_ID "PLAYLIST_ID"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Playlist member order.
  * @details You can use above define to set the condition of playlist filter and order keyword.
  * @since_tizen 2.3
@@ -976,6 +981,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define PLAYLIST_MEMBER_ORDER "PLAYLIST_MEMBER_ORDER"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Media count in playlist.
  * @details You can use above define to set the condition of playlist filter and order keyword.
  * @since_tizen 2.3
@@ -1007,6 +1013,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define TAG_MEDIA_COUNT "TAG_MEDIA_COUNT"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Bookmark marked time.
  * @details You can use above define to set the condition of bookmark filter and order keyword.
  * @since_tizen 2.3
@@ -1014,6 +1021,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define BOOKMARK_MARKED_TIME "BOOKMARK_MARKED_TIME"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Bookmark id.
  * @details You can use above define to set the condition of bookmark filter and order keyword.
  * @since_tizen 4.0
@@ -1021,6 +1029,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_BOOKMARK_ID "BOOKMARK_ID"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Bookmark name.
  * @details You can use above define to set the condition of bookmark filter and order keyword.
  * @since_tizen 4.0