[ACR-1120]Deprecate unused and doesn't work api image_util_transform_set_hardware_acc...

Change-Id: I7265d8b298d0ad7fe0a73fc9b923d0f66ba48651

diff --git a/include/image_util.h b/include/image_util.h
index 37f4771..b4ff3cf 100755 (executable)
--- a/include/image_util.h
+++ b/include/image_util.h
@@ -61,7 +61,7 @@ extern "C"
 int image_util_calculate_buffer_size(int width, int height, image_util_colorspace_e colorspace , unsigned int *size);
 
 /**
-* @brief Extracts representative color from an image buffer
+* @brief Extracts representative color from an image buffer.
 * @since_tizen 3.0
 * @remarks @a image_buffer should be RGB888 colorspace.
 *
@@ -116,6 +116,7 @@ int image_util_extract_color_from_memory(const unsigned char *image_buffer, int
 int image_util_transform_create(transformation_h *handle);
 
 /**
+* @deprecated Deprecated since 5.0.
 * @brief Sets the image util's accurate mode.
 * @since_tizen 2.3
 *
@@ -141,10 +142,10 @@ int image_util_transform_create(transformation_h *handle);
 * @see image_util_transform_create()
 * @see image_util_transform_destroy()
 */
-int image_util_transform_set_hardware_acceleration(transformation_h handle, bool mode);
+int image_util_transform_set_hardware_acceleration(transformation_h handle, bool mode) TIZEN_DEPRECATED_API;
 
 /**
-* @brief Sets the information of the converting
+* @brief Sets the information of the converting.
 * @since_tizen 2.3
 *
 * @param[in] handle The handle to image util transform
@@ -168,7 +169,7 @@ int image_util_transform_set_hardware_acceleration(transformation_h handle, bool
 int image_util_transform_set_colorspace(transformation_h handle, image_util_colorspace_e colorspace);
 
 /**
-* @brief Sets the information of the resizing
+* @brief Sets the information of the resizing.
 * @since_tizen 2.3
 *
 * @remarks image_util_transform_set_resolution and image_util_transform_set_crop_area can't do that at the same time.
@@ -194,7 +195,7 @@ int image_util_transform_set_colorspace(transformation_h handle, image_util_colo
 int image_util_transform_set_resolution(transformation_h handle, unsigned int width, unsigned int height);
 
 /**
-* @brief Sets the information of the rotating
+* @brief Sets the information of the rotating.
 * @since_tizen 2.3
 *
 * @param[in] handle The handle to image util transform
@@ -217,7 +218,7 @@ int image_util_transform_set_resolution(transformation_h handle, unsigned int wi
 int image_util_transform_set_rotation(transformation_h handle, image_util_rotation_e rotation);
 
 /**
-* @brief Sets the information of the cropping
+* @brief Sets the information of the cropping.
 * @since_tizen 2.3
 *
 * @remarks image_util_transform_set_resolution and image_util_transform_set_crop_area can't do that at the same time.
@@ -245,7 +246,7 @@ int image_util_transform_set_rotation(transformation_h handle, image_util_rotati
 int image_util_transform_set_crop_area(transformation_h handle, unsigned int start_x, unsigned int start_y, unsigned int end_x, unsigned int end_y);
 
 /**
-* @brief Gets the colorspace of the image buffer
+* @brief Gets the colorspace of the image buffer.
 * @since_tizen 2.3
 *
 * @param[in] handle The handle to image util transform
@@ -268,7 +269,7 @@ int image_util_transform_set_crop_area(transformation_h handle, unsigned int sta
 int image_util_transform_get_colorspace(transformation_h handle, image_util_colorspace_e *colorspace);
 
 /**
-* @brief Gets the resolution of the image buffer
+* @brief Gets the resolution of the image buffer.
 * @since_tizen 2.3
 *
 * @param[in] handle The handle to image util transform
@@ -292,7 +293,7 @@ int image_util_transform_get_colorspace(transformation_h handle, image_util_colo
 int image_util_transform_get_resolution(transformation_h handle, unsigned int *width, unsigned int *height);
 
 /**
-* @brief Gets the information of the rotating
+* @brief Gets the information of the rotating.
 * @since_tizen 2.3
 *
 * @param[in] handle The handle to image util transform
@@ -315,7 +316,7 @@ int image_util_transform_get_resolution(transformation_h handle, unsigned int *w
 int image_util_transform_get_rotation(transformation_h handle, image_util_rotation_e *rotation);
 
 /**
-* @brief Gets the information of the cropping
+* @brief Gets the information of the cropping.
 * @since_tizen 2.3
 *
 * @param[in] handle The handle to image util transform
@@ -341,7 +342,7 @@ int image_util_transform_get_rotation(transformation_h handle, image_util_rotati
 int image_util_transform_get_crop_area(transformation_h handle, unsigned int *start_x, unsigned int *start_y, unsigned int *end_x, unsigned int *end_y);
 
 /**
-* @brief Transform the image for given image util handle.
+* @brief Transforms the image for given image util handle.
 * @since_tizen 2.3
 *
 * @remarks If H/W acceleration is not set, transformation is done via S/W acceleration.
@@ -363,7 +364,6 @@ int image_util_transform_get_crop_area(transformation_h handle, unsigned int *st
 * @retval #IMAGE_UTIL_ERROR_PERMISSION_DENIED The application does not have the privilege to call this funtion
 *
 * @see image_util_transform_create()
-* @see image_util_transform_set_hardware_acceleration
 * @see image_util_transform_destroy()
 */
 int image_util_transform_run(transformation_h handle, media_packet_h src, image_util_transform_completed_cb callback, void *user_data);

diff --git a/src/image_util.c b/src/image_util.c
index e87ff9f..b82fad5 100755 (executable)
--- a/src/image_util.c
+++ b/src/image_util.c
@@ -335,6 +335,7 @@ int image_util_transform_set_hardware_acceleration(transformation_h handle, bool
 {
        transformation_s *_handle = (transformation_s *) handle;
 
+       image_util_warning("DEPRECATION WARNING: image_util_transform_set_hardware_acceleration() is deprecated and will be removed from next release.");
        image_util_debug("Set hardware_acceleration %d", mode);
 
        image_util_retvm_if((_handle == NULL), IMAGE_UTIL_ERROR_INVALID_PARAMETER, "Invalid Handle");