[ACR-1820] Deprecate low usability fields

Change-Id: I06fd5a24b81d9a87f081a6c38e4527247a6aa67a
Signed-off-by: minje.ahn <minje.ahn@samsung.com>

diff --git a/doc/media_content_doc.h b/doc/media_content_doc.h
index 7b813d7..83cb378 100755 (executable)
--- a/doc/media_content_doc.h
+++ b/doc/media_content_doc.h
@@ -612,7 +612,7 @@
 
 
 /**
- * @defgroup CAPI_CONTENT_MEDIA_VIDEO_META_MODULE Video Metadata
+ * @defgroup CAPI_CONTENT_MEDIA_VIDEO_META_MODULE Video Metadata (Deprecated)
  * @brief The Video Metadata API provides functions to get information about video files present in the device.
  *
  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
@@ -912,7 +912,7 @@
  * Provide functions to get information (e.g. longitude, description, date etc) about the image files.</td>
  * </tr>
  * <tr>
- *    <td>@ref CAPI_CONTENT_MEDIA_VIDEO_META_MODULE </td>
+ *    <td>@ref CAPI_CONTENT_MEDIA_VIDEO_META_MODULE (Deprecated)</td>
  *    <td> Provides details about video items present in the device.\n
  * Provide functions to get information (e.g. duration, date etc) about the video files.</td>
  * </tr>

diff --git a/include/media_book.h b/include/media_book.h
index 6e39fde..0a5353d 100755 (executable)
--- a/include/media_book.h
+++ b/include/media_book.h
@@ -133,6 +133,7 @@ int book_meta_get_subject(book_meta_h book, char **subject);
 int book_meta_get_author(book_meta_h book, char **author);
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the publication date of the given book metadata.
  * @details If there is no information, @a date will be NULL.
  *
@@ -149,9 +150,10 @@ int book_meta_get_author(book_meta_h book, char **author);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int book_meta_get_date(book_meta_h book, char **date);
+int book_meta_get_date(book_meta_h book, char **date) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the publisher notice of the given book metadata.
  * @details If there is no information, @a publisher will be NULL.
  *
@@ -168,7 +170,7 @@ int book_meta_get_date(book_meta_h book, char **date);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int book_meta_get_publisher(book_meta_h book, char **publisher);
+int book_meta_get_publisher(book_meta_h book, char **publisher) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Gets a list of paths to ebooks which contain a given keyword.

diff --git a/include/media_content_type.h b/include/media_content_type.h
index fc59a84..5e26313 100755 (executable)
--- a/include/media_content_type.h
+++ b/include/media_content_type.h
@@ -223,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

diff --git a/include/media_info.h b/include/media_info.h
index ee26ef7..918eacc 100755 (executable)
--- a/include/media_info.h
+++ b/include/media_info.h
@@ -433,6 +433,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.
  *
@@ -452,7 +453,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.

diff --git a/include/media_video.h b/include/media_video.h
index e1600be..6d9e538 100755 (executable)
--- a/include/media_video.h
+++ b/include/media_video.h
@@ -37,6 +37,7 @@ 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.
  *
@@ -56,9 +57,10 @@ 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
@@ -78,9 +80,10 @@ 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 2.3
  *
@@ -96,7 +99,7 @@ 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.
@@ -329,6 +332,7 @@ int video_meta_get_bit_rate(video_meta_h video, int *bit_rate) TIZEN_DEPRECATED_
 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 2.3
  *
@@ -341,9 +345,10 @@ int video_meta_get_duration(video_meta_h video, int *duration) TIZEN_DEPRECATED_
  * @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 2.3
  *
@@ -356,7 +361,7 @@ 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.

diff --git a/include_product/media_book.h b/include_product/media_book.h
index 6e39fde..0a5353d 100755 (executable)
--- a/include_product/media_book.h
+++ b/include_product/media_book.h
@@ -133,6 +133,7 @@ int book_meta_get_subject(book_meta_h book, char **subject);
 int book_meta_get_author(book_meta_h book, char **author);
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the publication date of the given book metadata.
  * @details If there is no information, @a date will be NULL.
  *
@@ -149,9 +150,10 @@ int book_meta_get_author(book_meta_h book, char **author);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int book_meta_get_date(book_meta_h book, char **date);
+int book_meta_get_date(book_meta_h book, char **date) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 9.0.
  * @brief Gets the publisher notice of the given book metadata.
  * @details If there is no information, @a publisher will be NULL.
  *
@@ -168,7 +170,7 @@ int book_meta_get_date(book_meta_h book, char **date);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int book_meta_get_publisher(book_meta_h book, char **publisher);
+int book_meta_get_publisher(book_meta_h book, char **publisher) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Gets a list of paths to ebooks which contain a given keyword.

diff --git a/include_product/media_content_type.h b/include_product/media_content_type.h
index a6bb47b..7b71f97 100755 (executable)
--- a/include_product/media_content_type.h
+++ b/include_product/media_content_type.h
@@ -296,6 +296,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

diff --git a/include_product/media_info.h b/include_product/media_info.h
index ee26ef7..918eacc 100755 (executable)
--- a/include_product/media_info.h
+++ b/include_product/media_info.h
@@ -433,6 +433,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.
  *
@@ -452,7 +453,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.

diff --git a/include_product/media_video.h b/include_product/media_video.h
index e1600be..6d9e538 100755 (executable)
--- a/include_product/media_video.h
+++ b/include_product/media_video.h
@@ -37,6 +37,7 @@ 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.
  *
@@ -56,9 +57,10 @@ 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
@@ -78,9 +80,10 @@ 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 2.3
  *
@@ -96,7 +99,7 @@ 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.
@@ -329,6 +332,7 @@ int video_meta_get_bit_rate(video_meta_h video, int *bit_rate) TIZEN_DEPRECATED_
 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 2.3
  *
@@ -341,9 +345,10 @@ int video_meta_get_duration(video_meta_h video, int *duration) TIZEN_DEPRECATED_
  * @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 2.3
  *
@@ -356,7 +361,7 @@ 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.

diff --git a/src/media_book.c b/src/media_book.c
index 57b7105..507488c 100644 (file)
--- a/src/media_book.c
+++ b/src/media_book.c
@@ -91,6 +91,7 @@ int book_meta_get_author(book_meta_h book, char **author)
 
 int book_meta_get_date(book_meta_h book, char **date)
 {
+       content_warn("DEPRECATION WARNING: book_meta_get_date() is deprecated and will be removed from next release.");
        book_meta_s *_book = (book_meta_s *)book;
 
        content_retip_if_fail(book);
@@ -103,6 +104,7 @@ int book_meta_get_date(book_meta_h book, char **date)
 
 int book_meta_get_publisher(book_meta_h book, char **publisher)
 {
+       content_warn("DEPRECATION WARNING: book_meta_get_publisher() is deprecated and will be removed from next release.");
        book_meta_s *_book = (book_meta_s *)book;
 
        content_retip_if_fail(book);

diff --git a/src/media_info.c b/src/media_info.c
index 69ea2e8..3918494 100644 (file)
--- a/src/media_info.c
+++ b/src/media_info.c
@@ -760,6 +760,7 @@ int media_info_get_image(media_info_h media, image_meta_h *image)
 
 int media_info_get_video(media_info_h media, video_meta_h *video)
 {
+       content_warn("DEPRECATION WARNING: media_info_get_video() is deprecated and will be removed from next release.");
        int ret = MEDIA_CONTENT_ERROR_NONE;
 
        media_info_s *_media = (media_info_s*)media;

diff --git a/src/media_video.c b/src/media_video.c
index cc66600..38b2277 100755 (executable)
--- a/src/media_video.c
+++ b/src/media_video.c
@@ -16,9 +16,10 @@
 
 
 #include <media_info_private.h>
-
+// LCOV_EXCL_START
 int video_meta_destroy(video_meta_h video)
 {
+       content_warn("DEPRECATION WARNING: video_meta_destroy() is deprecated and will be removed from next release.");
        video_meta_s *_video = (video_meta_s*)video;
 
        content_retip_if_fail(video);
@@ -40,6 +41,7 @@ int video_meta_destroy(video_meta_h video)
 
 int video_meta_clone(video_meta_h *dst, video_meta_h src)
 {
+       content_warn("DEPRECATION WARNING: video_meta_clone() is deprecated and will be removed from next release.");
        video_meta_s *_src = (video_meta_s*)src;
 
        content_retip_if_fail(dst);
@@ -70,6 +72,7 @@ int video_meta_clone(video_meta_h *dst, video_meta_h src)
 
 int video_meta_get_media_id(video_meta_h video, char **media_id)
 {
+       content_warn("DEPRECATION WARNING: video_meta_get_media_id() is deprecated and will be removed from next release.");
        video_meta_s *_video = (video_meta_s*)video;
 
        content_retip_if_fail(video);
@@ -79,7 +82,7 @@ int video_meta_get_media_id(video_meta_h video, char **media_id)
 
        return MEDIA_CONTENT_ERROR_NONE;
 }
-// LCOV_EXCL_START
+
 int video_meta_get_album(video_meta_h video, char **album)
 {
        content_warn("DEPRECATION WARNING: video_meta_get_album() is deprecated and will be removed from next release.");
@@ -235,9 +238,10 @@ int video_meta_get_rotation(video_meta_h video, int *rotation)
 
        return MEDIA_CONTENT_ERROR_NONE;
 }
-// LCOV_EXCL_STOP
+
 int video_meta_get_width(video_meta_h video, int *width)
 {
+       content_warn("DEPRECATION WARNING: video_meta_get_width() is deprecated and will be removed from next release.");
        video_meta_s *_video = (video_meta_s*)video;
 
        content_retip_if_fail(video);
@@ -250,6 +254,7 @@ int video_meta_get_width(video_meta_h video, int *width)
 
 int video_meta_get_height(video_meta_h video, int *height)
 {
+       content_warn("DEPRECATION WARNING: video_meta_get_height() is deprecated and will be removed from next release.");
        video_meta_s *_video = (video_meta_s*)video;
 
        content_retip_if_fail(video);
@@ -259,3 +264,4 @@ int video_meta_get_height(video_meta_h video, int *height)
 
        return MEDIA_CONTENT_ERROR_NONE;
 }
+// LCOV_EXCL_STOP
\ No newline at end of file