From b169d64fa94ed8d4dae8bd3e10378044b6568377 Mon Sep 17 00:00:00 2001 From: "minje.ahn" Date: Fri, 26 Jan 2024 11:26:25 +0900 Subject: [PATCH] [ACR-1820] Deprecate low usability fields Change-Id: I06fd5a24b81d9a87f081a6c38e4527247a6aa67a Signed-off-by: minje.ahn --- doc/media_content_doc.h | 4 ++-- include/media_book.h | 6 ++++-- include/media_content_type.h | 1 + include/media_info.h | 3 ++- include/media_video.h | 15 ++++++++++----- include_product/media_book.h | 6 ++++-- include_product/media_content_type.h | 1 + include_product/media_info.h | 3 ++- include_product/media_video.h | 15 ++++++++++----- src/media_book.c | 2 ++ src/media_info.c | 1 + src/media_video.c | 12 +++++++++--- 12 files changed, 48 insertions(+), 21 deletions(-) diff --git a/doc/media_content_doc.h b/doc/media_content_doc.h index 7b813d7..83cb378 100755 --- 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. * * - * @ref CAPI_CONTENT_MEDIA_VIDEO_META_MODULE + * @ref CAPI_CONTENT_MEDIA_VIDEO_META_MODULE (Deprecated) * Provides details about video items present in the device.\n * Provide functions to get information (e.g. duration, date etc) about the video files. * diff --git a/include/media_book.h b/include/media_book.h index 6e39fde..0a5353d 100755 --- 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 --- 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 --- 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 --- 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 --- 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 --- 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 --- 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 --- 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 --- 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 --- 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 --- a/src/media_video.c +++ b/src/media_video.c @@ -16,9 +16,10 @@ #include - +// 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 -- 2.7.4