Merge "Sync to product code" into tizen

[platform/core/api/media-content.git] / include_product / media_image.h

diff --git a/include_product/media_image.h b/include_product/media_image.h
index 9dbd88c..01a687d 100755 (executable)
--- a/include_product/media_image.h
+++ b/include_product/media_image.h
@@ -54,7 +54,6 @@ extern "C" {
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  *
  * @see image_meta_destroy()
  */
@@ -74,7 +73,7 @@ int image_meta_clone(image_meta_h *dst, image_meta_h src);
  *         otherwise a negative error value
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  *
  * @pre Get a copy of image_meta handle by calling image_meta_clone().
  *
@@ -93,8 +92,8 @@ int image_meta_destroy(image_meta_h image);
  *         otherwise a negative error value
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
+ * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  */
 int image_meta_get_media_id(image_meta_h image, char **media_id);
 
@@ -110,7 +109,6 @@ int image_meta_get_media_id(image_meta_h image, char **media_id);
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  */
 int image_meta_get_width(image_meta_h image, int *width);
 
@@ -126,7 +124,6 @@ int image_meta_get_width(image_meta_h image, int *width);
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  */
 int image_meta_get_height(image_meta_h image, int *height);
 
@@ -142,7 +139,6 @@ int image_meta_get_height(image_meta_h image, int *height);
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  */
 int image_meta_get_orientation(image_meta_h image, media_content_orientation_e *orientation);
 
@@ -157,8 +153,8 @@ int image_meta_get_orientation(image_meta_h image, media_content_orientation_e *
  *         otherwise a negative error value
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
+ * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  */
 int image_meta_get_date_taken(image_meta_h image, char **date_taken);
 
@@ -177,7 +173,7 @@ int image_meta_get_date_taken(image_meta_h image, char **date_taken);
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY     Out of memory
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  */
 int image_meta_get_burst_id(image_meta_h image, char **burst_id);
 
@@ -211,7 +207,6 @@ int image_meta_get_exposure_time(image_meta_h image, char **exposure_time);
  *         otherwise a negative error value
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  *
  */
@@ -228,7 +223,6 @@ int image_meta_get_fnumber(image_meta_h image, double *fnumber);
  *         otherwise a negative error value
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE Successful
- * @retval #MEDIA_CONTENT_ERROR_OUT_OF_MEMORY Out of memory
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  *
  */
@@ -266,11 +260,11 @@ 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
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  */
 int image_meta_is_burst_shot(image_meta_h image, bool *is_burst_shot);
 
 /**
+ * @deprecated Deprecated since 4.0. This data cannot be saved to the file.
  * @brief Sets an orientation of the image.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -282,18 +276,15 @@ int image_meta_is_burst_shot(image_meta_h image, bool *is_burst_shot);
  *
  * @retval #MEDIA_CONTENT_ERROR_NONE              Successful
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
- *
- * @post image_meta_update_to_db()
  */
-int image_meta_set_orientation(image_meta_h image, media_content_orientation_e orientation);
+int image_meta_set_orientation(image_meta_h image, media_content_orientation_e orientation) TIZEN_DEPRECATED_API;
 
 /**
+ * @deprecated Deprecated since 4.0. Related setter functions are deprecated, therefore this function is not needed anymore.
  * @brief Updates the image to the media database.
  *
- * @details The function updates the given image meta in the media database. The function should be called after any change in image attributes, to be updated to the media
- *          database. For example, after using image_meta_set_orientation() for setting the orientation of the image, the image_meta_update_to_db() function should be called so as to update
- *          the given image attributes in the media database.
+ * @details The function updates the given image meta in the media database. \n
+ *               The function should be called after any change in image attributes, to be updated to the media database.
  *
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  *
@@ -319,9 +310,8 @@ int image_meta_set_orientation(image_meta_h image, media_content_orientation_e o
  * @pre This function requires opened connection to content service by media_content_connect().
  *
  * @see media_content_connect()
- * @see image_meta_set_orientation()
  */
-int image_meta_update_to_db(image_meta_h image);
+int image_meta_update_to_db(image_meta_h image) TIZEN_DEPRECATED_API;
 
 /**
  * @}