[ACR-1820] Deprecate low usability fields

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

diff --git a/include/media_content_type.h b/include/media_content_type.h
index c9e25e5..5e26313 100755 (executable)
--- a/include/media_content_type.h
+++ b/include/media_content_type.h
@@ -149,27 +149,27 @@ 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_MAX = 29             /**< Invalid media group ID*/
+       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_MAX = 29             /**< @deprecated Invalid media group ID. Deprecated since 9.0*/
 } media_group_e;
 
 /**
@@ -194,6 +194,7 @@ typedef struct media_folder_s *media_folder_h;
 typedef struct media_playlist_s *media_playlist_h;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
  * @brief The structure type for the Media tag handle.
  * @since_tizen 2.3
@@ -222,6 +223,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
@@ -471,6 +473,7 @@ typedef bool (*media_playlist_cb)(media_playlist_h playlist, void *user_data);
 typedef bool (*playlist_member_cb)(int playlist_member_id, media_info_h media, void *user_data);
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @ingroup CAPI_CONTENT_MEDIA_TAG_MODULE
  * @brief Called for every tag in the obtained list of tags.
  * @details Iterates over a list of tags.
@@ -658,6 +661,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_MODIFIED_TIME "MEDIA_MODIFIED_TIME"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief  Media created time.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen 2.3
@@ -714,6 +718,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_GENRE "MEDIA_GENRE"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Media composer.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen 2.3
@@ -730,6 +735,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_YEAR "MEDIA_YEAR"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Media recorded date.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen 2.3
@@ -746,6 +752,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_TRACK_NUM "MEDIA_TRACK_NUM"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Media duration.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen 2.3
@@ -754,6 +761,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_DURATION "MEDIA_DURATION"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Media longitude.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen 2.3
@@ -762,6 +770,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_LONGITUDE "MEDIA_LONGITUDE"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Media latitude.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen 2.3
@@ -770,6 +779,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_LATITUDE "MEDIA_LATITUDE"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Media altitude.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen 2.3
@@ -802,6 +812,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_DATETAKEN "MEDIA_DATETAKEN"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief The time to register favourite.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen 2.3
@@ -810,6 +821,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_FAVOURITE "MEDIA_FAVOURITE"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Is DRM.
  * @details There are 2 types:\n
  *               0-not drm, 1-drm\n
@@ -820,6 +832,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_IS_DRM "MEDIA_IS_DRM"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Virtual Reality content.
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen 3.0
@@ -877,6 +890,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define PLAYLIST_MEDIA_COUNT "PLAYLIST_MEDIA_COUNT"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Tag name.
  * @details You can use above define to set the condition of tag filter and order keyword.
  * @since_tizen 2.3
@@ -884,6 +898,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define TAG_NAME "TAG_NAME"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Tag id.
  * @details You can use above define to set the condition of tag filter and order keyword.
  * @since_tizen 4.0
@@ -891,6 +906,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_TAG_ID "TAG_ID"
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Media count in tag.
  * @details You can use above define to set the condition of tag filter and order keyword.
  * @since_tizen 2.3