From 1df87e178caf7d7f465b833d94b942c216d2f61c Mon Sep 17 00:00:00 2001 From: "minje.ahn" Date: Wed, 13 Dec 2023 10:04:12 +0900 Subject: [PATCH 1/1] [ACR-1811] Deprecate underutilized fields Change-Id: Ic2df8ccaba2ce2098ce106ef3bf3caf42d59fe35 Signed-off-by: minje.ahn --- doc/media_content_doc.h | 2 +- include/media_audio.h | 24 ++++++++++++------ include/media_content_type.h | 15 +++++++++++ include/media_info.h | 41 +++++++++++++++++++----------- include/media_tag.h | 45 ++++++++++++++++++++++----------- include/media_video.h | 36 +++++++++++++++++--------- include_product/media_audio.h | 24 ++++++++++++------ include_product/media_content_type.h | 15 +++++++++++ include_product/media_info.h | 41 +++++++++++++++++++----------- include_product/media_tag.h | 45 ++++++++++++++++++++++----------- include_product/media_video.h | 36 +++++++++++++++++--------- src/media_audio.c | 49 +++++++++++++++++++++--------------- src/media_info.c | 29 +++++++++++++++------ src/media_tag.c | 20 +++++++++++++++ src/media_video.c | 34 +++++++++++++++++-------- 15 files changed, 318 insertions(+), 138 deletions(-) diff --git a/doc/media_content_doc.h b/doc/media_content_doc.h index 9e5b103..78958ec 100755 --- a/doc/media_content_doc.h +++ b/doc/media_content_doc.h @@ -134,7 +134,7 @@ /** - * @defgroup CAPI_CONTENT_MEDIA_TAG_MODULE Media Tag + * @defgroup CAPI_CONTENT_MEDIA_TAG_MODULE Media Tag (Deprecated) * @brief The Media Tag API provides functions to manage media content tags. * * @ingroup CAPI_MEDIA_CONTENT_MODULE diff --git a/include/media_audio.h b/include/media_audio.h index abfe6b8..c18ad3d 100755 --- a/include/media_audio.h +++ b/include/media_audio.h @@ -183,6 +183,7 @@ int audio_meta_get_album_artist(audio_meta_h audio, char **album_artist); int audio_meta_get_genre(audio_meta_h audio, char **genre); /** + * @deprecated Deprecated since 9.0. * @brief Gets the composer of the given audio metadata. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no composer info, the method returns empty string. @@ -201,7 +202,7 @@ int audio_meta_get_genre(audio_meta_h audio, char **genre); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int audio_meta_get_composer(audio_meta_h audio, char **composer); +int audio_meta_get_composer(audio_meta_h audio, char **composer) TIZEN_DEPRECATED_API; /** * @brief Gets the year of the given audio metadata. @@ -225,6 +226,7 @@ int audio_meta_get_composer(audio_meta_h audio, char **composer); int audio_meta_get_year(audio_meta_h audio, char **year); /** + * @deprecated Deprecated since 9.0. * @brief Gets the recorded date of the given audio metadata. * @details The format of the recorded date may vary depending on the file format. \n * For more details on the recorded date format, refer to the file format specification. @@ -243,9 +245,10 @@ int audio_meta_get_year(audio_meta_h audio, char **year); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int audio_meta_get_recorded_date(audio_meta_h audio, char **recorded_date); +int audio_meta_get_recorded_date(audio_meta_h audio, char **recorded_date) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the copyright notice of the given audio metadata. * @details If the media content has no copyright info, the method returns empty string. * @@ -263,7 +266,7 @@ int audio_meta_get_recorded_date(audio_meta_h audio, char **recorded_date); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int audio_meta_get_copyright(audio_meta_h audio, char **copyright); +int audio_meta_get_copyright(audio_meta_h audio, char **copyright) TIZEN_DEPRECATED_API; /** * @brief Gets the track number of the given audio metadata. @@ -287,6 +290,7 @@ int audio_meta_get_copyright(audio_meta_h audio, char **copyright); int audio_meta_get_track_num(audio_meta_h audio, char **track_num); /** + * @deprecated Deprecated since 9.0. * @brief Gets the bitrate of the given audio metadata in bitrate per second. * @since_tizen 2.3 * @@ -299,9 +303,10 @@ int audio_meta_get_track_num(audio_meta_h audio, char **track_num); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int audio_meta_get_bit_rate(audio_meta_h audio, int *bit_rate); +int audio_meta_get_bit_rate(audio_meta_h audio, int *bit_rate) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets bit per sample of the given audio metadata. * @since_tizen 2.3 * @@ -314,9 +319,10 @@ int audio_meta_get_bit_rate(audio_meta_h audio, int *bit_rate); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int audio_meta_get_bitpersample(audio_meta_h audio, int *bitpersample); +int audio_meta_get_bitpersample(audio_meta_h audio, int *bitpersample) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the sample rate of the given audio metadata. * @since_tizen 2.3 * @@ -329,9 +335,10 @@ int audio_meta_get_bitpersample(audio_meta_h audio, int *bitpersample); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int audio_meta_get_sample_rate(audio_meta_h audio, int *sample_rate); +int audio_meta_get_sample_rate(audio_meta_h audio, int *sample_rate) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the channel of the given audio metadata. * @since_tizen 2.3 * @@ -344,9 +351,10 @@ int audio_meta_get_sample_rate(audio_meta_h audio, int *sample_rate); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int audio_meta_get_channel(audio_meta_h audio, int *channel); +int audio_meta_get_channel(audio_meta_h audio, int *channel) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the track duration of the given audio metadata. * @since_tizen 2.3 * @@ -359,7 +367,7 @@ int audio_meta_get_channel(audio_meta_h audio, int *channel); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int audio_meta_get_duration(audio_meta_h audio, int *duration); +int audio_meta_get_duration(audio_meta_h audio, int *duration) TIZEN_DEPRECATED_API; /** *@} diff --git a/include/media_content_type.h b/include/media_content_type.h index c9e25e5..c2ba432 100755 --- a/include/media_content_type.h +++ b/include/media_content_type.h @@ -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 @@ -471,6 +472,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 +660,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 +717,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 +734,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 +751,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 +760,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 +769,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 +778,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 +811,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 +820,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 +831,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 +889,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 +897,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 +905,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 diff --git a/include/media_info.h b/include/media_info.h index e0c0f40..ee26ef7 100755 --- a/include/media_info.h +++ b/include/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. diff --git a/include/media_tag.h b/include/media_tag.h index 91d110e..f489062 100755 --- a/include/media_tag.h +++ b/include/media_tag.h @@ -40,6 +40,7 @@ extern "C" { */ /** + * @deprecated Deprecated since 9.0. * @brief Inserts a new tag in the media database. * @since_tizen 2.3 * @@ -69,9 +70,10 @@ extern "C" { * @see media_tag_delete_from_db() * @see media_tag_destroy() */ -int media_tag_insert_to_db(const char *tag_name, media_tag_h *tag); +int media_tag_insert_to_db(const char *tag_name, media_tag_h *tag) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Deletes a given tag from the media database. * @since_tizen 2.3 * @@ -96,9 +98,10 @@ int media_tag_insert_to_db(const char *tag_name, media_tag_h *tag); * @see media_content_connect() * @see media_tag_insert_to_db() */ -int media_tag_delete_from_db(int tag_id); +int media_tag_delete_from_db(int tag_id) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the count of the tag for the passed @a filter from the media database. * @since_tizen 2.3 * @@ -117,9 +120,10 @@ int media_tag_delete_from_db(int tag_id); * * @see media_content_connect() */ -int media_tag_get_tag_count_from_db(filter_h filter, int *tag_count); +int media_tag_get_tag_count_from_db(filter_h filter, int *tag_count) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Iterates through tags from the media database. * @details This function gets all tags meeting a desired @a filter * and calls a registered callback function for every retrieved tag. @@ -147,9 +151,10 @@ int media_tag_get_tag_count_from_db(filter_h filter, int *tag_count); * @see #media_tag_cb * @see media_filter_create() */ -int media_tag_foreach_tag_from_db(filter_h filter, media_tag_cb callback, void *user_data); +int media_tag_foreach_tag_from_db(filter_h filter, media_tag_cb callback, void *user_data) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the number of media files for the passed @a filter in the given @a tag_id from the media database. * @since_tizen 2.3 * @@ -169,9 +174,10 @@ int media_tag_foreach_tag_from_db(filter_h filter, media_tag_cb callback, void * * * @see media_content_connect() */ -int media_tag_get_media_count_from_db(int tag_id, filter_h filter, int *media_count); +int media_tag_get_media_count_from_db(int tag_id, filter_h filter, int *media_count) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Iterates through media items for a given tag from the media database. * @details This function gets all media items associated with a given tag and * meeting a desired @a filter and calls a registered callback function for @@ -200,9 +206,10 @@ int media_tag_get_media_count_from_db(int tag_id, filter_h filter, int *media_co * @see media_info_cb() * @see media_filter_create() */ -int media_tag_foreach_media_from_db(int tag_id, filter_h filter, media_info_cb callback, void *user_data); +int media_tag_foreach_media_from_db(int tag_id, filter_h filter, media_info_cb callback, void *user_data) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Clones the media tag. * @details This function copies the media tag handle from a source to destination. * There is no media_tag_create() function. The #media_tag_h is created internally and available through media tag foreach function @@ -225,9 +232,10 @@ int media_tag_foreach_media_from_db(int tag_id, filter_h filter, media_info_cb c * * @see media_tag_destroy() */ -int media_tag_clone(media_tag_h *dst, media_tag_h src); +int media_tag_clone(media_tag_h *dst, media_tag_h src) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Destroys the media tag. * @details This function frees all resources related to the tag handle. The tag handle can no longer * be used for any operations. A new tag handle has to be created before next usage. @@ -247,9 +255,10 @@ int media_tag_clone(media_tag_h *dst, media_tag_h src); * @see media_tag_clone() * @see media_tag_insert_to_db() */ -int media_tag_destroy(media_tag_h tag); +int media_tag_destroy(media_tag_h tag) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the media tag ID. * @since_tizen 2.3 * @@ -262,9 +271,10 @@ int media_tag_destroy(media_tag_h tag); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int media_tag_get_tag_id(media_tag_h tag, int *tag_id); +int media_tag_get_tag_id(media_tag_h tag, int *tag_id) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the tag name. * @since_tizen 2.3 * @@ -280,9 +290,10 @@ int media_tag_get_tag_id(media_tag_h tag, int *tag_id); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int media_tag_get_name(media_tag_h tag, char **tag_name); +int media_tag_get_name(media_tag_h tag, char **tag_name) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the media tag from the media database. * * @details This function creates a new media tag handle from the media database by the given @a tag_id. @@ -309,9 +320,10 @@ int media_tag_get_name(media_tag_h tag, char **tag_name); * @see media_content_connect() * @see media_tag_destroy() */ -int media_tag_get_tag_from_db(int tag_id, media_tag_h *tag); +int media_tag_get_tag_from_db(int tag_id, media_tag_h *tag) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Adds a new media info to the tag. * @since_tizen 2.3 * @@ -331,9 +343,10 @@ int media_tag_get_tag_from_db(int tag_id, media_tag_h *tag); * @see media_content_connect() * @see media_tag_remove_media() */ -int media_tag_add_media(media_tag_h tag, const char *media_id); +int media_tag_add_media(media_tag_h tag, const char *media_id) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Removes the media info from the given tag. * @since_tizen 2.3 * @@ -353,9 +366,10 @@ int media_tag_add_media(media_tag_h tag, const char *media_id); * @see media_content_connect() * @see media_tag_add_media() */ -int media_tag_remove_media(media_tag_h tag, const char *media_id); +int media_tag_remove_media(media_tag_h tag, const char *media_id) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Sets the name of the tag. * @since_tizen 2.3 * @@ -371,9 +385,10 @@ int media_tag_remove_media(media_tag_h tag, const char *media_id); * * @post media_tag_update_to_db() */ -int media_tag_set_name(media_tag_h tag, const char *tag_name); +int media_tag_set_name(media_tag_h tag, const char *tag_name) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Updates the media tag to the media database. * * @details The function updates the given media tag in the media database. The function should be called after any change in tag attributes, to be updated to the media @@ -407,7 +422,7 @@ int media_tag_set_name(media_tag_h tag, const char *tag_name); * @see media_tag_remove_media() * @see media_tag_set_name() */ -int media_tag_update_to_db(media_tag_h tag); +int media_tag_update_to_db(media_tag_h tag) TIZEN_DEPRECATED_API; /** * @} diff --git a/include/media_video.h b/include/media_video.h index 75756b5..e1600be 100755 --- a/include/media_video.h +++ b/include/media_video.h @@ -99,6 +99,7 @@ int video_meta_destroy(video_meta_h video); int video_meta_get_media_id(video_meta_h video, char **media_id); /** + * @deprecated Deprecated since 9.0. * @brief Gets the album of the given video metadata. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no album info, the method returns empty string. @@ -117,9 +118,10 @@ int video_meta_get_media_id(video_meta_h video, char **media_id); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_album(video_meta_h video, char **album); +int video_meta_get_album(video_meta_h video, char **album) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the artist of the given video metadata. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no artist info, the method returns empty string. @@ -138,9 +140,10 @@ int video_meta_get_album(video_meta_h video, char **album); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_artist(video_meta_h video, char **artist); +int video_meta_get_artist(video_meta_h video, char **artist) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the video album artist. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no album artist info, the method returns empty string. @@ -159,9 +162,10 @@ int video_meta_get_artist(video_meta_h video, char **artist); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_album_artist(video_meta_h video, char **album_artist); +int video_meta_get_album_artist(video_meta_h video, char **album_artist) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the genre of the given video metadata. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no genre info, the method returns empty string. @@ -180,9 +184,10 @@ int video_meta_get_album_artist(video_meta_h video, char **album_artist); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_genre(video_meta_h video, char **genre); +int video_meta_get_genre(video_meta_h video, char **genre) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the composer of the given video metadata. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no composer info, the method returns empty string. @@ -201,9 +206,10 @@ int video_meta_get_genre(video_meta_h video, char **genre); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_composer(video_meta_h video, char **composer); +int video_meta_get_composer(video_meta_h video, char **composer) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the year of the given video metadata. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no year info, the method returns empty string. @@ -222,9 +228,10 @@ int video_meta_get_composer(video_meta_h video, char **composer); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_year(video_meta_h video, char **year); +int video_meta_get_year(video_meta_h video, char **year) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the recorded date of the given video metadata. * @details The format of the recorded date may vary depending on the file format. \n * For more details on the recorded date format, refer to the file format specification. @@ -243,9 +250,10 @@ int video_meta_get_year(video_meta_h video, char **year); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_recorded_date(video_meta_h video, char **recorded_date); +int video_meta_get_recorded_date(video_meta_h video, char **recorded_date) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the copyright notice of the given video metadata. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no copyright info, the method returns empty string. @@ -264,9 +272,10 @@ int video_meta_get_recorded_date(video_meta_h video, char **recorded_date); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_copyright(video_meta_h video, char **copyright); +int video_meta_get_copyright(video_meta_h video, char **copyright) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the track number of the given video metadata. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no track info, the method returns empty string. @@ -285,9 +294,10 @@ int video_meta_get_copyright(video_meta_h video, char **copyright); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_track_num(video_meta_h video, char **track_num); +int video_meta_get_track_num(video_meta_h video, char **track_num) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the bitrate of the given video metadata in bitrate per second. * @since_tizen 2.3 * @@ -300,9 +310,10 @@ int video_meta_get_track_num(video_meta_h video, char **track_num); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int video_meta_get_bit_rate(video_meta_h video, int *bit_rate); +int video_meta_get_bit_rate(video_meta_h video, int *bit_rate) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the track duration of the given video metadata. * @since_tizen 2.3 * @@ -315,7 +326,7 @@ int video_meta_get_bit_rate(video_meta_h video, int *bit_rate); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int video_meta_get_duration(video_meta_h video, int *duration); +int video_meta_get_duration(video_meta_h video, int *duration) TIZEN_DEPRECATED_API; /** * @brief Gets the width of the given video metadata. @@ -348,6 +359,7 @@ int video_meta_get_width(video_meta_h video, int *width); int video_meta_get_height(video_meta_h video, int *height); /** + * @deprecated Deprecated since 9.0. * @brief Gets the rotation of the given video metadata. * @since_tizen 4.0 * @@ -360,7 +372,7 @@ int video_meta_get_height(video_meta_h video, int *height); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int video_meta_get_rotation(video_meta_h video, int *rotation); +int video_meta_get_rotation(video_meta_h video, int *rotation) TIZEN_DEPRECATED_API; /** *@} diff --git a/include_product/media_audio.h b/include_product/media_audio.h index abfe6b8..c18ad3d 100755 --- a/include_product/media_audio.h +++ b/include_product/media_audio.h @@ -183,6 +183,7 @@ int audio_meta_get_album_artist(audio_meta_h audio, char **album_artist); int audio_meta_get_genre(audio_meta_h audio, char **genre); /** + * @deprecated Deprecated since 9.0. * @brief Gets the composer of the given audio metadata. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no composer info, the method returns empty string. @@ -201,7 +202,7 @@ int audio_meta_get_genre(audio_meta_h audio, char **genre); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int audio_meta_get_composer(audio_meta_h audio, char **composer); +int audio_meta_get_composer(audio_meta_h audio, char **composer) TIZEN_DEPRECATED_API; /** * @brief Gets the year of the given audio metadata. @@ -225,6 +226,7 @@ int audio_meta_get_composer(audio_meta_h audio, char **composer); int audio_meta_get_year(audio_meta_h audio, char **year); /** + * @deprecated Deprecated since 9.0. * @brief Gets the recorded date of the given audio metadata. * @details The format of the recorded date may vary depending on the file format. \n * For more details on the recorded date format, refer to the file format specification. @@ -243,9 +245,10 @@ int audio_meta_get_year(audio_meta_h audio, char **year); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int audio_meta_get_recorded_date(audio_meta_h audio, char **recorded_date); +int audio_meta_get_recorded_date(audio_meta_h audio, char **recorded_date) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the copyright notice of the given audio metadata. * @details If the media content has no copyright info, the method returns empty string. * @@ -263,7 +266,7 @@ int audio_meta_get_recorded_date(audio_meta_h audio, char **recorded_date); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int audio_meta_get_copyright(audio_meta_h audio, char **copyright); +int audio_meta_get_copyright(audio_meta_h audio, char **copyright) TIZEN_DEPRECATED_API; /** * @brief Gets the track number of the given audio metadata. @@ -287,6 +290,7 @@ int audio_meta_get_copyright(audio_meta_h audio, char **copyright); int audio_meta_get_track_num(audio_meta_h audio, char **track_num); /** + * @deprecated Deprecated since 9.0. * @brief Gets the bitrate of the given audio metadata in bitrate per second. * @since_tizen 2.3 * @@ -299,9 +303,10 @@ int audio_meta_get_track_num(audio_meta_h audio, char **track_num); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int audio_meta_get_bit_rate(audio_meta_h audio, int *bit_rate); +int audio_meta_get_bit_rate(audio_meta_h audio, int *bit_rate) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets bit per sample of the given audio metadata. * @since_tizen 2.3 * @@ -314,9 +319,10 @@ int audio_meta_get_bit_rate(audio_meta_h audio, int *bit_rate); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int audio_meta_get_bitpersample(audio_meta_h audio, int *bitpersample); +int audio_meta_get_bitpersample(audio_meta_h audio, int *bitpersample) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the sample rate of the given audio metadata. * @since_tizen 2.3 * @@ -329,9 +335,10 @@ int audio_meta_get_bitpersample(audio_meta_h audio, int *bitpersample); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int audio_meta_get_sample_rate(audio_meta_h audio, int *sample_rate); +int audio_meta_get_sample_rate(audio_meta_h audio, int *sample_rate) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the channel of the given audio metadata. * @since_tizen 2.3 * @@ -344,9 +351,10 @@ int audio_meta_get_sample_rate(audio_meta_h audio, int *sample_rate); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int audio_meta_get_channel(audio_meta_h audio, int *channel); +int audio_meta_get_channel(audio_meta_h audio, int *channel) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the track duration of the given audio metadata. * @since_tizen 2.3 * @@ -359,7 +367,7 @@ int audio_meta_get_channel(audio_meta_h audio, int *channel); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int audio_meta_get_duration(audio_meta_h audio, int *duration); +int audio_meta_get_duration(audio_meta_h audio, int *duration) TIZEN_DEPRECATED_API; /** *@} diff --git a/include_product/media_content_type.h b/include_product/media_content_type.h index df64a61..bc1bad3 100755 --- a/include_product/media_content_type.h +++ b/include_product/media_content_type.h @@ -268,6 +268,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 @@ -545,6 +546,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. @@ -753,6 +755,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 @@ -809,6 +812,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 @@ -825,6 +829,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 @@ -841,6 +846,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 @@ -849,6 +855,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 @@ -857,6 +864,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 @@ -865,6 +873,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 @@ -897,6 +906,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 @@ -905,6 +915,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 @@ -915,6 +926,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 @@ -972,6 +984,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 @@ -979,6 +992,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 @@ -986,6 +1000,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 diff --git a/include_product/media_info.h b/include_product/media_info.h index e0c0f40..ee26ef7 100755 --- 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. diff --git a/include_product/media_tag.h b/include_product/media_tag.h index 91d110e..f489062 100755 --- a/include_product/media_tag.h +++ b/include_product/media_tag.h @@ -40,6 +40,7 @@ extern "C" { */ /** + * @deprecated Deprecated since 9.0. * @brief Inserts a new tag in the media database. * @since_tizen 2.3 * @@ -69,9 +70,10 @@ extern "C" { * @see media_tag_delete_from_db() * @see media_tag_destroy() */ -int media_tag_insert_to_db(const char *tag_name, media_tag_h *tag); +int media_tag_insert_to_db(const char *tag_name, media_tag_h *tag) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Deletes a given tag from the media database. * @since_tizen 2.3 * @@ -96,9 +98,10 @@ int media_tag_insert_to_db(const char *tag_name, media_tag_h *tag); * @see media_content_connect() * @see media_tag_insert_to_db() */ -int media_tag_delete_from_db(int tag_id); +int media_tag_delete_from_db(int tag_id) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the count of the tag for the passed @a filter from the media database. * @since_tizen 2.3 * @@ -117,9 +120,10 @@ int media_tag_delete_from_db(int tag_id); * * @see media_content_connect() */ -int media_tag_get_tag_count_from_db(filter_h filter, int *tag_count); +int media_tag_get_tag_count_from_db(filter_h filter, int *tag_count) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Iterates through tags from the media database. * @details This function gets all tags meeting a desired @a filter * and calls a registered callback function for every retrieved tag. @@ -147,9 +151,10 @@ int media_tag_get_tag_count_from_db(filter_h filter, int *tag_count); * @see #media_tag_cb * @see media_filter_create() */ -int media_tag_foreach_tag_from_db(filter_h filter, media_tag_cb callback, void *user_data); +int media_tag_foreach_tag_from_db(filter_h filter, media_tag_cb callback, void *user_data) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the number of media files for the passed @a filter in the given @a tag_id from the media database. * @since_tizen 2.3 * @@ -169,9 +174,10 @@ int media_tag_foreach_tag_from_db(filter_h filter, media_tag_cb callback, void * * * @see media_content_connect() */ -int media_tag_get_media_count_from_db(int tag_id, filter_h filter, int *media_count); +int media_tag_get_media_count_from_db(int tag_id, filter_h filter, int *media_count) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Iterates through media items for a given tag from the media database. * @details This function gets all media items associated with a given tag and * meeting a desired @a filter and calls a registered callback function for @@ -200,9 +206,10 @@ int media_tag_get_media_count_from_db(int tag_id, filter_h filter, int *media_co * @see media_info_cb() * @see media_filter_create() */ -int media_tag_foreach_media_from_db(int tag_id, filter_h filter, media_info_cb callback, void *user_data); +int media_tag_foreach_media_from_db(int tag_id, filter_h filter, media_info_cb callback, void *user_data) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Clones the media tag. * @details This function copies the media tag handle from a source to destination. * There is no media_tag_create() function. The #media_tag_h is created internally and available through media tag foreach function @@ -225,9 +232,10 @@ int media_tag_foreach_media_from_db(int tag_id, filter_h filter, media_info_cb c * * @see media_tag_destroy() */ -int media_tag_clone(media_tag_h *dst, media_tag_h src); +int media_tag_clone(media_tag_h *dst, media_tag_h src) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Destroys the media tag. * @details This function frees all resources related to the tag handle. The tag handle can no longer * be used for any operations. A new tag handle has to be created before next usage. @@ -247,9 +255,10 @@ int media_tag_clone(media_tag_h *dst, media_tag_h src); * @see media_tag_clone() * @see media_tag_insert_to_db() */ -int media_tag_destroy(media_tag_h tag); +int media_tag_destroy(media_tag_h tag) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the media tag ID. * @since_tizen 2.3 * @@ -262,9 +271,10 @@ int media_tag_destroy(media_tag_h tag); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int media_tag_get_tag_id(media_tag_h tag, int *tag_id); +int media_tag_get_tag_id(media_tag_h tag, int *tag_id) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the tag name. * @since_tizen 2.3 * @@ -280,9 +290,10 @@ int media_tag_get_tag_id(media_tag_h tag, int *tag_id); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int media_tag_get_name(media_tag_h tag, char **tag_name); +int media_tag_get_name(media_tag_h tag, char **tag_name) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the media tag from the media database. * * @details This function creates a new media tag handle from the media database by the given @a tag_id. @@ -309,9 +320,10 @@ int media_tag_get_name(media_tag_h tag, char **tag_name); * @see media_content_connect() * @see media_tag_destroy() */ -int media_tag_get_tag_from_db(int tag_id, media_tag_h *tag); +int media_tag_get_tag_from_db(int tag_id, media_tag_h *tag) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Adds a new media info to the tag. * @since_tizen 2.3 * @@ -331,9 +343,10 @@ int media_tag_get_tag_from_db(int tag_id, media_tag_h *tag); * @see media_content_connect() * @see media_tag_remove_media() */ -int media_tag_add_media(media_tag_h tag, const char *media_id); +int media_tag_add_media(media_tag_h tag, const char *media_id) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Removes the media info from the given tag. * @since_tizen 2.3 * @@ -353,9 +366,10 @@ int media_tag_add_media(media_tag_h tag, const char *media_id); * @see media_content_connect() * @see media_tag_add_media() */ -int media_tag_remove_media(media_tag_h tag, const char *media_id); +int media_tag_remove_media(media_tag_h tag, const char *media_id) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Sets the name of the tag. * @since_tizen 2.3 * @@ -371,9 +385,10 @@ int media_tag_remove_media(media_tag_h tag, const char *media_id); * * @post media_tag_update_to_db() */ -int media_tag_set_name(media_tag_h tag, const char *tag_name); +int media_tag_set_name(media_tag_h tag, const char *tag_name) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Updates the media tag to the media database. * * @details The function updates the given media tag in the media database. The function should be called after any change in tag attributes, to be updated to the media @@ -407,7 +422,7 @@ int media_tag_set_name(media_tag_h tag, const char *tag_name); * @see media_tag_remove_media() * @see media_tag_set_name() */ -int media_tag_update_to_db(media_tag_h tag); +int media_tag_update_to_db(media_tag_h tag) TIZEN_DEPRECATED_API; /** * @} diff --git a/include_product/media_video.h b/include_product/media_video.h index 75756b5..e1600be 100755 --- a/include_product/media_video.h +++ b/include_product/media_video.h @@ -99,6 +99,7 @@ int video_meta_destroy(video_meta_h video); int video_meta_get_media_id(video_meta_h video, char **media_id); /** + * @deprecated Deprecated since 9.0. * @brief Gets the album of the given video metadata. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no album info, the method returns empty string. @@ -117,9 +118,10 @@ int video_meta_get_media_id(video_meta_h video, char **media_id); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_album(video_meta_h video, char **album); +int video_meta_get_album(video_meta_h video, char **album) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the artist of the given video metadata. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no artist info, the method returns empty string. @@ -138,9 +140,10 @@ int video_meta_get_album(video_meta_h video, char **album); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_artist(video_meta_h video, char **artist); +int video_meta_get_artist(video_meta_h video, char **artist) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the video album artist. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no album artist info, the method returns empty string. @@ -159,9 +162,10 @@ int video_meta_get_artist(video_meta_h video, char **artist); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_album_artist(video_meta_h video, char **album_artist); +int video_meta_get_album_artist(video_meta_h video, char **album_artist) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the genre of the given video metadata. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no genre info, the method returns empty string. @@ -180,9 +184,10 @@ int video_meta_get_album_artist(video_meta_h video, char **album_artist); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_genre(video_meta_h video, char **genre); +int video_meta_get_genre(video_meta_h video, char **genre) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the composer of the given video metadata. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no composer info, the method returns empty string. @@ -201,9 +206,10 @@ int video_meta_get_genre(video_meta_h video, char **genre); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_composer(video_meta_h video, char **composer); +int video_meta_get_composer(video_meta_h video, char **composer) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the year of the given video metadata. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no year info, the method returns empty string. @@ -222,9 +228,10 @@ int video_meta_get_composer(video_meta_h video, char **composer); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_year(video_meta_h video, char **year); +int video_meta_get_year(video_meta_h video, char **year) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the recorded date of the given video metadata. * @details The format of the recorded date may vary depending on the file format. \n * For more details on the recorded date format, refer to the file format specification. @@ -243,9 +250,10 @@ int video_meta_get_year(video_meta_h video, char **year); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_recorded_date(video_meta_h video, char **recorded_date); +int video_meta_get_recorded_date(video_meta_h video, char **recorded_date) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the copyright notice of the given video metadata. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no copyright info, the method returns empty string. @@ -264,9 +272,10 @@ int video_meta_get_recorded_date(video_meta_h video, char **recorded_date); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_copyright(video_meta_h video, char **copyright); +int video_meta_get_copyright(video_meta_h video, char **copyright) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the track number of the given video metadata. * @details If the value is an empty string, the method returns "Unknown". \n * Since 3.0, if the media content has no track info, the method returns empty string. @@ -285,9 +294,10 @@ int video_meta_get_copyright(video_meta_h video, char **copyright); * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory */ -int video_meta_get_track_num(video_meta_h video, char **track_num); +int video_meta_get_track_num(video_meta_h video, char **track_num) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the bitrate of the given video metadata in bitrate per second. * @since_tizen 2.3 * @@ -300,9 +310,10 @@ int video_meta_get_track_num(video_meta_h video, char **track_num); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int video_meta_get_bit_rate(video_meta_h video, int *bit_rate); +int video_meta_get_bit_rate(video_meta_h video, int *bit_rate) TIZEN_DEPRECATED_API; /** + * @deprecated Deprecated since 9.0. * @brief Gets the track duration of the given video metadata. * @since_tizen 2.3 * @@ -315,7 +326,7 @@ int video_meta_get_bit_rate(video_meta_h video, int *bit_rate); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int video_meta_get_duration(video_meta_h video, int *duration); +int video_meta_get_duration(video_meta_h video, int *duration) TIZEN_DEPRECATED_API; /** * @brief Gets the width of the given video metadata. @@ -348,6 +359,7 @@ int video_meta_get_width(video_meta_h video, int *width); int video_meta_get_height(video_meta_h video, int *height); /** + * @deprecated Deprecated since 9.0. * @brief Gets the rotation of the given video metadata. * @since_tizen 4.0 * @@ -360,7 +372,7 @@ int video_meta_get_height(video_meta_h video, int *height); * @retval #MEDIA_CONTENT_ERROR_NONE Successful * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter */ -int video_meta_get_rotation(video_meta_h video, int *rotation); +int video_meta_get_rotation(video_meta_h video, int *rotation) TIZEN_DEPRECATED_API; /** *@} diff --git a/src/media_audio.c b/src/media_audio.c index c3bf6a1..c73e578 100644 --- a/src/media_audio.c +++ b/src/media_audio.c @@ -132,72 +132,76 @@ int audio_meta_get_genre(audio_meta_h audio, char **genre) return MEDIA_CONTENT_ERROR_NONE; } -int audio_meta_get_composer(audio_meta_h audio, char **composer) +int audio_meta_get_year(audio_meta_h audio, char **year) { audio_meta_s *_audio = (audio_meta_s*)audio; content_retip_if_fail(audio); - content_retip_if_fail(composer); + content_retip_if_fail(year); - /*composer can be empty string*/ - *composer = g_strdup(_audio->composer); + /*year can be empty string*/ + *year = g_strdup(_audio->year); return MEDIA_CONTENT_ERROR_NONE; } -int audio_meta_get_year(audio_meta_h audio, char **year) +int audio_meta_get_track_num(audio_meta_h audio, char **track_num) { audio_meta_s *_audio = (audio_meta_s*)audio; content_retip_if_fail(audio); - content_retip_if_fail(year); + content_retip_if_fail(track_num); - /*year can be empty string*/ - *year = g_strdup(_audio->year); + /*track_num can be empty string*/ + *track_num = g_strdup(_audio->track_num); return MEDIA_CONTENT_ERROR_NONE; } - -int audio_meta_get_recorded_date(audio_meta_h audio, char **recorded_date) +// LCOV_EXCL_START +int audio_meta_get_composer(audio_meta_h audio, char **composer) { + content_warn("DEPRECATION WARNING: audio_meta_get_composer() is deprecated and will be removed from next release."); audio_meta_s *_audio = (audio_meta_s*)audio; content_retip_if_fail(audio); - content_retip_if_fail(recorded_date); + content_retip_if_fail(composer); - *recorded_date = g_strdup(_audio->recorded_date); + /*composer can be empty string*/ + *composer = g_strdup(_audio->composer); return MEDIA_CONTENT_ERROR_NONE; } -int audio_meta_get_copyright(audio_meta_h audio, char **copyright) +int audio_meta_get_recorded_date(audio_meta_h audio, char **recorded_date) { + content_warn("DEPRECATION WARNING: audio_meta_get_recorded_date() is deprecated and will be removed from next release."); audio_meta_s *_audio = (audio_meta_s*)audio; content_retip_if_fail(audio); - content_retip_if_fail(copyright); + content_retip_if_fail(recorded_date); - /*copyright can be empty string*/ - *copyright = g_strdup(_audio->copyright); + *recorded_date = g_strdup(_audio->recorded_date); return MEDIA_CONTENT_ERROR_NONE; } -int audio_meta_get_track_num(audio_meta_h audio, char **track_num) +int audio_meta_get_copyright(audio_meta_h audio, char **copyright) { + content_warn("DEPRECATION WARNING: audio_meta_get_copyright() is deprecated and will be removed from next release."); audio_meta_s *_audio = (audio_meta_s*)audio; content_retip_if_fail(audio); - content_retip_if_fail(track_num); + content_retip_if_fail(copyright); - /*track_num can be empty string*/ - *track_num = g_strdup(_audio->track_num); + /*copyright can be empty string*/ + *copyright = g_strdup(_audio->copyright); return MEDIA_CONTENT_ERROR_NONE; } int audio_meta_get_bit_rate(audio_meta_h audio, int *bit_rate) { + content_warn("DEPRECATION WARNING: audio_meta_get_bit_rate() is deprecated and will be removed from next release."); audio_meta_s *_audio = (audio_meta_s*)audio; content_retip_if_fail(audio); @@ -210,6 +214,7 @@ int audio_meta_get_bit_rate(audio_meta_h audio, int *bit_rate) int audio_meta_get_bitpersample(audio_meta_h audio, int *bitpersample) { + content_warn("DEPRECATION WARNING: audio_meta_get_bitpersample() is deprecated and will be removed from next release."); audio_meta_s *_audio = (audio_meta_s*)audio; content_retip_if_fail(audio); @@ -222,6 +227,7 @@ int audio_meta_get_bitpersample(audio_meta_h audio, int *bitpersample) int audio_meta_get_sample_rate(audio_meta_h audio, int *sample_rate) { + content_warn("DEPRECATION WARNING: audio_meta_get_sample_rate() is deprecated and will be removed from next release."); audio_meta_s *_audio = (audio_meta_s*)audio; content_retip_if_fail(audio); @@ -234,6 +240,7 @@ int audio_meta_get_sample_rate(audio_meta_h audio, int *sample_rate) int audio_meta_get_channel(audio_meta_h audio, int *channel) { + content_warn("DEPRECATION WARNING: audio_meta_get_channel() is deprecated and will be removed from next release."); audio_meta_s *_audio = (audio_meta_s*)audio; content_retip_if_fail(audio); @@ -246,6 +253,7 @@ int audio_meta_get_channel(audio_meta_h audio, int *channel) int audio_meta_get_duration(audio_meta_h audio, int *duration) { + content_warn("DEPRECATION WARNING: audio_meta_get_duration() is deprecated and will be removed from next release."); audio_meta_s *_audio = (audio_meta_s*)audio; content_retip_if_fail(audio); @@ -255,3 +263,4 @@ int audio_meta_get_duration(audio_meta_h audio, int *duration) return MEDIA_CONTENT_ERROR_NONE; } +// LCOV_EXCL_STOP \ No newline at end of file diff --git a/src/media_info.c b/src/media_info.c index 95ce20f..56c3cf5 100644 --- a/src/media_info.c +++ b/src/media_info.c @@ -704,9 +704,10 @@ int media_info_foreach_media_from_db(filter_h filter, media_info_cb callback, vo return _media_db_get_group_item(NULL, filter, callback, user_data, MEDIA_GROUP_NONE); } - +// LCOV_EXCL_START int media_info_get_tag_count_from_db(const char *media_id, filter_h filter, int *tag_count) { + content_warn("DEPRECATION WARNING: media_info_get_tag_count_from_db() is deprecated and will be removed from next release."); content_retip_if_fail(STRING_VALID(media_id)); content_retip_if_fail(tag_count); @@ -715,12 +716,13 @@ int media_info_get_tag_count_from_db(const char *media_id, filter_h filter, int int media_info_foreach_tag_from_db(const char *media_id, filter_h filter, media_tag_cb callback, void *user_data) { + content_warn("DEPRECATION WARNING: media_info_foreach_tag_from_db() is deprecated and will be removed from next release."); content_retip_if_fail(STRING_VALID(media_id)); content_retip_if_fail(callback); return _media_db_get_tag(media_id, filter, callback, user_data); } - +// LCOV_EXCL_STOP int media_info_get_bookmark_count_from_db(const char *media_id, filter_h filter, int *bookmark_count) { content_retip_if_fail(STRING_VALID(media_id)); @@ -971,9 +973,10 @@ int media_info_get_modified_time(media_info_h media, time_t* time) return MEDIA_CONTENT_ERROR_NONE; } - +// LCOV_EXCL_START int media_info_get_timeline(media_info_h media, time_t* time) { + content_warn("DEPRECATION WARNING: media_info_get_timeline() is deprecated and will be removed from next release."); media_info_s *_media = (media_info_s*)media; content_retip_if_fail(media); @@ -983,7 +986,7 @@ int media_info_get_timeline(media_info_h media, time_t* time) return MEDIA_CONTENT_ERROR_NONE; } - +// LCOV_EXCL_STOP int media_info_get_thumbnail_path(media_info_h media, char **path) { media_info_s *_media = (media_info_s*)media; @@ -1007,9 +1010,10 @@ int media_info_get_title(media_info_h media, char **title) return MEDIA_CONTENT_ERROR_NONE; } - +// LCOV_EXCL_START int media_info_get_description(media_info_h media, char **description) { + content_warn("DEPRECATION WARNING: media_info_get_description() is deprecated and will be removed from next release."); media_info_s *_media = (media_info_s*)media; content_retip_if_fail(media); @@ -1022,6 +1026,7 @@ int media_info_get_description(media_info_h media, char **description) int media_info_get_longitude(media_info_h media, double* longitude) { + content_warn("DEPRECATION WARNING: media_info_get_longitude() is deprecated and will be removed from next release."); media_info_s *_media = (media_info_s*)media; content_retip_if_fail(media); @@ -1033,6 +1038,7 @@ int media_info_get_longitude(media_info_h media, double* longitude) } int media_info_get_latitude(media_info_h media, double* latitude) { + content_warn("DEPRECATION WARNING: media_info_get_latitude() is deprecated and will be removed from next release."); media_info_s *_media = (media_info_s*)media; content_retip_if_fail(media); @@ -1045,6 +1051,7 @@ int media_info_get_latitude(media_info_h media, double* latitude) int media_info_get_altitude(media_info_h media, double *altitude) { + content_warn("DEPRECATION WARNING: media_info_get_altitude() is deprecated and will be removed from next release."); media_info_s *_media = (media_info_s*)media; content_retip_if_fail(media); @@ -1057,6 +1064,7 @@ int media_info_get_altitude(media_info_h media, double *altitude) int media_info_get_rating(media_info_h media, int *rating) { + content_warn("DEPRECATION WARNING: media_info_get_rating() is deprecated and will be removed from next release."); media_info_s *_media = (media_info_s*)media; content_retip_if_fail(media); @@ -1069,6 +1077,7 @@ int media_info_get_rating(media_info_h media, int *rating) int media_info_get_favorite(media_info_h media, bool* favorite) { + content_warn("DEPRECATION WARNING: media_info_get_favorite() is deprecated and will be removed from next release."); media_info_s *_media = (media_info_s*)media; content_retip_if_fail(media); @@ -1081,6 +1090,7 @@ int media_info_get_favorite(media_info_h media, bool* favorite) int media_info_is_drm(media_info_h media, bool *is_drm) { + content_warn("DEPRECATION WARNING: media_info_is_drm() is deprecated and will be removed from next release."); media_info_s *_media = (media_info_s*)media; content_retip_if_fail(media); @@ -1093,6 +1103,7 @@ int media_info_is_drm(media_info_h media, bool *is_drm) int media_info_is_360_content(media_info_h media, bool *is_360) { + content_warn("DEPRECATION WARNING: media_info_is_360_content() is deprecated and will be removed from next release."); media_info_s *_media = (media_info_s*)media; content_retip_if_fail(media); @@ -1102,7 +1113,7 @@ int media_info_is_360_content(media_info_h media, bool *is_360) return MEDIA_CONTENT_ERROR_NONE; } - +// LCOV_EXCL_STOP #ifdef _USE_TVPD_MODE int media_info_get_played_count(media_info_h media, int *played_count) { @@ -1302,9 +1313,10 @@ int media_info_get_media_from_db_by_path(const char *path, media_info_h *media) return ret; } - +// LCOV_EXCL_START int media_info_set_favorite(media_info_h media, bool favorite) { + content_warn("DEPRECATION WARNING: media_info_set_favorite() is deprecated and will be removed from next release."); media_info_s *_media = (media_info_s*)media; content_retip_if_fail(media); @@ -1319,6 +1331,7 @@ int media_info_set_favorite(media_info_h media, bool favorite) int media_info_update_to_db(media_info_h media) { + content_warn("DEPRECATION WARNING: media_info_update_to_db() is deprecated and will be removed from next release."); int ret = MEDIA_CONTENT_ERROR_NONE; media_info_s *_media = (media_info_s*)media; char *sql = NULL; @@ -1345,7 +1358,7 @@ int media_info_update_to_db(media_info_h media) return ret; } - +// LCOV_EXCL_STOP int media_info_move_to_db(media_info_h media, const char* dst_path) { int ret = MEDIA_CONTENT_ERROR_NONE; diff --git a/src/media_tag.c b/src/media_tag.c index 1c5fca6..8286b15 100755 --- a/src/media_tag.c +++ b/src/media_tag.c @@ -17,6 +17,7 @@ #include +// LCOV_EXCL_START static void __media_tag_item_free(gpointer item) { media_tag_item_s *_item = (media_tag_item_s *)item; @@ -98,6 +99,7 @@ static int __media_tag_get_tag_info_from_db(const char *name, media_tag_h tag) int media_tag_insert_to_db(const char *tag_name, media_tag_h *tag) { + content_warn("DEPRECATION WARNING: media_tag_insert_to_db() is deprecated and will be removed from next release."); int ret = MEDIA_CONTENT_ERROR_NONE; char *query_str = NULL; media_tag_s *_tag = NULL; @@ -120,6 +122,7 @@ int media_tag_insert_to_db(const char *tag_name, media_tag_h *tag) int media_tag_delete_from_db(int tag_id) { + content_warn("DEPRECATION WARNING: media_tag_delete_from_db() is deprecated and will be removed from next release."); int ret = MEDIA_CONTENT_ERROR_NONE; char *query_str = NULL; @@ -135,6 +138,7 @@ int media_tag_delete_from_db(int tag_id) int media_tag_get_tag_count_from_db(filter_h filter, int *tag_count) { + content_warn("DEPRECATION WARNING: media_tag_get_tag_count_from_db() is deprecated and will be removed from next release."); content_retip_if_fail(tag_count); return _media_db_get_group_count(filter, MEDIA_GROUP_TAG, tag_count); @@ -142,6 +146,7 @@ int media_tag_get_tag_count_from_db(filter_h filter, int *tag_count) int media_tag_foreach_tag_from_db(filter_h filter, media_tag_cb callback, void *user_data) { + content_warn("DEPRECATION WARNING: media_tag_foreach_tag_from_db() is deprecated and will be removed from next release."); content_retip_if_fail(callback); return _media_db_get_tag(NULL, filter, callback, user_data); @@ -149,6 +154,7 @@ int media_tag_foreach_tag_from_db(filter_h filter, media_tag_cb callback, void * int media_tag_get_media_count_from_db(int tag_id, filter_h filter, int *media_count) { + content_warn("DEPRECATION WARNING: media_tag_get_media_count_from_db() is deprecated and will be removed from next release."); content_retipm_if_fail(tag_id > 0, "%d", tag_id); content_retip_if_fail(media_count); @@ -157,6 +163,7 @@ int media_tag_get_media_count_from_db(int tag_id, filter_h filter, int *media_co int media_tag_foreach_media_from_db(int tag_id, filter_h filter, media_info_cb callback, void *user_data) { + content_warn("DEPRECATION WARNING: media_tag_foreach_media_from_db() is deprecated and will be removed from next release."); content_retip_if_fail(callback); return _media_db_get_group_item_by_id(tag_id, filter, callback, user_data, MEDIA_GROUP_TAG); @@ -164,6 +171,7 @@ int media_tag_foreach_media_from_db(int tag_id, filter_h filter, media_info_cb c int media_tag_destroy(media_tag_h tag) { + content_warn("DEPRECATION WARNING: media_tag_destroy() is deprecated and will be removed from next release."); media_tag_s *_tag = (media_tag_s *)tag; content_retip_if_fail(tag); @@ -178,6 +186,7 @@ int media_tag_destroy(media_tag_h tag) int media_tag_clone(media_tag_h *dst, media_tag_h src) { + content_warn("DEPRECATION WARNING: media_tag_clone() is deprecated and will be removed from next release."); media_tag_s *_src = (media_tag_s *)src; media_tag_s *_dst = NULL; @@ -196,6 +205,7 @@ int media_tag_clone(media_tag_h *dst, media_tag_h src) int media_tag_get_tag_id(media_tag_h tag, int *tag_id) { + content_warn("DEPRECATION WARNING: media_tag_get_tag_id() is deprecated and will be removed from next release."); media_tag_s *_tag = (media_tag_s *)tag; content_retip_if_fail(tag); @@ -208,6 +218,7 @@ int media_tag_get_tag_id(media_tag_h tag, int *tag_id) int media_tag_get_name(media_tag_h tag, char **name) { + content_warn("DEPRECATION WARNING: media_tag_get_name() is deprecated and will be removed from next release."); media_tag_s *_tag = (media_tag_s *)tag; content_retip_if_fail(tag); @@ -220,6 +231,7 @@ int media_tag_get_name(media_tag_h tag, char **name) int media_tag_get_tag_from_db(int tag_id, media_tag_h *tag) { + content_warn("DEPRECATION WARNING: media_tag_get_tag_from_db() is deprecated and will be removed from next release."); int ret = MEDIA_CONTENT_ERROR_NONE; sqlite3_stmt *stmt = NULL; char *query = NULL; @@ -252,6 +264,7 @@ int media_tag_get_tag_from_db(int tag_id, media_tag_h *tag) int media_tag_add_media(media_tag_h tag, const char *media_id) { + content_warn("DEPRECATION WARNING: media_tag_add_media() is deprecated and will be removed from next release."); int ret = MEDIA_CONTENT_ERROR_NONE; media_tag_s *_tag = (media_tag_s *)tag; media_tag_item_s *_item = NULL; @@ -271,6 +284,7 @@ int media_tag_add_media(media_tag_h tag, const char *media_id) int media_tag_remove_media(media_tag_h tag, const char *media_id) { + content_warn("DEPRECATION WARNING: media_tag_remove_media() is deprecated and will be removed from next release."); int ret = MEDIA_CONTENT_ERROR_NONE; media_tag_s *_tag = (media_tag_s *)tag; media_tag_item_s *_item = NULL; @@ -290,6 +304,7 @@ int media_tag_remove_media(media_tag_h tag, const char *media_id) int media_tag_set_name(media_tag_h tag, const char *tag_name) { + content_warn("DEPRECATION WARNING: media_tag_set_name() is deprecated and will be removed from next release."); int ret = MEDIA_CONTENT_ERROR_NONE; media_tag_s *_tag = (media_tag_s *)tag; media_tag_item_s *_item = NULL; @@ -343,6 +358,7 @@ void __media_tag_foreach_request(gpointer data, gpointer user_data) int media_tag_update_to_db(media_tag_h tag) { + content_warn("DEPRECATION WARNING: media_tag_update_to_db() is deprecated and will be removed from next release."); int ret = MEDIA_CONTENT_ERROR_NONE; media_tag_s *_tag = (media_tag_s *)tag; @@ -360,6 +376,7 @@ int media_tag_update_to_db(media_tag_h tag) int media_tag_create(media_tag_h *tag) { + content_warn("DEPRECATION WARNING: media_tag_create() is deprecated and will be removed from next release."); content_retip_if_fail(tag); media_tag_s *_tag = g_new0(media_tag_s, 1); @@ -375,6 +392,7 @@ int media_tag_create(media_tag_h *tag) int media_tag_insert_to_db_v2(media_tag_h tag) { + content_warn("DEPRECATION WARNING: media_tag_insert_to_db_v2() is deprecated and will be removed from next release."); int ret = MEDIA_CONTENT_ERROR_NONE; media_tag_s *_tag = (media_tag_s *)tag; media_tag_h tag_1; @@ -409,6 +427,7 @@ ERROR: int media_tag_update_to_db_v2(int tag_id, media_tag_h tag) { + content_warn("DEPRECATION WARNING: media_tag_update_to_db_v2() is deprecated and will be removed from next release."); media_tag_s *_tag = (media_tag_s *)tag; content_retip_if_fail(tag); @@ -418,3 +437,4 @@ int media_tag_update_to_db_v2(int tag_id, media_tag_h tag) return media_tag_update_to_db(tag); } +// LCOV_EXCL_STOP \ No newline at end of file diff --git a/src/media_video.c b/src/media_video.c index de9b517..cc66600 100755 --- a/src/media_video.c +++ b/src/media_video.c @@ -79,9 +79,10 @@ 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."); video_meta_s *_video = (video_meta_s*)video; content_retip_if_fail(video); @@ -94,6 +95,7 @@ int video_meta_get_album(video_meta_h video, char **album) int video_meta_get_artist(video_meta_h video, char **artist) { + content_warn("DEPRECATION WARNING: video_meta_get_artist() is deprecated and will be removed from next release."); video_meta_s *_video = (video_meta_s*)video; content_retip_if_fail(video); @@ -106,6 +108,7 @@ int video_meta_get_artist(video_meta_h video, char **artist) int video_meta_get_album_artist(video_meta_h video, char **album_artist) { + content_warn("DEPRECATION WARNING: video_meta_get_album_artist() is deprecated and will be removed from next release."); video_meta_s *_video = (video_meta_s*)video; content_retip_if_fail(video); @@ -118,6 +121,7 @@ int video_meta_get_album_artist(video_meta_h video, char **album_artist) int video_meta_get_genre(video_meta_h video, char **genre) { + content_warn("DEPRECATION WARNING: video_meta_get_genre() is deprecated and will be removed from next release."); video_meta_s *_video = (video_meta_s*)video; content_retip_if_fail(video); @@ -130,6 +134,7 @@ int video_meta_get_genre(video_meta_h video, char **genre) int video_meta_get_composer(video_meta_h video, char **composer) { + content_warn("DEPRECATION WARNING: video_meta_get_composer() is deprecated and will be removed from next release."); video_meta_s *_video = (video_meta_s*)video; content_retip_if_fail(video); @@ -142,6 +147,7 @@ int video_meta_get_composer(video_meta_h video, char **composer) int video_meta_get_year(video_meta_h video, char **year) { + content_warn("DEPRECATION WARNING: video_meta_get_year() is deprecated and will be removed from next release."); video_meta_s *_video = (video_meta_s*)video; content_retip_if_fail(video); @@ -154,6 +160,7 @@ int video_meta_get_year(video_meta_h video, char **year) int video_meta_get_recorded_date(video_meta_h video, char **recorded_date) { + content_warn("DEPRECATION WARNING: video_meta_get_recorded_date() is deprecated and will be removed from next release."); video_meta_s *_video = (video_meta_s*)video; content_retip_if_fail(video); @@ -166,6 +173,7 @@ int video_meta_get_recorded_date(video_meta_h video, char **recorded_date) int video_meta_get_copyright(video_meta_h video, char **copyright) { + content_warn("DEPRECATION WARNING: video_meta_get_copyright() is deprecated and will be removed from next release."); video_meta_s *_video = (video_meta_s*)video; content_retip_if_fail(video); @@ -178,6 +186,7 @@ int video_meta_get_copyright(video_meta_h video, char **copyright) int video_meta_get_track_num(video_meta_h video, char **track_num) { + content_warn("DEPRECATION WARNING: video_meta_get_track_num() is deprecated and will be removed from next release."); video_meta_s *_video = (video_meta_s*)video; content_retip_if_fail(video); @@ -190,6 +199,7 @@ int video_meta_get_track_num(video_meta_h video, char **track_num) int video_meta_get_bit_rate(video_meta_h video, int *bit_rate) { + content_warn("DEPRECATION WARNING: video_meta_get_bit_rate() is deprecated and will be removed from next release."); video_meta_s *_video = (video_meta_s*)video; content_retip_if_fail(video); @@ -202,6 +212,7 @@ int video_meta_get_bit_rate(video_meta_h video, int *bit_rate) int video_meta_get_duration(video_meta_h video, int *duration) { + content_warn("DEPRECATION WARNING: video_meta_get_duration() is deprecated and will be removed from next release."); video_meta_s *_video = (video_meta_s*)video; content_retip_if_fail(video); @@ -212,38 +223,39 @@ int video_meta_get_duration(video_meta_h video, int *duration) return MEDIA_CONTENT_ERROR_NONE; } -int video_meta_get_width(video_meta_h video, int *width) +int video_meta_get_rotation(video_meta_h video, int *rotation) { + content_warn("DEPRECATION WARNING: video_meta_get_rotation() is deprecated and will be removed from next release."); video_meta_s *_video = (video_meta_s*)video; content_retip_if_fail(video); - content_retip_if_fail(width); + content_retip_if_fail(rotation); - *width = _video->width; + *rotation = _video->rotation; return MEDIA_CONTENT_ERROR_NONE; } - -int video_meta_get_height(video_meta_h video, int *height) +// LCOV_EXCL_STOP +int video_meta_get_width(video_meta_h video, int *width) { video_meta_s *_video = (video_meta_s*)video; content_retip_if_fail(video); - content_retip_if_fail(height); + content_retip_if_fail(width); - *height = _video->height; + *width = _video->width; return MEDIA_CONTENT_ERROR_NONE; } -int video_meta_get_rotation(video_meta_h video, int *rotation) +int video_meta_get_height(video_meta_h video, int *height) { video_meta_s *_video = (video_meta_s*)video; content_retip_if_fail(video); - content_retip_if_fail(rotation); + content_retip_if_fail(height); - *rotation = _video->rotation; + *height = _video->height; return MEDIA_CONTENT_ERROR_NONE; } -- 2.7.4