From 20a67247cbea739453489087660d542debd22bfa Mon Sep 17 00:00:00 2001 From: Jeongmo Yang Date: Wed, 12 Apr 2023 12:24:07 +0900 Subject: [PATCH] Update header file to fix issues from header checker - Reorder return values by priority - Add remarks and comments - Update description [Version] 0.4.103 [Issue Type] Update Change-Id: I96386e413f59d3c98e98c379a735a60da208e6a0 Signed-off-by: Jeongmo Yang --- include/camera.h | 570 ++++++++++++++++++++------------------- packaging/capi-media-camera.spec | 2 +- 2 files changed, 290 insertions(+), 282 deletions(-) diff --git a/include/camera.h b/include/camera.h index d9d35b9..aff7405 100644 --- a/include/camera.h +++ b/include/camera.h @@ -35,6 +35,10 @@ extern "C" { * @{ */ +/** + * @brief Tizen error class for camera. + * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + */ #define CAMERA_ERROR_CLASS TIZEN_ERROR_CAMERA | 0x00 /** @@ -282,7 +286,7 @@ typedef struct { unsigned char *data; /**< The RGB data pointer */ unsigned int size; /**< The size of RGB data */ } rgb_plane; /**< RGB plane frame data (Since 5.0) */ - } data; + } data; /**< The frame data */ } camera_preview_data_s; @@ -586,20 +590,20 @@ typedef enum { */ /** - * @brief Called when the camera state is changed. + * @brief Invoked when the camera state is changed. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] previous The previous state of the camera * @param[in] current The current state of the camera * @param[in] by_policy If @c true the state is changed by policy, otherwise @c false * @param[in] user_data The user data passed from the callback registration function * @pre camera_start_preview(), camera_start_capture() or camera_stop_preview() - * will invoke this callback if you register this callback using camera_set_state_changed_cb(). + * will invoke this callback if you set this callback using camera_set_state_changed_cb(). * @see camera_set_state_changed_cb() */ typedef void (*camera_state_changed_cb)(camera_state_e previous, camera_state_e current, bool by_policy, void *user_data); /** - * @brief Called when the camera device state is changed. + * @brief Invoked when the camera device state is changed. * @since_tizen 3.0 * @param[in] device The hardware camera type * @param[in] state The state of the camera device @@ -609,9 +613,9 @@ typedef void (*camera_state_changed_cb)(camera_state_e previous, camera_state_e typedef void (*camera_device_state_changed_cb)(camera_device_e device, camera_device_state_e state, void *user_data); /** - * @brief Called when the camera is interrupted by policy. + * @brief Invoked when the camera is interrupted by policy. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @remarks This callback is called after interrupt handling is completed. + * @remarks This callback is invoked after interrupt handling is completed. * @param[in] policy The policy that interrupted the camera * @param[in] previous The previous state of the camera * @param[in] current The current state of the camera @@ -621,9 +625,9 @@ typedef void (*camera_device_state_changed_cb)(camera_device_e device, camera_de typedef void (*camera_interrupted_cb)(camera_policy_e policy, camera_state_e previous, camera_state_e current, void *user_data); /** - * @brief Called when the camera interrupt is started by policy. + * @brief Invoked when the camera interrupt is started by policy. * @since_tizen 4.0 - * @remarks This callback is called before interrupt handling is started. + * @remarks This callback is invoked before interrupt handling is started. * @param[in] policy The policy that is interrupting the camera * @param[in] state The current state of the camera * @param[in] user_data The user data passed from the callback registration function @@ -632,7 +636,7 @@ typedef void (*camera_interrupted_cb)(camera_policy_e policy, camera_state_e pre typedef void (*camera_interrupt_started_cb)(camera_policy_e policy, camera_state_e state, void *user_data); /** - * @brief Called when the camera focus state is changed. + * @brief Invoked when the camera focus state is changed. * @details When the camera auto focus completes or a change to the focus state occurs, * this callback is invoked. \n \n * Changes of focus state are as follows: \n @@ -642,7 +646,7 @@ typedef void (*camera_interrupt_started_cb)(camera_policy_e policy, camera_state * * @param[in] state The current state of the auto-focus * @param[in] user_data The user data passed from the callback registration function - * @pre camera_start_focusing() will invoke this callback if you register it using camera_set_focus_changed_cb(). + * @pre camera_start_focusing() will invoke this callback if you set it using camera_set_focus_changed_cb(). * @see camera_set_focus_changed_cb() * @see camera_unset_focus_changed_cb() * @see camera_start_focusing() @@ -651,16 +655,16 @@ typedef void (*camera_interrupt_started_cb)(camera_policy_e policy, camera_state typedef void (*camera_focus_changed_cb)(camera_focus_state_e state, void *user_data); /** - * @brief Called to register for notifications about delivering a copy of the new preview frame when every preview frame is displayed. + * @brief Invoked for notifications about delivering a copy of the new preview frame when every preview frame is displayed. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * - * @remarks This function is issued in the context of internal framework so the UI update code should not be directly invoked.\n - * If the camera is used as a recorder then this callback function won't be called. + * @remarks This function is invoked in the context of internal framework so the UI update code should not be directly called.\n + * If the camera is used as a recorder then this callback function won't be invoked. * @remarks The @a frame should not be released and it's available until the callback returns. * * @param[in] frame The reference pointer to preview stream data * @param[in] user_data The user data passed from the callback registration function - * @pre camera_start_preview() will invoke this callback function if you register this callback using camera_set_preview_cb(). + * @pre camera_start_preview() will invoke this callback function if you set this callback using camera_set_preview_cb(). * @see camera_start_preview() * @see camera_set_preview_cb() * @see camera_unset_preview_cb() @@ -668,16 +672,16 @@ typedef void (*camera_focus_changed_cb)(camera_focus_state_e state, void *user_d typedef void (*camera_preview_cb)(camera_preview_data_s *frame, void *user_data); /** - * @brief Called to register for notifications about delivering media packet when every preview frame is displayed. + * @brief Invoked for notifications about delivering media packet when every preview frame is displayed. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * - * @remarks This function is issued in the context of internal framework so the UI update code should not be directly invoked.\n - * If the camera is used as a recorder then this callback function won't be called.\n + * @remarks This function is invoked in the context of internal framework so the UI update code should not be directly called.\n + * If the camera is used as a recorder then this callback function won't be invoked.\n * and the packet should be released by media_packet_destroy() after use. * * @param[in] pkt Reference pointer to media packet * @param[in] user_data The user data passed from the callback registration function - * @pre camera_start_preview() will invoke this callback function if you register this callback using camera_set_media_packet_preview_cb(). + * @pre camera_start_preview() will invoke this callback function if you set this callback using camera_set_media_packet_preview_cb(). * @see camera_start_preview() * @see camera_set_media_packet_preview_cb() * @see camera_unset_media_packet_preview_cb() @@ -685,17 +689,17 @@ typedef void (*camera_preview_cb)(camera_preview_data_s *frame, void *user_data) typedef void (*camera_media_packet_preview_cb)(media_packet_h pkt, void *user_data); /** - * @brief Called to get information about image data taken by the camera once per frame while capturing. + * @brief Invoked to get information about image data taken by the camera once per frame while capturing. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * - * @remarks This function is issued in the context of internal framework so the UI update code should not be directly invoked. - * You must not call camera_start_preview() within this callback. - * + * @remarks This function is invoked in the context of internal framework so the UI update code should not be directly called. + * You must not call camera_start_preview() within this callback. \n + * The @a image, @a postview and @a thumbnail should not be released and it can be used only in the callback. To use outside, make a copy. * @param[in] image The image data of the captured picture * @param[in] postview The image data of the postview * @param[in] thumbnail The image data of the thumbnail (it should be @c NULL if the available thumbnail data does not exist) * @param[in] user_data The user data passed from the callback registration function - * @pre camera_start_capture() or camera_start_continuous_capture() will invoke this callback function if it is registered using camera_start_capture() or camera_start_continuous_capture(). + * @pre camera_start_capture() or camera_start_continuous_capture() will invoke this callback function if it is set using camera_start_capture() or camera_start_continuous_capture(). * @see camera_start_capture() * @see camera_start_continuous_capture() * @see camera_capture_completed_cb() @@ -703,14 +707,14 @@ typedef void (*camera_media_packet_preview_cb)(media_packet_h pkt, void *user_da typedef void (*camera_capturing_cb)(camera_image_data_s *image, camera_image_data_s *postview, camera_image_data_s *thumbnail, void *user_data); /** - * @brief Called when the camera capturing completes. + * @brief Invoked when the camera capturing completes. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * - * @remarks The callback is called after camera_capturing_cb() is completed.\n + * @remarks The callback is invoked after camera_capturing_cb() is completed.\n * If you want to show the user a preview after capturing is finished, \n * an application can use camera_start_preview() after calling this callback. * @param[in] user_data The user data passed from the callback registration function - * @pre This callback function is invoked if it is registered using camera_start_capture() or camera_start_continuous_capture(). + * @pre This callback function is invoked if it is set using camera_start_capture() or camera_start_continuous_capture(). * @see camera_start_capture() * @see camera_start_continuous_capture() * @see camera_capturing_cb() @@ -718,7 +722,7 @@ typedef void (*camera_capturing_cb)(camera_image_data_s *image, camera_image_dat typedef void (*camera_capture_completed_cb)(void *user_data); /** - * @brief Called when an error occurs. + * @brief Invoked when an error occurs. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * * @remarks This callback informs about a critical error situation.\n @@ -730,15 +734,16 @@ typedef void (*camera_capture_completed_cb)(void *user_data); * @param[in] error The error code * @param[in] current_state The current state of the camera * @param[in] user_data The user data passed from the callback registration function - * @pre This callback function is invoked if it is registered using camera_set_error_cb(). + * @pre This callback function is invoked if it is set using camera_set_error_cb(). * @see camera_set_error_cb() * @see camera_unset_error_cb() */ typedef void (*camera_error_cb)(camera_error_e error, camera_state_e current_state, void *user_data); /** - * @brief Called when a face is detected in the preview frame. + * @brief Invoked when a face is detected in the preview frame. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif + * @remarks The @a faces should not be released and it can be used only in the callback. To use outside, make a copy. * @param[in] faces The detected face array * @param[in] count The length of the array * @param[in] user_data The user data passed from the callback registration function @@ -747,8 +752,9 @@ typedef void (*camera_error_cb)(camera_error_e error, camera_state_e current_sta typedef void (*camera_face_detected_cb)(camera_detected_face_s *faces, int count, void *user_data); /** - * @brief Called when the connection state of a camera device was changed. + * @brief Invoked when the connection state of a camera device was changed. * @since_tizen 7.0 + * @remarks The @a device should not be released and it can be used only in the callback. To use outside, make a copy. * @param[in] device The camera device * @param[in] is_connected The state of device connection: (@c true = connected, @c false = disconnected) * @param[in] user_data The user data passed from the callback registration function @@ -758,12 +764,13 @@ typedef void (*camera_face_detected_cb)(camera_detected_face_s *faces, int count typedef void (*camera_device_connection_changed_cb)(camera_device_s *device, bool is_connected, void *user_data); /** - * @brief Called when the extra preview frame is delivered from the camera device. + * @brief Invoked when the extra preview frame is delivered from the camera device. * @since_tizen 7.0 + * @remarks The @a frame should not be released and it can be used only in the callback. To use outside, make a copy. * @param[in] frame The reference pointer to extra preview stream data * @param[in] stream_id The ID of the preview stream * @param[in] user_data The user data passed from the callback registration function - * @pre camera_start_preview() will invoke this callback function if you register this callback using camera_set_extra_preview_cb(). + * @pre camera_start_preview() will invoke this callback function if you set this callback using camera_set_extra_preview_cb(). * @see camera_start_preview() * @see camera_set_extra_preview_cb() * @see camera_unset_extra_preview_cb() @@ -780,7 +787,7 @@ typedef void (*camera_extra_preview_cb)(camera_preview_data_s *frame, int stream */ /** - * @brief Called once for each supported preview resolution. + * @brief Invoked once for each supported preview resolution. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] width The preview image width * @param[in] height The preview image height @@ -792,7 +799,7 @@ typedef void (*camera_extra_preview_cb)(camera_preview_data_s *frame, int stream typedef bool (*camera_supported_preview_resolution_cb)(int width, int height, void *user_data); /** - * @brief Called once for each supported capture resolution. + * @brief Invoked once for each supported capture resolution. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] width The capture resolution width * @param[in] height The capture resolution height @@ -804,7 +811,7 @@ typedef bool (*camera_supported_preview_resolution_cb)(int width, int height, vo typedef bool (*camera_supported_capture_resolution_cb)(int width, int height, void *user_data); /** - * @brief Called once for the pixel format of each supported capture format. + * @brief Invoked once for the pixel format of each supported capture format. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] format The supported pixel format * @param[in] user_data The user data passed from the foreach function @@ -815,7 +822,7 @@ typedef bool (*camera_supported_capture_resolution_cb)(int width, int height, vo typedef bool (*camera_supported_capture_format_cb)(camera_pixel_format_e format, void *user_data); /** - * @brief Called once for the pixel format of each supported preview format. + * @brief Invoked once for the pixel format of each supported preview format. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] format The supported preview data format * @param[in] user_data The user data passed from the foreach function @@ -826,8 +833,9 @@ typedef bool (*camera_supported_capture_format_cb)(camera_pixel_format_e format, typedef bool (*camera_supported_preview_format_cb)(camera_pixel_format_e format, void *user_data); /** - * @brief Called once for the each supported device. + * @brief Invoked once for the each supported device. * @since_tizen 7.0 + * @remarks The @a device should not be released and it can be used only in the callback. To use outside, make a copy. * @param[in] device The camera device * @param[in] user_data The user data passed from the foreach function * @return @c true to continue with the next iteration of the loop, \n otherwise @c false to break out of the loop @@ -860,10 +868,10 @@ typedef bool (*camera_supported_device_cb)(camera_device_s *device, void *user_d * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_OUT_OF_MEMORY Out of memory * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @post If it succeeds, the camera state will be #CAMERA_STATE_CREATED. * * @see camera_destroy() @@ -903,10 +911,10 @@ int camera_change_device(camera_h camera, camera_device_e device); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @see camera_create() * @see camera_create_network() */ @@ -970,7 +978,7 @@ int camera_device_manager_deinitialize(camera_device_manager_h manager); * @brief Retrieves all supported devices by invoking the callback function once for each supported device. * @since_tizen 7.0 * @param[in] manager The handle to the camera device manager - * @param[in] callback The callback function to register + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful @@ -994,12 +1002,12 @@ int camera_device_manager_foreach_supported_device(camera_device_manager_h manag */ /** - * @brief Adds a callback function to be called when the connection state of camera device is changed. + * @brief Adds a callback function to be invoked when the connection state of camera device is changed. * @since_tizen 7.0 * @param[in] manager The handle to the camera device manager - * @param[in] callback The callback function to register + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function - * @param[out] cb_id The id of registered callback + * @param[out] cb_id The id of added callback * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported @@ -1012,10 +1020,10 @@ int camera_device_manager_foreach_supported_device(camera_device_manager_h manag int camera_device_manager_add_device_connection_changed_cb(camera_device_manager_h manager, camera_device_connection_changed_cb callback, void *user_data, int *cb_id); /** - * @brief Removes the callback function. + * @brief Removes the device connection changed callback function. * @since_tizen 7.0 * @param[in] manager The handle to the camera device manager - * @param[in] cb_id The id of registered callback + * @param[in] cb_id The id of added callback * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported @@ -1035,20 +1043,20 @@ int camera_device_manager_remove_device_connection_changed_cb(camera_device_mana * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state * @retval #CAMERA_ERROR_RESOURCE_CONFLICT Resource conflict error * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation * @retval #CAMERA_ERROR_DEVICE_BUSY The device is being used in another application or is performing other operations * @retval #CAMERA_ERROR_DEVICE_NOT_FOUND No camera device - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_CAPTURED.\n * You must set the display handle. \n * If needed, modify preview FPS(camera_attr_set_preview_fps()), * preview resolution(camera_set_preview_resolution()), or preview format(camera_set_preview_format()). * @post If it succeeds, the camera state will be #CAMERA_STATE_PREVIEW.\n - * camera_preview_cb() will be called when preview image data becomes available. + * camera_preview_cb() will be invoked when preview image data becomes available. * * @see camera_stop_preview() * @see camera_set_display() @@ -1075,10 +1083,10 @@ int camera_start_preview(camera_h camera); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_PREVIEW. * @post The camera state will be #CAMERA_STATE_CREATED. @@ -1106,10 +1114,10 @@ int camera_stop_preview(camera_h camera); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_PREVIEW. \n * If needed, modify capture resolution(camera_set_capture_resolution()), @@ -1150,10 +1158,10 @@ int camera_start_capture(camera_h camera, camera_capturing_cb capturing_cb, came * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post If it succeeds the camera state will be #CAMERA_STATE_CAPTURED. * @@ -1175,10 +1183,10 @@ int camera_start_continuous_capture(camera_h camera, int count, int interval, ca * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_PREVIEW. * @@ -1195,8 +1203,8 @@ int camera_stop_continuous_capture(camera_h camera); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_create() * @see camera_start_preview() @@ -1217,10 +1225,10 @@ int camera_get_state(camera_h camera, camera_state_e *state); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_PREVIEW. * @post The camera focus state will be #CAMERA_FOCUS_STATE_ONGOING. @@ -1241,10 +1249,10 @@ int camera_start_focusing(camera_h camera, bool continuous); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_PREVIEW. * @@ -1270,10 +1278,10 @@ int camera_cancel_focusing(camera_h camera); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED. * @@ -1295,9 +1303,9 @@ int camera_set_display(camera_h camera, camera_display_type_e type, camera_displ * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @@ -1317,8 +1325,8 @@ int camera_set_preview_resolution(camera_h camera, int width, int height); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_set_preview_resolution() * @see camera_foreach_supported_preview_resolution() @@ -1336,8 +1344,8 @@ int camera_get_preview_resolution(camera_h camera, int *width, int *height); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_set_preview_resolution() * @see camera_foreach_supported_preview_resolution() @@ -1353,7 +1361,7 @@ int camera_get_recommended_preview_resolution(camera_h camera, int *width, int * * This callback will be invoked when the face is detected in the preview frame.\n * Internally it starts continuous focus and focusing on the detected face.\n * When face detection is running, the camera_start_focusing(), camera_cancel_focusing(), camera_attr_set_af_mode(), camera_attr_set_af_area(), camera_attr_set_exposure_mode(), and camera_attr_set_whitebalance() settings are ignored.\n - * If camera_stop_preview() is invoked, face detection is stopped and then preview is resumed using camera_start_preview(), this method should be called again to resume face detection. + * If camera_stop_preview() is called, face detection is stopped and then preview is resumed using camera_start_preview(), this should be called again to resume face detection. * @param[in] camera The handle to the camera * @param[in] callback The callback to notify face detection * @param[in] user_data The user data to be passed to the callback function @@ -1361,10 +1369,10 @@ int camera_get_recommended_preview_resolution(camera_h camera, int *width, int * * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Not preview state * @retval #CAMERA_ERROR_INVALID_OPERATION Not supported this feature - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be #CAMERA_STATE_PREVIEW. * @@ -1384,8 +1392,8 @@ int camera_start_face_detection(camera_h camera, camera_face_detected_cb callbac * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre This should be called after face detection is started. * @@ -1412,8 +1420,8 @@ int camera_stop_face_detection(camera_h camera); * @return @c true on supported, otherwise false * @exception #CAMERA_ERROR_NONE Successful * @exception #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @exception #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * */ bool camera_is_supported_continuous_capture(camera_h camera); @@ -1428,8 +1436,8 @@ bool camera_is_supported_continuous_capture(camera_h camera); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_supported_preview_resolution_cb() repeatedly to retrieve each supported preview resolution. * @@ -1459,10 +1467,10 @@ int camera_foreach_supported_preview_resolution(camera_h camera, camera_supporte * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state * @retval #CAMERA_ERROR_INVALID_OPERATION Display type is incorrect - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_start_preview() * @see camera_get_display_rotation() @@ -1479,8 +1487,8 @@ int camera_set_display_rotation(camera_h camera, camera_rotation_e rotation); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_set_display_rotation() */ @@ -1496,10 +1504,10 @@ int camera_get_display_rotation(camera_h camera, camera_rotation_e *rotation); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state * @retval #CAMERA_ERROR_INVALID_OPERATION Display type is incorrect - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_get_display_flip() */ @@ -1515,8 +1523,8 @@ int camera_set_display_flip(camera_h camera, camera_flip_e flip); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_set_display_flip() */ @@ -1533,8 +1541,8 @@ int camera_get_display_flip(camera_h camera, camera_flip_e *flip); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_is_display_visible() */ @@ -1551,8 +1559,8 @@ int camera_set_display_visible(camera_h camera, bool visible); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_set_display_visible() */ @@ -1569,8 +1577,8 @@ int camera_is_display_visible(camera_h camera, bool *visible); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_get_display_mode() */ @@ -1587,8 +1595,8 @@ int camera_set_display_mode(camera_h camera, camera_display_mode_e mode); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_set_display_mode() */ @@ -1638,9 +1646,9 @@ int camera_get_display_reuse_hint(camera_h camera, bool *hint); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_start_capture() @@ -1658,8 +1666,8 @@ int camera_set_capture_resolution(camera_h camera, int width, int height); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_set_capture_resolution() * @see camera_foreach_supported_capture_resolution() @@ -1680,13 +1688,13 @@ int camera_get_capture_resolution(camera_h camera, int *width, int *height); * * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera - * @param[in] callback The callback function to register + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_supported_capture_resolution_cb() repeatedly to retrieve each supported capture resolution. * @see camera_set_capture_resolution() @@ -1709,14 +1717,14 @@ int camera_foreach_supported_capture_resolution(camera_h camera, camera_supporte * * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @remarks This function should be called before capturing (see camera_start_capture()). - * @param[in] camera The handle to the camera - * @param[out] format The format of the image to be captured + * @param[in] camera The handle to the camera + * @param[in] format The format of the image to be captured * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_start_capture() @@ -1734,8 +1742,8 @@ int camera_set_capture_format(camera_h camera, camera_pixel_format_e format); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_set_capture_format() * @see camera_foreach_supported_capture_format() @@ -1761,8 +1769,8 @@ int camera_get_capture_format(camera_h camera, camera_pixel_format_e *format); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_supported_capture_format_cb() repeatedly to retrieve each supported capture format. * @see camera_set_capture_format() @@ -1789,9 +1797,9 @@ int camera_foreach_supported_capture_format(camera_h camera, camera_supported_ca * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED. * @see camera_start_preview() @@ -1808,8 +1816,8 @@ int camera_set_preview_format(camera_h camera, camera_pixel_format_e format); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_set_preview_format() * @see camera_foreach_supported_preview_format() @@ -1824,8 +1832,8 @@ int camera_get_preview_format(camera_h camera, camera_pixel_format_e *format); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected */ int camera_get_facing_direction(camera_h camera, camera_facing_direction_e *facing_direction); @@ -1838,18 +1846,18 @@ int camera_get_facing_direction(camera_h camera, camera_facing_direction_e *faci * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @see camera_attr_set_flash_mode() * @see camera_attr_get_flash_mode() */ int camera_get_flash_state(camera_device_e device, camera_flash_state_e *state); /** - * @brief Sets a callback function to be called for extra preview frames. + * @brief Sets a callback function to be invoked for extra preview frames. * @since_tizen 7.0 * @param[in] camera The handle to the camera - * @param[in] callback The callback function to be registered + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful @@ -1864,7 +1872,7 @@ int camera_get_flash_state(camera_device_e device, camera_flash_state_e *state); int camera_set_extra_preview_cb(camera_h camera, camera_extra_preview_cb callback, void *user_data); /** - * @brief Unsets the callback function. + * @brief Unsets the extra preview callback function. * @since_tizen 7.0 * @param[in] camera The handle to the camera * @return @c 0 on success, otherwise a negative error value @@ -1940,8 +1948,8 @@ int camera_get_extra_preview_stream_format(camera_h camera, int stream_id, camer * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_supported_preview_format_cb() repeatedly to retrieve each supported preview format. * @see camera_set_preview_format() @@ -1959,8 +1967,8 @@ int camera_foreach_supported_preview_format(camera_h camera, camera_supported_pr * @return @c true if supported, otherwise @c false * @exception #CAMERA_ERROR_NONE Successful * @exception #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @exception #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @see camera_start_face_detection() * @see camera_stop_face_detection() */ @@ -1976,8 +1984,8 @@ bool camera_is_supported_face_detection(camera_h camera); * @return @c true if supported, otherwise @c false * @exception #CAMERA_ERROR_NONE Successful * @exception #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @exception #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter */ bool camera_is_supported_zero_shutter_lag(camera_h camera); @@ -1991,8 +1999,8 @@ bool camera_is_supported_zero_shutter_lag(camera_h camera); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected */ int camera_get_device_count(camera_h camera, int *device_count); @@ -2006,8 +2014,8 @@ int camera_get_device_count(camera_h camera, int *device_count); * @return @c true if supported, otherwise @c false * @exception #CAMERA_ERROR_NONE Successful * @exception #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @exception #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * */ bool camera_is_supported_media_packet_preview_cb(camera_h camera); @@ -2034,27 +2042,27 @@ bool camera_is_supported_extra_preview(camera_h camera); */ /** - * @brief Registers a callback function to be called once per frame when previewing. + * @brief Sets a callback function to be invoked once per frame when previewing. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @remarks This callback does not work in the video recorder mode.\n * Before 4.0, the only allowed state for calling this function was #CAMERA_STATE_CREATED.\n * Since 4.0, #CAMERA_STATE_PREVIEW has been added as an allowed state,\n - * so that this function could be called before previewing or even while previewing.\n - * A registered callback is called on the internal thread of the camera.\n - * A video frame can be retrieved using a registered callback,\n - * and the buffer is only available in a registered callback.\n - * Since tizen 3.0, if you change the buffer in a registered callback,\n + * so that this function could be invoked before previewing or even while previewing.\n + * A @a callback is invoked on the internal thread of the camera.\n + * A video frame can be retrieved using a @a callback,\n + * and the buffer is only available in a @a callback.\n + * Since tizen 3.0, if you change the buffer in a @a callback,\n * it could not be displayed on the device in case of copied buffer.\n * and if camera_is_supported_media_packet_preview_cb() returns false,\n * it's copied buffer case. * @param[in] camera The handle to the camera - * @param[in] callback The callback function to be registered + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre Before 4.0 : The camera state must be set to #CAMERA_STATE_CREATED.\n * Since 4.0 : The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. @@ -2065,37 +2073,37 @@ bool camera_is_supported_extra_preview(camera_h camera); int camera_set_preview_cb(camera_h camera, camera_preview_cb callback, void *user_data); /** - * @brief Unregisters the callback function. + * @brief Unsets the preview callback function. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_set_preview_cb() */ int camera_unset_preview_cb(camera_h camera); /** - * @brief Registers a media packet callback function to be called once per frame when previewing. + * @brief Sets a media packet callback function to be invoked once per frame when previewing. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @remarks This callback does not work in video recorder mode.\n * This function should be called before previewing (see camera_start_preview())\n - * A registered callback is called on the internal thread of the camera.\n - * A video frame can be retrieved using a registered callback as a media packet.\n + * A @a callback is invoked on the internal thread of the camera.\n + * A video frame can be retrieved using a @a callback as a media packet.\n * The callback function holds the same buffer that will be drawn on the display device.\n - * So if you change the media packet in a registered callback, it will be displayed on the device\n + * So if you change the media packet in a callback, it will be displayed on the device\n * and the media packet is available until it's destroyed by media_packet_destroy(). * @param[in] camera The handle to the camera - * @param[in] callback The callback function to be registered + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera's state should be #CAMERA_STATE_CREATED. * @see camera_start_preview() @@ -2105,30 +2113,30 @@ int camera_unset_preview_cb(camera_h camera); int camera_set_media_packet_preview_cb(camera_h camera, camera_media_packet_preview_cb callback, void *user_data); /** - * @brief Unregisters the media packet callback function. + * @brief Unsets the media packet callback function. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_set_media_packet_preview_cb() */ int camera_unset_media_packet_preview_cb(camera_h camera); /** - * @brief Registers a callback function to be called when the camera state changes. + * @brief Sets a callback function to be invoked when the camera state changes. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera - * @param[in] callback The callback function to register + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function will invoke camera_state_changed_cb() when the camera state changes. * @see camera_unset_state_changed_cb() @@ -2137,30 +2145,30 @@ int camera_unset_media_packet_preview_cb(camera_h camera); int camera_set_state_changed_cb(camera_h camera, camera_state_changed_cb callback, void *user_data); /** - * @brief Unregisters the callback function. + * @brief Unsets the state changed callback function. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_set_state_changed_cb() */ int camera_unset_state_changed_cb(camera_h camera); /** - * @brief Registers a callback function to be called when the camera is interrupted by policy. + * @brief Sets a callback function to be invoked when the camera is interrupted by policy. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera - * @param[in] callback The callback function to register + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_unset_interrupted_cb() * @see camera_interrupted_cb() @@ -2168,24 +2176,24 @@ int camera_unset_state_changed_cb(camera_h camera); int camera_set_interrupted_cb(camera_h camera, camera_interrupted_cb callback, void *user_data); /** - * @brief Unregisters the callback function. + * @brief Unsets the interrupted callback function. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_set_interrupted_cb() */ int camera_unset_interrupted_cb(camera_h camera); /** - * @brief Registers a callback function to be called when the camera interrupt is started by policy. + * @brief Sets a callback function to be invoked when the camera interrupt is started by policy. * @since_tizen 4.0 * @param[in] camera The handle to the camera - * @param[in] callback The callback function to register + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful @@ -2196,7 +2204,7 @@ int camera_unset_interrupted_cb(camera_h camera); int camera_set_interrupt_started_cb(camera_h camera, camera_interrupt_started_cb callback, void *user_data); /** - * @brief Unregisters the callback function. + * @brief Unsets the interrupt started callback function. * @since_tizen 4.0 * @param[in] camera The handle to the camera * @return @c 0 on success, otherwise a negative error value @@ -2207,16 +2215,16 @@ int camera_set_interrupt_started_cb(camera_h camera, camera_interrupt_started_cb int camera_unset_interrupt_started_cb(camera_h camera); /** - * @brief Registers a callback function to be called when the auto-focus state changes. + * @brief Sets a callback function to be invoked when the auto-focus state changes. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera - * @param[in] callback The callback function to register + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function will invoke camera_focus_changed_cb() when the auto-focus state changes. * @see camera_start_focusing() @@ -2227,21 +2235,21 @@ int camera_unset_interrupt_started_cb(camera_h camera); int camera_set_focus_changed_cb(camera_h camera, camera_focus_changed_cb callback, void *user_data); /** - * @brief Unregisters the callback function. + * @brief Unsets the focus changed callback function. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_set_focus_changed_cb() */ int camera_unset_focus_changed_cb(camera_h camera); /** - * @brief Registers a callback function to be called when an asynchronous operation error occurs. + * @brief Sets a callback function to be invoked when an asynchronous operation error occurs. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @remarks This callback informs about a critical error situation.\n * When this callback is invoked, the user should release the resource and terminate the application.\n @@ -2250,13 +2258,13 @@ int camera_unset_focus_changed_cb(camera_h camera); * #CAMERA_ERROR_INVALID_OPERATION,\n * #CAMERA_ERROR_OUT_OF_MEMORY. * @param[in] camera The handle to the camera - * @param[in] callback The callback function to register + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function will invoke camera_error_cb() when an asynchronous operation error occurs. @@ -2266,14 +2274,14 @@ int camera_unset_focus_changed_cb(camera_h camera); int camera_set_error_cb(camera_h camera, camera_error_cb callback, void *user_data); /** - * @brief Unregisters the callback function. + * @brief Unsets the error callback function. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_set_error_cb() */ @@ -2293,11 +2301,11 @@ int camera_unset_error_cb(camera_h camera); int camera_get_device_state(camera_device_e device, camera_device_state_e *state); /** - * @brief Registers a callback function to be called when the camera device state changes. + * @brief Adds a callback function to be invoked when the camera device state changes. * @since_tizen 3.0 - * @param[in] callback The callback function to register + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function - * @param[out] cb_id The id of registered callback + * @param[out] cb_id The id of added callback * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported @@ -2311,9 +2319,9 @@ int camera_get_device_state(camera_device_e device, camera_device_state_e *state int camera_add_device_state_changed_cb(camera_device_state_changed_cb callback, void *user_data, int *cb_id); /** - * @brief Unregisters the callback function. + * @brief Removes the device state changed callback function. * @since_tizen 3.0 - * @param[in] cb_id The id of registered callback + * @param[in] cb_id The id of added callback * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported @@ -2333,7 +2341,7 @@ int camera_remove_device_state_changed_cb(int cb_id); */ /** - * @brief Called to get each supported auto-focus mode. + * @brief Invoked to get each supported auto-focus mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] mode The supported auto-focus mode * @param[in] user_data The user data passed from the foreach function @@ -2344,7 +2352,7 @@ int camera_remove_device_state_changed_cb(int cb_id); typedef bool (*camera_attr_supported_af_mode_cb)(camera_attr_af_mode_e mode, void *user_data); /** - * @brief Called to get each supported exposure mode. + * @brief Invoked to get each supported exposure mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] mode The supported exposure mode * @param[in] user_data The user data passed from the foreach function @@ -2356,7 +2364,7 @@ typedef bool (*camera_attr_supported_af_mode_cb)(camera_attr_af_mode_e mode, voi typedef bool (*camera_attr_supported_exposure_mode_cb)(camera_attr_exposure_mode_e mode, void *user_data); /** - * @brief Called to get each supported ISO mode. + * @brief Invoked to get each supported ISO mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] iso The supported ISO mode * @param[in] user_data The user data passed from the foreach function @@ -2367,7 +2375,7 @@ typedef bool (*camera_attr_supported_exposure_mode_cb)(camera_attr_exposure_mode typedef bool (*camera_attr_supported_iso_cb)(camera_attr_iso_e iso, void *user_data); /** - * @brief Called to get each supported white balance. + * @brief Invoked to get each supported white balance. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] wb The supported white balance mode * @param[in] user_data The user data passed from the foreach function @@ -2379,7 +2387,7 @@ typedef bool (*camera_attr_supported_iso_cb)(camera_attr_iso_e iso, void *user_d typedef bool (*camera_attr_supported_whitebalance_cb)(camera_attr_whitebalance_e wb, void *user_data); /** - * @brief Called to get each supported effect mode. + * @brief Invoked to get each supported effect mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] effect The supported effect mode * @param[in] user_data The user data passed from the foreach function @@ -2390,7 +2398,7 @@ typedef bool (*camera_attr_supported_whitebalance_cb)(camera_attr_whitebalance_e typedef bool (*camera_attr_supported_effect_cb)(camera_attr_effect_mode_e effect, void *user_data); /** - * @brief Called to get each supported scene mode. + * @brief Invoked to get each supported scene mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] mode The supported scene mode * @param[in] user_data The user data passed from the foreach function @@ -2402,7 +2410,7 @@ typedef bool (*camera_attr_supported_effect_cb)(camera_attr_effect_mode_e effect typedef bool (*camera_attr_supported_scene_mode_cb)(camera_attr_scene_mode_e mode, void *user_data); /** - * @brief Called to get each supported flash mode. + * @brief Invoked to get each supported flash mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] mode The supported flash mode * @param[in] user_data The user data passed from the foreach function @@ -2413,7 +2421,7 @@ typedef bool (*camera_attr_supported_scene_mode_cb)(camera_attr_scene_mode_e mod typedef bool (*camera_attr_supported_flash_mode_cb)(camera_attr_flash_mode_e mode, void *user_data); /** - * @brief Called to get each supported FPS mode. + * @brief Invoked to get each supported FPS mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] fps The supported FPS mode * @param[in] user_data The user data passed from the foreach function @@ -2424,7 +2432,7 @@ typedef bool (*camera_attr_supported_flash_mode_cb)(camera_attr_flash_mode_e mod typedef bool (*camera_attr_supported_fps_cb)(camera_attr_fps_e fps, void *user_data); /** - * @brief Called to get each supported stream flip mode. + * @brief Invoked to get each supported stream flip mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] flip The supported stream flip mode * @param[in] user_data The user data passed from the foreach function @@ -2435,7 +2443,7 @@ typedef bool (*camera_attr_supported_fps_cb)(camera_attr_fps_e fps, void *user_d typedef bool (*camera_attr_supported_stream_flip_cb)(camera_flip_e flip, void *user_data); /** - * @brief Called to get each supported stream rotation mode. + * @brief Invoked to get each supported stream rotation mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] rotation The supported stream rotation mode * @param[in] user_data The user data passed from the foreach function @@ -2446,7 +2454,7 @@ typedef bool (*camera_attr_supported_stream_flip_cb)(camera_flip_e flip, void *u typedef bool (*camera_attr_supported_stream_rotation_cb)(camera_rotation_e rotation, void *user_data); /** - * @brief Called to get each supported theater mode. + * @brief Invoked to get each supported theater mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] mode The supported theater mode * @param[in] user_data The user data passed from the foreach function @@ -2457,7 +2465,7 @@ typedef bool (*camera_attr_supported_stream_rotation_cb)(camera_rotation_e rotat typedef bool (*camera_attr_supported_theater_mode_cb)(camera_attr_theater_mode_e mode, void *user_data); /** - * @brief Called to get each supported PTZ (Pan Tilt Zoom) type. + * @brief Invoked to get each supported PTZ (Pan Tilt Zoom) type. * @since_tizen 3.0 * @param[in] type The supported ptz type * @param[in] user_data The user data passed from the foreach function @@ -2486,9 +2494,9 @@ typedef bool (*camera_attr_supported_ptz_type_cb)(camera_attr_ptz_type_e type, v * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED. * @see camera_start_preview() @@ -2505,8 +2513,8 @@ int camera_attr_set_preview_fps(camera_h camera, camera_attr_fps_e fps); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_preview_fps() * @see camera_attr_foreach_supported_fps() @@ -2522,8 +2530,8 @@ int camera_attr_get_preview_fps(camera_h camera, camera_attr_fps_e *fps); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_get_extra_preview_bitrate() */ @@ -2538,8 +2546,8 @@ int camera_attr_set_extra_preview_bitrate(camera_h camera, int stream_id, int bi * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_extra_preview_bitrate() */ @@ -2556,8 +2564,8 @@ int camera_attr_get_extra_preview_bitrate(camera_h camera, int stream_id, int *b * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_get_extra_preview_gop_interval() */ @@ -2572,8 +2580,8 @@ int camera_attr_set_extra_preview_gop_interval(camera_h camera, int stream_id, i * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_extra_preview_gop_interval() */ @@ -2588,8 +2596,8 @@ int camera_attr_get_extra_preview_gop_interval(camera_h camera, int stream_id, i * @param[out] rotation The rotation of preview frame * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected */ int camera_attr_get_preview_frame_rotation(camera_h camera, camera_rotation_e *rotation); @@ -2607,13 +2615,13 @@ int camera_attr_get_preview_frame_rotation(camera_h camera, camera_rotation_e *r * @brief Retrieves all supported FPS modes by invoking the callback function once for each supported FPS mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera - * @param[in] callback The callback function to invoke + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_attr_supported_fps_cb() repeatedly to get each supported FPS mode. * @see camera_attr_set_preview_fps() @@ -2623,18 +2631,18 @@ int camera_attr_get_preview_frame_rotation(camera_h camera, camera_rotation_e *r int camera_attr_foreach_supported_fps(camera_h camera, camera_attr_supported_fps_cb callback, void *user_data); /** - * @brief Retrieves all supported FPS modes by invoking the callback function once for each supported FPS mode. + * @brief Retrieves all supported FPS modes by invoking the callback function once for each supported FPS mode by resolution. * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif * @param[in] camera The handle to the camera * @param[in] width Required preview resolution's width * @param[in] height Required preview resolution's height - * @param[in] callback The callback function to invoke + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_attr_supported_fps_cb() repeatedly to get each supported FPS mode. * @see camera_attr_set_preview_fps() @@ -2661,9 +2669,9 @@ int camera_attr_foreach_supported_fps_by_resolution(camera_h camera, int width, * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_start_preview() @@ -2679,8 +2687,8 @@ int camera_attr_set_image_quality(camera_h camera, int quality); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_image_quality() */ @@ -2694,8 +2702,8 @@ int camera_attr_get_image_quality(camera_h camera, int *quality); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_encoded_preview_bitrate() */ @@ -2711,8 +2719,8 @@ int camera_attr_get_encoded_preview_bitrate(camera_h camera, int *bitrate); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_get_encoded_preview_bitrate() */ @@ -2726,8 +2734,8 @@ int camera_attr_set_encoded_preview_bitrate(camera_h camera, int bitrate); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_encoded_preview_gop_interval() */ @@ -2743,8 +2751,8 @@ int camera_attr_get_encoded_preview_gop_interval(camera_h camera, int *interval) * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_get_encoded_preview_gop_interval() */ @@ -2759,9 +2767,9 @@ int camera_attr_set_encoded_preview_gop_interval(camera_h camera, int interval); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_attr_get_zoom() @@ -2777,8 +2785,8 @@ int camera_attr_set_zoom(camera_h camera, int zoom); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_zoom() * @see camera_attr_get_zoom_range() @@ -2795,8 +2803,8 @@ int camera_attr_get_zoom(camera_h camera, int *zoom); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_zoom() * @see camera_attr_get_zoom() @@ -2812,9 +2820,9 @@ int camera_attr_get_zoom_range(camera_h camera, int *min, int *max); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_attr_get_af_mode() @@ -2831,8 +2839,8 @@ int camera_attr_set_af_mode(camera_h camera, camera_attr_af_mode_e mode); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_foreach_supported_af_mode() * @see camera_attr_set_af_mode() @@ -2843,7 +2851,7 @@ int camera_attr_get_af_mode(camera_h camera, camera_attr_af_mode_e *mode); /** * @brief Sets auto focus area. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @remarks This API is invalid in the #CAMERA_ATTR_AF_NONE mode.\n + * @remarks It will return #CAMERA_ERROR_INVALID_OPERATION in the #CAMERA_ATTR_AF_NONE mode.\n * The coordinates are mapped to preview area. * @param[in] camera The handle to the camera * @param[in] x The x coordinates of the focus area @@ -2851,10 +2859,10 @@ int camera_attr_get_af_mode(camera_h camera, camera_attr_af_mode_e *mode); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_attr_set_af_mode() @@ -2870,9 +2878,9 @@ int camera_attr_set_af_area(camera_h camera, int x, int y); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_OPERATION Invalid operation - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_af_mode() * @see camera_attr_set_af_area() @@ -2892,13 +2900,13 @@ int camera_attr_clear_af_area(camera_h camera); * @brief Retrieves all supported auto focus modes by invoking the callback function once for each supported auto focus mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera - * @param[in] callback The callback function to invoke + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_attr_supported_af_mode_cb() to get all the supported auto focus modes. * @see camera_attr_set_af_mode() @@ -2924,9 +2932,9 @@ int camera_attr_foreach_supported_af_mode(camera_h camera, camera_attr_supported * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_attr_get_exposure_mode() @@ -2942,8 +2950,8 @@ int camera_attr_set_exposure_mode(camera_h camera, camera_attr_exposure_mode_e m * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_exposure_mode() * @see camera_attr_foreach_supported_exposure_mode() @@ -2968,8 +2976,8 @@ int camera_attr_get_exposure_mode(camera_h camera, camera_attr_exposure_mode_e * * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_attr_supported_exposure_mode_cb() to get all the supported exposure modes. * @see camera_attr_set_exposure_mode() @@ -2995,8 +3003,8 @@ int camera_attr_foreach_supported_exposure_mode(camera_h camera, camera_attr_sup * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_get_exposure() */ @@ -3010,8 +3018,8 @@ int camera_attr_set_exposure(camera_h camera, int value); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_exposure() */ @@ -3027,8 +3035,8 @@ int camera_attr_get_exposure(camera_h camera, int *value); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_exposure() */ @@ -3042,9 +3050,9 @@ int camera_attr_get_exposure_range(camera_h camera, int *min, int *max); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_attr_get_iso() @@ -3060,8 +3068,8 @@ int camera_attr_set_iso(camera_h camera, camera_attr_iso_e iso); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_iso() * @see camera_attr_foreach_supported_iso() @@ -3154,8 +3162,8 @@ int camera_attr_get_gain_step(camera_h camera, int *step); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_attr_supported_iso_cb() to get all the supported ISO levels. * @see camera_attr_set_iso() @@ -3182,8 +3190,8 @@ int camera_attr_foreach_supported_iso(camera_h camera, camera_attr_supported_iso * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre This function is valid only when the external display is connected. * @see camera_attr_get_theater_mode() @@ -3198,8 +3206,8 @@ int camera_attr_set_theater_mode(camera_h camera, camera_attr_theater_mode_e mod * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_theater_mode() */ @@ -3223,8 +3231,8 @@ int camera_attr_get_theater_mode(camera_h camera, camera_attr_theater_mode_e *mo * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_attr_supported_theater_mode_cb() to get all supported theater modes. * @see camera_attr_set_theater_mode() @@ -3253,9 +3261,9 @@ int camera_attr_foreach_supported_theater_mode(camera_h camera, camera_attr_supp * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_attr_get_brightness() @@ -3271,8 +3279,8 @@ int camera_attr_set_brightness(camera_h camera, int level); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_brightness() * @see camera_attr_get_brightness_range() @@ -3289,8 +3297,8 @@ int camera_attr_get_brightness(camera_h camera, int *level); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_brightness() * @see camera_attr_get_brightness() @@ -3305,9 +3313,9 @@ int camera_attr_get_brightness_range(camera_h camera, int *min, int *max); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_attr_get_contrast() @@ -3323,8 +3331,8 @@ int camera_attr_set_contrast(camera_h camera, int level); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_contrast() * @see camera_attr_get_contrast_range() @@ -3341,8 +3349,8 @@ int camera_attr_get_contrast(camera_h camera, int *level); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_contrast() * @see camera_attr_get_contrast() @@ -3401,9 +3409,9 @@ int camera_attr_get_hue_range(camera_h camera, int *min, int *max); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_attr_foreach_supported_whitebalance() @@ -3419,8 +3427,8 @@ int camera_attr_set_whitebalance(camera_h camera, camera_attr_whitebalance_e whi * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_foreach_supported_whitebalance() * @see camera_attr_set_whitebalance() @@ -3605,8 +3613,8 @@ int camera_attr_get_sharpness_range(camera_h camera, int *min, int *max); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_attr_supported_whitebalance_cb() to get all the supported white balances. * @see camera_attr_set_whitebalance() @@ -3632,9 +3640,9 @@ int camera_attr_foreach_supported_whitebalance(camera_h camera, camera_attr_supp * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_attr_foreach_supported_effect() @@ -3651,8 +3659,8 @@ int camera_attr_set_effect(camera_h camera, camera_attr_effect_mode_e effect); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_foreach_supported_effect() * @see camera_attr_set_effect() @@ -3672,13 +3680,13 @@ int camera_attr_get_effect(camera_h camera, camera_attr_effect_mode_e *effect); * @brief Retrieves all supported effect modes by invoking the callback function once for each supported effect mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera - * @param[in] callback The callback function to invoke + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_attr_supported_effect_cb() to get all the supported effect modes. * @see camera_attr_set_effect() @@ -3704,9 +3712,9 @@ int camera_attr_foreach_supported_effect(camera_h camera, camera_attr_supported_ * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_attr_foreach_supported_scene_mode() @@ -3722,8 +3730,8 @@ int camera_attr_set_scene_mode(camera_h camera, camera_attr_scene_mode_e mode); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_foreach_supported_scene_mode() * @see camera_attr_set_scene_mode() @@ -3743,13 +3751,13 @@ int camera_attr_get_scene_mode(camera_h camera, camera_attr_scene_mode_e *mode); * @brief Retrieves all supported scene modes by invoking the callback function once for each supported scene mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera - * @param[in] callback The callback function to invoke + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_attr_supported_scene_mode_cb() to get all the supported scene modes. * @see camera_attr_set_scene_mode() @@ -3768,52 +3776,52 @@ int camera_attr_foreach_supported_scene_mode(camera_h camera, camera_attr_suppor */ /** - * @brief Enables to write EXIF(Exchangeable image file format) tags in a JPEG file. + * @brief Enables to write EXIF (Exchangeable image file format) tags in a JPEG file. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera * @param[in] enable If @c true writing EXIF tags in a JPEG file is enabled, otherwise @c false * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_is_enabled_tag() */ int camera_attr_enable_tag(camera_h camera, bool enable); /** - * @brief Gets the value that indicates whether writing EXIF(Exchangeable image file format) tags in a JPEG file is enabled. + * @brief Gets the value that indicates whether writing EXIF (Exchangeable image file format) tags in a JPEG file is enabled. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera * @param[out] enabled If @c true camera information is enabled, otherwise @c false * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_enable_tag() */ int camera_attr_is_enabled_tag(camera_h camera, bool *enabled); /** - * @brief Sets the camera image description in the EXIF(Exchangeable image file format) tag. + * @brief Sets the camera image description in the EXIF (Exchangeable image file format) tag. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera * @param[in] description The string with description * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_get_tag_image_description() */ int camera_attr_set_tag_image_description(camera_h camera, const char *description); /** - * @brief Gets the camera image description in EXIF(Exchangeable image file format) tag. + * @brief Gets the camera image description in EXIF (Exchangeable image file format) tag. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @remarks You must release @a description using free(). * @param[in] camera The handle to the camera @@ -3821,60 +3829,60 @@ int camera_attr_set_tag_image_description(camera_h camera, const char *descripti * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_tag_image_description() */ int camera_attr_get_tag_image_description(camera_h camera, char **description); /** - * @brief Sets the camera orientation in the EXIF(Exchangeable image file format) tag. + * @brief Sets the camera orientation in the EXIF (Exchangeable image file format) tag. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera * @param[in] orientation The camera orientation * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_get_tag_orientation() */ int camera_attr_set_tag_orientation(camera_h camera, camera_attr_tag_orientation_e orientation); /** - * @brief Gets the camera orientation in the EXIF(Exchangeable image file format) tag. + * @brief Gets the camera orientation in the EXIF (Exchangeable image file format) tag. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera * @param[out] orientation The camera orientation * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_tag_orientation() */ int camera_attr_get_tag_orientation(camera_h camera, camera_attr_tag_orientation_e *orientation); /** - * @brief Sets the software information in the EXIF(Exchangeable image file format) tag. + * @brief Sets the software information in the EXIF (Exchangeable image file format) tag. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera * @param[in] software The software information tag * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_get_tag_software() */ int camera_attr_set_tag_software(camera_h camera, const char *software); /** - * @brief Gets the software information in the EXIF(Exchangeable image file format) tag. + * @brief Gets the software information in the EXIF (Exchangeable image file format) tag. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @remarks You must release @a software using free(). * @param[in] camera The handle to the camera @@ -3882,15 +3890,15 @@ int camera_attr_set_tag_software(camera_h camera, const char *software); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_tag_software() */ int camera_attr_get_tag_software(camera_h camera, char **software); /** - * @brief Sets the geotag(GPS data) in the EXIF(Exchangeable image file format) tag. + * @brief Sets the geotag (GPS data) in the EXIF (Exchangeable image file format) tag. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera * @param[in] latitude The latitude data @@ -3899,9 +3907,9 @@ int camera_attr_get_tag_software(camera_h camera, char **software); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_attr_get_geotag() @@ -3910,7 +3918,7 @@ int camera_attr_get_tag_software(camera_h camera, char **software); int camera_attr_set_geotag(camera_h camera, double latitude, double longitude, double altitude); /** - * @brief Gets the geotag(GPS data) in the EXIF(Exchangeable image file format) tag. + * @brief Gets the geotag (GPS data) in the EXIF (Exchangeable image file format) tag. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera * @param[out] latitude The latitude data @@ -3919,8 +3927,8 @@ int camera_attr_set_geotag(camera_h camera, double latitude, double longitude, d * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_geotag() * @see camera_attr_remove_geotag() @@ -3928,15 +3936,15 @@ int camera_attr_set_geotag(camera_h camera, double latitude, double longitude, d int camera_attr_get_geotag(camera_h camera, double *latitude, double *longitude, double *altitude); /** - * @brief Removes the geotag(GPS data) in the EXIF(Exchangeable image file format) tag. + * @brief Removes the geotag (GPS data) in the EXIF (Exchangeable image file format) tag. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_attr_set_geotag() @@ -3954,9 +3962,9 @@ int camera_attr_remove_geotag(camera_h camera); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @retval #CAMERA_ERROR_DEVICE_BUSY The flash was preempted by other API * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. @@ -3973,8 +3981,8 @@ int camera_attr_set_flash_mode(camera_h camera, camera_attr_flash_mode_e mode); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_foreach_supported_flash_mode() * @see camera_attr_set_flash_mode() @@ -3994,13 +4002,13 @@ int camera_attr_get_flash_mode(camera_h camera, camera_attr_flash_mode_e *mode); * @brief Retrieves all supported flash modes by invoking the callback function once for each supported flash mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera - * @param[in] callback The callback function to invoke + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data passed to the callback registration function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_attr_supported_flash_mode_cb() to get all supported flash modes. * @see camera_attr_set_flash_mode() @@ -4026,8 +4034,8 @@ int camera_attr_foreach_supported_flash_mode(camera_h camera, camera_attr_suppor * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_set_display_rotation() */ @@ -4041,8 +4049,8 @@ int camera_attr_get_lens_orientation(camera_h camera, int *angle); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED. * @see camera_attr_get_stream_rotation() @@ -4057,8 +4065,8 @@ int camera_attr_set_stream_rotation(camera_h camera, camera_rotation_e rotation) * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED. * @see camera_attr_set_stream_rotation() @@ -4078,13 +4086,13 @@ int camera_attr_get_stream_rotation(camera_h camera, camera_rotation_e *rotation * @brief Retrieves all supported stream rotation modes by invoking callback function once for each supported stream rotation mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera - * @param[in] callback The callback function to invoke + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_attr_supported_stream_rotation_cb() to get all supported stream rotation mode. * @see camera_attr_set_stream_rotation() @@ -4110,9 +4118,9 @@ int camera_attr_foreach_supported_stream_rotation(camera_h camera, camera_attr_s * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED. * @see camera_attr_set_stream_rotation() @@ -4127,8 +4135,8 @@ int camera_attr_set_stream_flip(camera_h camera, camera_flip_e flip); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED. * @see camera_attr_set_stream_rotation() @@ -4148,13 +4156,13 @@ int camera_attr_get_stream_flip(camera_h camera, camera_flip_e *flip); * @brief Retrieves all supported stream flip modes by invoking callback function once for each supported stream flip mode. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera - * @param[in] callback The callback function to invoke + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parametergranted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_attr_supported_stream_flip_cb() to get all supported stream flip mode. * @see camera_attr_set_stream_flip() @@ -4173,11 +4181,11 @@ int camera_attr_foreach_supported_stream_flip(camera_h camera, camera_attr_suppo */ /** - * @brief Called when the HDR capture process is updated. + * @brief Invoked when the HDR capture process is updated. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] percent The progress percentage of HDR capture * @param[in] user_data The user data passed from the callback registration function - * @pre camera_start_capture() will invoke this callback if you register it using camera_attr_set_hdr_capture_progress_cb(). + * @pre camera_start_capture() will invoke this callback if you set it using camera_attr_set_hdr_capture_progress_cb(). * @see camera_attr_get_hdr_mode() * @see camera_attr_set_hdr_capture_progress_cb() * @see camera_attr_unset_hdr_capture_progress_cb() @@ -4196,9 +4204,9 @@ typedef void (*camera_attr_hdr_progress_cb)(int percent, void *user_data); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_attr_get_hdr_mode() @@ -4217,8 +4225,8 @@ int camera_attr_set_hdr_mode(camera_h camera, camera_attr_hdr_mode_e mode); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_hdr_mode() * @see camera_attr_set_hdr_capture_progress_cb() @@ -4228,17 +4236,17 @@ int camera_attr_set_hdr_mode(camera_h camera, camera_attr_hdr_mode_e mode); int camera_attr_get_hdr_mode(camera_h camera, camera_attr_hdr_mode_e *mode); /** - * @brief Registers a callback function to be called when HDR capture is progressing. + * @brief Sets a callback function to be invoked when HDR capture is progressing. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @remarks This callback notifies progress of the HDR process. * @param[in] camera The handle to the camera - * @param[in] callback The callback function to invoke + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data passed to the callback registration function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_hdr_mode() * @see camera_attr_get_hdr_mode() @@ -4248,14 +4256,14 @@ int camera_attr_get_hdr_mode(camera_h camera, camera_attr_hdr_mode_e *mode); int camera_attr_set_hdr_capture_progress_cb(camera_h camera, camera_attr_hdr_progress_cb callback, void* user_data); /** - * @brief Unregisters the callback function. + * @brief Unsets the HDR capture progress callback function. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @param[in] camera The handle to the camera * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_hdr_mode() * @see camera_attr_get_hdr_mode() @@ -4273,8 +4281,8 @@ int camera_attr_unset_hdr_capture_progress_cb(camera_h camera); * @return @c true if supported, otherwise @c false * @exception #CAMERA_ERROR_NONE Successful * @exception #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @exception #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @see camera_attr_set_hdr_mode() * @see camera_attr_get_hdr_mode() * @see camera_attr_set_hdr_capture_progress_cb() @@ -4291,8 +4299,8 @@ bool camera_attr_is_supported_hdr_capture(camera_h camera); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_is_enabled_anti_shake() * @see camera_attr_is_supported_anti_shake() @@ -4308,8 +4316,8 @@ int camera_attr_enable_anti_shake(camera_h camera, bool enable); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_enable_anti_shake() * @see camera_attr_is_supported_anti_shake() @@ -4325,8 +4333,8 @@ int camera_attr_is_enabled_anti_shake(camera_h camera, bool *enabled); * @return @c true if supported, otherwise @c false * @exception #CAMERA_ERROR_NONE Successful * @exception #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @exception #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @see camera_attr_enable_anti_shake() * @see camera_attr_is_enabled_anti_shake() */ @@ -4342,8 +4350,8 @@ bool camera_attr_is_supported_anti_shake(camera_h camera); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_is_enabled_video_stabilization() * @see camera_attr_is_supported_video_stabilization() @@ -4359,8 +4367,8 @@ int camera_attr_enable_video_stabilization(camera_h camera, bool enable); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_enable_video_stabilization() * @see camera_attr_is_supported_video_stabilization() @@ -4376,8 +4384,8 @@ int camera_attr_is_enabled_video_stabilization(camera_h camera, bool *enabled); * @return @c true if supported, otherwise @c false * @exception #CAMERA_ERROR_NONE Successful * @exception #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @exception #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @see camera_attr_enable_video_stabilization() * @see camera_attr_is_enabled_video_stabilization() */ @@ -4391,9 +4399,9 @@ bool camera_attr_is_supported_video_stabilization(camera_h camera); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_STATE Invalid state - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_CREATED or #CAMERA_STATE_PREVIEW. * @see camera_attr_is_enabled_auto_contrast() @@ -4408,8 +4416,8 @@ int camera_attr_enable_auto_contrast(camera_h camera, bool enable); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_enable_auto_contrast() */ @@ -4433,8 +4441,8 @@ int camera_attr_is_enabled_auto_contrast(camera_h camera, bool *enabled); * @return true on supported, otherwise false * @exception #CAMERA_ERROR_NONE Successful * @exception #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @exception #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @exception #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @see camera_attr_enable_auto_contrast() * @see camera_attr_is_enabled_auto_contrast() */ @@ -4458,9 +4466,9 @@ bool camera_attr_is_supported_auto_contrast(camera_h camera); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported + * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_INVALID_OPERATION Disabling shutter sound is not permitted - * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected */ int camera_attr_disable_shutter_sound(camera_h camera, bool disable); @@ -4469,13 +4477,13 @@ int camera_attr_disable_shutter_sound(camera_h camera, bool disable); * @brief Sets the position to move horizontally. * @since_tizen 3.0 * @param[in] camera The handle to the camera - * @param[in] move_type The PTZ(Pan Tilt Zoom) move type + * @param[in] move_type The PTZ (Pan Tilt Zoom) move type * @param[in] pan_step The step to move the camera * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_STATE Invalid state * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_PREVIEW. @@ -4485,15 +4493,15 @@ int camera_attr_disable_shutter_sound(camera_h camera, bool disable); int camera_attr_set_pan(camera_h camera, camera_attr_ptz_move_type_e move_type, int pan_step); /** - * @brief Gets the current position of the camera. + * @brief Gets the current horizontal position of the camera. * @since_tizen 3.0 * @param[in] camera The handle to the camera * @param[out] pan_step The current horizontal distance from the starting point. * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_pan() * @see camera_attr_get_pan_range() @@ -4510,8 +4518,8 @@ int camera_attr_get_pan(camera_h camera, int *pan_step); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_pan() * @see camera_attr_get_pan() @@ -4522,13 +4530,13 @@ int camera_attr_get_pan_range(camera_h camera, int *min, int *max); * @brief Sets the position to move vertically. * @since_tizen 3.0 * @param[in] camera The handle to the camera - * @param[in] move_type The PTZ(Pan Tilt Zoom) move type + * @param[in] move_type The PTZ (Pan Tilt Zoom) move type * @param[in] tilt_step The step to move the camera * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_STATE Invalid state * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_PREVIEW. @@ -4538,15 +4546,15 @@ int camera_attr_get_pan_range(camera_h camera, int *min, int *max); int camera_attr_set_tilt(camera_h camera, camera_attr_ptz_move_type_e move_type, int tilt_step); /** - * @brief Gets the current position of the camera. + * @brief Gets the current vertical position of the camera. * @since_tizen 3.0 * @param[in] camera The handle to the camera * @param[out] tilt_step The current vertical distance from the starting point. * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_tilt() * @see camera_attr_get_tilt_range() @@ -4563,8 +4571,8 @@ int camera_attr_get_tilt(camera_h camera, int *tilt_step); * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_tilt() * @see camera_attr_get_tilt() @@ -4572,15 +4580,15 @@ int camera_attr_get_tilt(camera_h camera, int *tilt_step); int camera_attr_get_tilt_range(camera_h camera, int *min, int *max); /** - * @brief Sets the type of PTZ(Pan Tilt Zoom). + * @brief Sets the type of PTZ (Pan Tilt Zoom). * @since_tizen 3.0 * @param[in] camera The handle to the camera * @param[in] ptz_type PTZ type * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_STATE Invalid state * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The camera state must be set to #CAMERA_STATE_PREVIEW. @@ -4604,16 +4612,16 @@ int camera_attr_set_ptz_type(camera_h camera, camera_attr_ptz_type_e ptz_type); */ /** - * @brief Retrieves all supported PTZ(Pan Tilt Zoom) types by invoking callback function once for each supported ptz type. + * @brief Retrieves all supported PTZ (Pan Tilt Zoom) types by invoking callback function once for each supported ptz type. * @since_tizen 3.0 * @param[in] camera The handle to the camera - * @param[in] callback The callback function to invoke + * @param[in] callback The callback function to be invoked * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_PERMISSION_DENIED The access to the resources can not be granted + * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @post This function invokes camera_attr_supported_ptz_type_cb() to get all supported ptz type. * @see camera_attr_set_ptz_type() @@ -4630,7 +4638,7 @@ int camera_attr_foreach_supported_ptz_type(camera_h camera, camera_attr_supporte */ /** - * @brief Sets the ROI(Region Of Interest) area of display. + * @brief Sets the ROI (Region Of Interest) area of display. * @since_tizen 3.0 * @remarks If no display is set, no operation is performed and * the ROI area is valid only in #CAMERA_DISPLAY_MODE_CUSTOM_ROI display mode. @@ -4644,15 +4652,15 @@ int camera_attr_foreach_supported_ptz_type(camera_h camera, camera_attr_supporte * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_get_display_roi_area() */ int camera_attr_set_display_roi_area(camera_h camera, int x, int y, int width, int height); /** - * @brief Gets the ROI(Region Of Interest) area of display. + * @brief Gets the ROI (Region Of Interest) area of display. * @since_tizen 3.0 * @param[in] camera The handle to the camera * @param[out] x X coordinate of area @@ -4662,8 +4670,8 @@ int camera_attr_set_display_roi_area(camera_h camera, int x, int y, int width, i * @return @c 0 on success, otherwise a negative error value * @retval #CAMERA_ERROR_NONE Successful * @retval #CAMERA_ERROR_NOT_SUPPORTED The feature is not supported - * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #CAMERA_ERROR_INVALID_OPERATION Internal error * @retval #CAMERA_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @see camera_attr_set_display_roi_area() */ diff --git a/packaging/capi-media-camera.spec b/packaging/capi-media-camera.spec index b16d768..0e65914 100644 --- a/packaging/capi-media-camera.spec +++ b/packaging/capi-media-camera.spec @@ -1,6 +1,6 @@ Name: capi-media-camera Summary: A Camera API -Version: 0.4.102 +Version: 0.4.103 Release: 0 Group: Multimedia/API License: Apache-2.0 -- 2.7.4