* @{
*/
+/**
+ * @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
/**
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;
*/
/**
- * @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
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
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
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
*
* @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()
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()
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()
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()
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()
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
* @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
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
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()
*/
/**
- * @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
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
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
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
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
* @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()
* @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()
*/
* @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
*/
/**
- * @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
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
* @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()
* @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.
* @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()),
* @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.
*
* @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.
*
* @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()
* @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.
* @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.
*
* @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.
*
* @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.
*
* @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()
* @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()
* 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
* @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.
*
* @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.
*
* @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);
* @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.
*
* @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()
* @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()
*/
* @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()
*/
* @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()
*/
* @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()
*/
* @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()
*/
* @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()
*/
* @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()
*/
* @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()
* @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()
*
* @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()
*
* @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()
* @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()
* @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()
* @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()
* @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()
* @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);
* @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
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
* @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()
* @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()
*/
* @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);
* @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);
* @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);
*/
/**
- * @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.
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()
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()
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()
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
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
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()
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
* #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.
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()
*/
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
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
*/
/**
- * @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
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
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
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
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
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
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
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
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
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
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
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
* @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()
* @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()
* @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()
*/
* @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()
*/
* @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()
*/
* @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()
*/
* @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);
* @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()
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()
* @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()
* @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()
*/
* @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()
*/
* @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()
*/
* @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()
*/
* @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()
*/
* @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()
* @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()
* @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()
* @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()
* @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()
/**
* @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
* @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()
* @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()
* @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()
* @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()
* @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()
* @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()
* @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()
*/
* @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()
*/
* @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()
*/
* @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()
* @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()
* @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()
* @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()
* @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()
*/
* @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()
* @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()
* @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()
* @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()
* @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()
* @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()
* @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()
* @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()
* @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()
* @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()
* @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()
* @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()
* @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()
* @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()
* @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()
* @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()
*/
/**
- * @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
* @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
* @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
* @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()
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
* @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()
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()
* @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.
* @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()
* @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()
* @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()
*/
* @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()
* @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()
* @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()
* @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()
* @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()
* @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()
*/
/**
- * @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()
* @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()
* @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()
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()
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()
* @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()
* @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()
* @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()
* @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()
*/
* @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()
* @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()
* @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()
*/
* @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()
* @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()
*/
* @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()
*/
* @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);
* @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.
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()
* @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()
* @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.
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()
* @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()
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.
*/
/**
- * @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()
*/
/**
- * @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.
* @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
* @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()
*/