[ACR-1098] Deprecate APIs for product

deprecated media_info_delete_batch_from_db, media_info_insert_burst_shot_to_db, image_meta_get_burst_id(), image_meta_is_burst_shot() and burst shot related code.

Change-Id: I6ec952ba364ac8d0594f7c07fb063a4468a8beb9
Signed-off-by: Minje Ahn <minje.ahn@samsung.com>

diff --git a/include/media_content_type.h b/include/media_content_type.h
index d08c146..cf4f90f 100755 (executable)
--- a/include/media_content_type.h
+++ b/include/media_content_type.h
@@ -171,7 +171,7 @@ typedef enum {
        MEDIA_CONTENT_GROUP_LONGITUDE,           /**< Media group ID for the longitude*/
        MEDIA_CONTENT_GROUP_LATITUDE,            /**< Media group ID for the latitude*/
        MEDIA_CONTENT_GROUP_ALTITUDE,            /**< Media group ID for the altitude*/
-       MEDIA_CONTENT_GROUP_BURST_IMAGE,         /**< Media group ID for the burst shot*/
+       MEDIA_CONTENT_GROUP_BURST_IMAGE,         /**< Media group ID for the burst shot (Deprecated since 4.0)*/
        MEDIA_CONTENT_GROUP_RATING,              /**< Media group ID for a rating*/
        MEDIA_CONTENT_GROUP_AUTHOR,              /**< Media group ID for an author (Deprecated since 4.0)*/
        MEDIA_CONTENT_GROUP_PROVIDER,            /**< Media group ID for a provider*/
@@ -369,6 +369,7 @@ typedef void (*media_insert_completed_cb)(media_content_error_e error, void * us
 
 
 /**
+ * @deprecated Deprecated since 4.0.
  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
  * @brief Called when the burst shot is inserted completely.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -919,6 +920,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_ORIENTATION "MEDIA_ORIENTATION"
 
 /**
+ * @deprecated Deprecated since 4.0.
  * @brief Media burst ID
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif

diff --git a/include/media_image.h b/include/media_image.h
index 01a687d..0ec7bbd 100755 (executable)
--- a/include/media_image.h
+++ b/include/media_image.h
@@ -159,6 +159,7 @@ int image_meta_get_orientation(image_meta_h image, media_content_orientation_e *
 int image_meta_get_date_taken(image_meta_h image, char **date_taken);
 
 /**
+ * @deprecated Deprecated since 4.0.
  * @brief Gets the burst shot ID.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -175,7 +176,7 @@ int image_meta_get_date_taken(image_meta_h image, char **date_taken);
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int image_meta_get_burst_id(image_meta_h image, char **burst_id);
+int image_meta_get_burst_id(image_meta_h image, char **burst_id) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Gets the exposure time from exif.
@@ -248,6 +249,7 @@ int image_meta_get_iso(image_meta_h image, int *iso);
 int image_meta_get_model(image_meta_h image, char **model);
 
 /**
+ * @deprecated Deprecated since 4.0.
  * @brief Checks whether the media is a burst shot image.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -261,7 +263,7 @@ int image_meta_get_model(image_meta_h image, char **model);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int image_meta_is_burst_shot(image_meta_h image, bool *is_burst_shot);
+int image_meta_is_burst_shot(image_meta_h image, bool *is_burst_shot) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since 4.0. This data cannot be saved to the file.

diff --git a/include/media_info.h b/include/media_info.h
index 22c5c08..98e7914 100755 (executable)
--- a/include/media_info.h
+++ b/include/media_info.h
@@ -122,6 +122,7 @@ int media_info_insert_to_db(const char *path, media_info_h *info);
 int media_info_insert_batch_to_db(const char **path_array, unsigned int array_length, media_insert_completed_cb callback, void *user_data);
 
 /**
+ * @deprecated Deprecated since 4.0.
  * @brief Inserts the burst shot images into the media database, asynchronously.
  * @details This function inserts burst images into the media database.
  *          media_insert_burst_shot_completed_cb() will be called when insertion to media database is finished.
@@ -160,7 +161,7 @@ int media_info_insert_batch_to_db(const char **path_array, unsigned int array_le
  * @see media_content_connect()
  * @see media_insert_burst_shot_completed_cb()
  */
-int media_info_insert_burst_shot_to_db(const char **path_array, unsigned int array_length, media_insert_burst_shot_completed_cb callback, void *user_data);
+int media_info_insert_burst_shot_to_db(const char **path_array, unsigned int array_length, media_insert_burst_shot_completed_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Deletes the media information from the media database.
@@ -194,6 +195,7 @@ int media_info_insert_burst_shot_to_db(const char **path_array, unsigned int arr
 int media_info_delete_from_db(const char *media_id);
 
 /**
+ * @deprecated Deprecated since 4.0.
  * @brief Deletes media information that meets the conditions of the filter from the media database.
  * @details This function can delete multiple media information from the media database.
  *
@@ -220,7 +222,7 @@ int media_info_delete_from_db(const char *media_id);
  * @see media_content_connect()
  * @see media_filter_create()
  */
-int media_info_delete_batch_from_db(filter_h filter);
+int media_info_delete_batch_from_db(filter_h filter) TIZEN_DEPRECATED_API;
 
 
 /**

diff --git a/include_product/media_content_type.h b/include_product/media_content_type.h
index f90f878..7149d80 100755 (executable)
--- a/include_product/media_content_type.h
+++ b/include_product/media_content_type.h
@@ -180,7 +180,7 @@ typedef enum {
        MEDIA_CONTENT_GROUP_LONGITUDE,           /**< Media group ID for the longitude*/
        MEDIA_CONTENT_GROUP_LATITUDE,            /**< Media group ID for the latitude*/
        MEDIA_CONTENT_GROUP_ALTITUDE,            /**< Media group ID for the altitude*/
-       MEDIA_CONTENT_GROUP_BURST_IMAGE,         /**< Media group ID for the burst shot*/
+       MEDIA_CONTENT_GROUP_BURST_IMAGE,         /**< Media group ID for the burst shot (Deprecated since 4.0)*/
        MEDIA_CONTENT_GROUP_RATING,              /**< Media group ID for a rating*/
        MEDIA_CONTENT_GROUP_AUTHOR,              /**< Media group ID for an author (Deprecated since 4.0)*/
        MEDIA_CONTENT_GROUP_PROVIDER,            /**< Media group ID for a provider*/
@@ -435,6 +435,7 @@ typedef void (*media_insert_completed_cb)(media_content_error_e error, void * us
 
 
 /**
+ * @deprecated Deprecated since 4.0.
  * @ingroup CAPI_CONTENT_MEDIA_INFO_MODULE
  * @brief Called when the burst shot is inserted completely.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -985,6 +986,7 @@ typedef bool (*media_face_cb)(media_face_h face, void *user_data);
 #define MEDIA_ORIENTATION "MEDIA_ORIENTATION"
 
 /**
+ * @deprecated Deprecated since 4.0.
  * @brief Media burst ID
  * @details You can use above define to set the condition of media filter and order keyword.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif

diff --git a/include_product/media_image.h b/include_product/media_image.h
index 01a687d..0ec7bbd 100755 (executable)
--- a/include_product/media_image.h
+++ b/include_product/media_image.h
@@ -159,6 +159,7 @@ int image_meta_get_orientation(image_meta_h image, media_content_orientation_e *
 int image_meta_get_date_taken(image_meta_h image, char **date_taken);
 
 /**
+ * @deprecated Deprecated since 4.0.
  * @brief Gets the burst shot ID.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -175,7 +176,7 @@ int image_meta_get_date_taken(image_meta_h image, char **date_taken);
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int image_meta_get_burst_id(image_meta_h image, char **burst_id);
+int image_meta_get_burst_id(image_meta_h image, char **burst_id) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Gets the exposure time from exif.
@@ -248,6 +249,7 @@ int image_meta_get_iso(image_meta_h image, int *iso);
 int image_meta_get_model(image_meta_h image, char **model);
 
 /**
+ * @deprecated Deprecated since 4.0.
  * @brief Checks whether the media is a burst shot image.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -261,7 +263,7 @@ int image_meta_get_model(image_meta_h image, char **model);
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
-int image_meta_is_burst_shot(image_meta_h image, bool *is_burst_shot);
+int image_meta_is_burst_shot(image_meta_h image, bool *is_burst_shot) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since 4.0. This data cannot be saved to the file.

diff --git a/include_product/media_info.h b/include_product/media_info.h
index 20af652..4a0a917 100755 (executable)
--- a/include_product/media_info.h
+++ b/include_product/media_info.h
@@ -122,6 +122,7 @@ int media_info_insert_to_db(const char *path, media_info_h *info);
 int media_info_insert_batch_to_db(const char **path_array, unsigned int array_length, media_insert_completed_cb callback, void *user_data);
 
 /**
+ * @deprecated Deprecated since 4.0.
  * @brief Inserts the burst shot images into the media database, asynchronously.
  * @details This function inserts burst images into the media database.
  *          media_insert_burst_shot_completed_cb() will be called when insertion to media database is finished.
@@ -160,7 +161,7 @@ int media_info_insert_batch_to_db(const char **path_array, unsigned int array_le
  * @see media_content_connect()
  * @see media_insert_burst_shot_completed_cb()
  */
-int media_info_insert_burst_shot_to_db(const char **path_array, unsigned int array_length, media_insert_burst_shot_completed_cb callback, void *user_data);
+int media_info_insert_burst_shot_to_db(const char **path_array, unsigned int array_length, media_insert_burst_shot_completed_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Deletes the media information from the media database.
@@ -194,6 +195,7 @@ int media_info_insert_burst_shot_to_db(const char **path_array, unsigned int arr
 int media_info_delete_from_db(const char *media_id);
 
 /**
+ * @deprecated Deprecated since 4.0.
  * @brief Deletes media information that meets the conditions of the filter from the media database.
  * @details This function can delete multiple media information from the media database.
  *
@@ -220,7 +222,7 @@ int media_info_delete_from_db(const char *media_id);
  * @see media_content_connect()
  * @see media_filter_create()
  */
-int media_info_delete_batch_from_db(filter_h filter);
+int media_info_delete_batch_from_db(filter_h filter) TIZEN_DEPRECATED_API;
 
 
 /**

diff --git a/src/media_image.c b/src/media_image.c
index 3d517ca..9852905 100755 (executable)
--- a/src/media_image.c
+++ b/src/media_image.c
@@ -230,6 +230,7 @@ int image_meta_get_date_taken(image_meta_h image, char **date_taken)
 int image_meta_get_burst_id(image_meta_h image, char **burst_id)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: image_meta_get_burst_id() is deprecated and will be removed from next release.");
        image_meta_s *_image = (image_meta_s*)image;
 
        if (_image && burst_id) {
@@ -325,6 +326,7 @@ int image_meta_get_model(image_meta_h image, char **model)
 int image_meta_is_burst_shot(image_meta_h image, bool *is_burst_shot)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: image_meta_is_burst_shot() is deprecated and will be removed from next release.");
        image_meta_s *_image = (image_meta_s*)image;
 
        if (_image && is_burst_shot) {

diff --git a/src/media_info.c b/src/media_info.c
index 09bbfe6..89507a1 100755 (executable)
--- a/src/media_info.c
+++ b/src/media_info.c
@@ -577,6 +577,8 @@ int media_info_insert_burst_shot_to_db(const char **path_array, unsigned int arr
        int ret = MS_MEDIA_ERR_NONE;
        char repl_path[MAX_PATH_LEN] = {0, };
 
+       media_content_warn("DEPRECATION WARNING: media_info_insert_burst_shot_to_db() is deprecated and will be removed from next release.");
+
        media_content_retvm_if(path_array == NULL, MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid path_array");
        media_content_retvm_if(array_length <= 0, MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid array_length");
 
@@ -832,6 +834,8 @@ int media_info_delete_batch_from_db(filter_h filter)
        int idx = 0;
        media_storage_s *storage_item = NULL;
 
+       media_content_warn("DEPRECATION WARNING: media_info_delete_batch_from_db() is deprecated and will be removed from next release.");
+
        media_content_retvm_if(filter == NULL, MEDIA_CONTENT_ERROR_INVALID_PARAMETER, "Invalid filter");
 
        _filter = (filter_s*)filter;