/**
* @file camera.h
* @brief This file contains the Camera API, related structures and enumerations.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
/**
/**
* @brief Tizen error class for camera.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
#define CAMERA_ERROR_CLASS TIZEN_ERROR_CAMERA | 0x00
/**
* @brief Enumeration for the error codes of Camera.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_ERROR_NONE = TIZEN_ERROR_NONE, /**< Successful */
/**
* @brief Enumeration for the camera state.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_STATE_NONE, /**< Before creating */
/**
* @brief Enumeration for the camera device.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_DEVICE_CAMERA0 = 0, /**< Primary camera */
/**
* @brief Enumeration for the camera pixel format.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks If #CAMERA_PIXEL_FORMAT_INVZ is set, the type of display should be #CAMERA_DISPLAY_TYPE_NONE. \n
* Otherwise, camera_start_preview() will return #CAMERA_ERROR_INVALID_OPERATION. (Since 5.0)
*/
/**
* @brief Enumeration for the camera display type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_DISPLAY_TYPE_OVERLAY = 0, /**< Overlay surface display */
/**
* @brief Enumeration for the camera policy.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_POLICY_NONE = 0, /**< None */
/**
* @brief Enumeration for the camera rotation type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_ROTATION_NONE, /**< No rotation */
/**
* @brief Enumeration for the camera flip type.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_FLIP_NONE, /**< No Flip */
/**
* @brief Enumeration for the camera focus state.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_FOCUS_STATE_RELEASED = 0, /**< Focus released */
/**
* @brief The structure type of the image data.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef struct {
unsigned char *data; /**< The image buffer */
/**
* @brief The structure type for face detection.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef struct {
int id; /**< The ID of each face */
/**
* @brief The structure type to preview stream data.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef struct {
camera_pixel_format_e format; /**< The format of the frame pixel */
/**
* @brief The Camera handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @see recorder_create_videorecorder()
*/
typedef struct camera_cli_s *camera_h;
/**
* @brief The Camera display handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef void *camera_display_h;
/**
* @brief Gets a display handle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
#define GET_DISPLAY(x) (void*)(x)
/**
* @brief Enumeration for the camera display mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_DISPLAY_MODE_LETTER_BOX = 0, /**< Letter box */
/**
* @brief Enumeration for the color tone, which provides the impression of looking through a tinted glass.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_ATTR_EFFECT_NONE = 0, /**< None */
/**
* @brief Enumeration for the white balance levels of the camera.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_ATTR_WHITE_BALANCE_NONE = 0, /**< None */
/**
* @brief Enumeration for the scene mode.
* @details The mode of operation can be in daylight, night, or back-light.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_ATTR_SCENE_MODE_NORMAL = 0, /**< Normal */
/**
* @brief Enumeration for the auto focus mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_ATTR_AF_NONE = 0, /**< auto-focus is not set */
/**
* @brief Enumeration for the ISO levels of the camera.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_ATTR_ISO_AUTO = 0, /**< ISO auto mode */
/**
* @brief Enumeration for the camera exposure modes.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_ATTR_EXPOSURE_MODE_OFF = 0, /**< Off */
/**
* @brief Enumeration for the orientation values of tag.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_ATTR_TAG_ORIENTATION_TOP_LEFT = 1, /**< Row #0 is at the top, Column #0 is to the left */
/**
* @brief Enumeration for the flash mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_ATTR_FLASH_MODE_OFF = 0, /**< Always off */
/**
* @brief Enumeration to preview FPS.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_ATTR_FPS_AUTO = 0, /**< AUTO FPS */
/**
* @brief Enumeration for the theater mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_ATTR_THEATER_MODE_DISABLE = 0, /**< Disable theater mode - External display shows same image as device display */
/**
* @brief Enumeration for HDR capture mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*/
typedef enum {
CAMERA_ATTR_HDR_MODE_DISABLE = 0, /**< Disable HDR capture */
/**
* @brief Invoked when the camera state is changed.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
/**
* @brief Invoked when the camera is interrupted by policy.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
* Changes of focus state are as follows: \n
* #CAMERA_FOCUS_STATE_RELEASED -> start focusing -> #CAMERA_FOCUS_STATE_ONGOING -> working ->
* #CAMERA_FOCUS_STATE_FOCUSED or #CAMERA_FOCUS_STATE_FAILED.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @param[in] state The current state of the auto-focus
* @param[in] user_data The user data passed from the callback registration function
/**
* @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
+ * @since_tizen 2.3
*
* @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.
/**
* @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
+ * @since_tizen 2.3
*
* @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
/**
* @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
+ * @since_tizen 2.3
*
* @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
/**
* @brief Invoked when the camera capturing completes.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @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
/**
* @brief Invoked when an error occurs.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
*
* @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
/**
* @brief Invoked when a face is detected in the preview frame.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
/**
* @brief Invoked once for each supported preview resolution.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] width The preview image width
* @param[in] height The preview image height
* @param[in] user_data The user data passed from the foreach function
/**
* @brief Invoked once for each supported capture resolution.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] width The capture resolution width
* @param[in] height The capture resolution height
* @param[in] user_data The user data passed from the foreach function
/**
* @brief Invoked once for the pixel format of each supported capture format.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] format The supported pixel format
* @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
/**
* @brief Invoked once for the pixel format of each supported preview format.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] format The supported preview data format
* @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
/**
* @brief Creates a new camera handle for controlling a camera.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks Multiple handles on a context at the same time are allowed to be created. However,
* camera cannot guarantee proper operation because of limited resources, such as
* camera device, audio device, and display device.\n.
/**
* @brief Destroys the camera handle and releases all its resources.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @return @c 0 on success, otherwise a negative error value
* @retval #CAMERA_ERROR_NONE Successful
/**
* @brief Starts capturing and drawing preview frames on the screen.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
* @param[in] camera The handle to the camera
/**
* @brief Stops capturing and drawing preview frames.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
* @param[in] camera The handle to the camera
/**
* @brief Starts capturing of still images.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
* @remarks This function causes the transition of the camera state from #CAMERA_STATE_CAPTURING to #CAMERA_STATE_CAPTURED automatically\n
/**
* @brief Starts continuously capturing still images.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
* @remarks If this is not supported zero shutter lag occurs. The capture resolution could be changed to the preview resolution.\n
/**
* @brief Aborts continuous capturing.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
* @remarks The camera state will be changed to #CAMERA_STATE_CAPTURED.
/**
* @brief Gets the state of the camera.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] state The current state of the camera
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Starts camera auto-focusing, asynchronously.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
* @remarks If continuous status is @c true, the camera continuously tries to focus.
/**
* @brief Stops camera auto focusing.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
* @param[in] camera The handle to the camera
/**
* @brief Sets the display handle to show preview images.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks This function must be called before previewing (see camera_start_preview()).
* In Custom ROI display mode, camera_attr_set_display_roi_area() function must be called before calling this function.
* @remarks This function must be called in main thread of the application.
/**
* @brief Sets the resolution of the preview.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks This function should be called before previewing (camera_start_preview()).
* @param[in] camera The handle to the camera
* @param[in] width The preview width
/**
* @brief Gets the resolution of the preview.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] width The preview width
* @param[out] height The preview height
/**
* @brief Gets the recommended preview resolution.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks Depending on the capture resolution aspect ratio and display resolution, the recommended preview resolution is determined.
* @param[in] camera The handle to the camera
* @param[out] width The preview width
/**
* @brief Starts face detection.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
* @remarks This should be called after the preview is started.\n
/**
* @brief Stops face detection.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
* @param[in] camera The handle to the camera
/**
* @brief Gets continuous capture feature's supported state.
* @ingroup CAPI_MEDIA_CAMERA_CAPABILITY_MODULE
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] camera The handle to the camera
* @return @c true on supported, otherwise false
/**
* @brief Retrieves all supported camera preview resolutions by invoking the callback function once for each supported camera preview resolution.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
* @ingroup CAPI_MEDIA_CAMERA_DISPLAY_MODULE
* @brief Sets the display rotation.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks This function should be called before previewing (see camera_start_preview())
* @param[in] camera The handle to the camera
* @param[in] rotation The display rotation
* @ingroup CAPI_MEDIA_CAMERA_DISPLAY_MODULE
* @brief Gets the display rotation.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] rotation The display rotation
* @return @c 0 on success, otherwise a negative error value
* @ingroup CAPI_MEDIA_CAMERA_DISPLAY_MODULE
* @brief Sets the display flip.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] flip The display flip
* @return @c 0 on success, otherwise a negative error value
* @ingroup CAPI_MEDIA_CAMERA_DISPLAY_MODULE
* @brief Gets the display flip.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] flip The display flip
* @return @c 0 on success, otherwise a negative error value
* @ingroup CAPI_MEDIA_CAMERA_DISPLAY_MODULE
* @brief Sets the visible property for display.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] visible The display visibility property
*
* @ingroup CAPI_MEDIA_CAMERA_DISPLAY_MODULE
* @brief Gets the visible property of display.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] visible @c true if camera display is visible, otherwise @c false
*
* @ingroup CAPI_MEDIA_CAMERA_DISPLAY_MODULE
* @brief Sets the display mode.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] mode The display mode
*
* @ingroup CAPI_MEDIA_CAMERA_DISPLAY_MODULE
* @brief Gets the display mode.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] mode The display mode
*
/**
* @brief Sets the resolution of the captured image.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] width The capture width
* @param[in] height The capture height
/**
* @brief Gets the resolution of the captured image.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] width The capture width
* @param[out] height The capture height
/**
* @brief Retrieves all supported camera captured resolutions by invoking the callback function once for each supported camera capture resolution.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
/**
* @brief Sets the format of an image to be captured.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks This function should be called before capturing (see camera_start_capture()).
* @param[in] camera The handle to the camera
* @param[in] format The format of the image to be captured
/**
* @brief Gets the format of the image to be captured.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] format The format of the image to be captured
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Retrieves all supported camera capture formats by invoking the callback function once for each supported camera capture format.
*
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
/**
* @brief Sets the preview data format.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks This function should be called before previewing (see camera_start_preview()).
* @param[in] camera The handle to the camera
* @param[in] format The preview data format
/**
* @brief Gets the format of the preview stream.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] format The preview data format
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Retrieves all supported camera preview formats by invoking the callback function once for each supported camera preview format.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
/**
* @ingroup CAPI_MEDIA_CAMERA_CAPABILITY_MODULE
* @brief Gets the face detection feature's supported state.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] camera The handle to the camera
* @return @c true if supported, otherwise @c false
/**
* @brief Gets the zero shutter lag feature's supported state.
* @ingroup CAPI_MEDIA_CAMERA_CAPABILITY_MODULE
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks If supporting zero shutter lag, continuous shot can be done with full capture size. \n
* The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] camera The handle to the camera
/**
* @ingroup CAPI_MEDIA_CAMERA_CAPABILITY_MODULE
* @brief Gets the camera device count.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks If the device supports primary and secondary camera, this returns @c 2. If @c 1 is returned, the device only supports primary camera.
* @param[in] camera The handle to the camera
* @param[out] device_count The device count
/**
* @brief Gets the media packet preview callback feature's supported state.
* @ingroup CAPI_MEDIA_CAMERA_CAPABILITY_MODULE
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] camera The handle to the camera
* @return @c true if supported, otherwise @c false
/**
* @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
+ * @since_tizen 2.3
* @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
/**
* @brief Unsets the preview callback function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @return @c 0 on success, otherwise a negative error value
* @retval #CAMERA_ERROR_NONE Successful
/**
* @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
+ * @since_tizen 2.3
* @remarks This callback does not work in video recorder mode.\n
* This function should be called before previewing (see camera_start_preview())\n
* A @a callback is invoked on the internal thread of the camera.\n
/**
* @brief Unsets the media packet callback function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @return @c 0 on success, otherwise a negative error value
* @retval #CAMERA_ERROR_NONE Successful
/**
* @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
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
/**
* @brief Unsets the state changed callback function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @return @c 0 on success, otherwise a negative error value
* @retval #CAMERA_ERROR_NONE Successful
/**
* @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
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
/**
* @brief Unsets the interrupted callback function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @return @c 0 on success, otherwise a negative error value
* @retval #CAMERA_ERROR_NONE Successful
/**
* @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
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
/**
* @brief Unsets the focus changed callback function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @return @c 0 on success, otherwise a negative error value
* @retval #CAMERA_ERROR_NONE Successful
/**
* @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
+ * @since_tizen 2.3
* @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
* In case of errors, one of the following codes will occur:\n
/**
* @brief Unsets the error callback function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @return @c 0 on success, otherwise a negative error value
* @retval #CAMERA_ERROR_NONE Successful
/**
* @brief Invoked to get each supported auto-focus mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] mode The supported auto-focus mode
* @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
/**
* @brief Invoked to get each supported exposure mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] mode The supported exposure mode
* @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
/**
* @brief Invoked to get each supported ISO mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] iso The supported ISO mode
* @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
/**
* @brief Invoked to get each supported white balance.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] wb The supported white balance mode
* @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
/**
* @brief Invoked to get each supported effect mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] effect The supported effect mode
* @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
/**
* @brief Invoked to get each supported scene mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] mode The supported scene mode
* @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
/**
* @brief Invoked to get each supported flash mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] mode The supported flash mode
* @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
/**
* @brief Invoked to get each supported FPS mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] fps The supported FPS mode
* @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
/**
* @brief Invoked to get each supported stream flip mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] flip The supported stream flip mode
* @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 @c false to break out of the loop
/**
* @brief Invoked to get each supported stream rotation mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] rotation The supported stream rotation mode
* @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 @c false to break out of the loop
/**
* @brief Invoked to get each supported theater mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] mode The supported theater mode
* @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 @c false to break out of the loop
/**
* @brief Sets the preview frame rate.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks This function should be called before previewing (see camera_start_preview()).
* @param[in] camera The handle to the camera
* @param[in] fps The frame rate
/**
* @brief Gets the frames per second of a preview video stream.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] fps The frames per second of the preview video stream
* @return @c 0 on success, otherwise a negative error value
/**
* @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
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
/**
* @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
+ * @since_tizen 2.4
* @param[in] camera The handle to the camera
* @param[in] width Required preview resolution's width
* @param[in] height Required preview resolution's height
/**
* @brief Sets quality of the image.
* @details The range for image quality is 1 to 100. If @a quality is out of range, #CAMERA_ERROR_INVALID_PARAMETER error occurred.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] quality The quality of image (1 ~ 100)
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the quality of a still image, which is captured.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] quality The quality of the image(1 ~ 100)
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Sets the zoom level.
* @details The range for the zoom level is received from camera_attr_get_zoom_range(). If @a zoom is out of range, the #CAMERA_ERROR_INVALID_PARAMETER error occurs.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] zoom The zoom level
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the zoom level.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] zoom The zoom level
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the available zoom level.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks If the min value is greater than the max value, it means that this feature is not supported.
* @param[in] camera The handle to the camera
* @param[out] min The minimum zoom level
/**
* @brief Sets the auto focus mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] mode The auto focus mode
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the auto focus mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] mode The auto focus mode
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Sets auto focus area.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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
/**
* @brief Clears the auto focus area.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The focusing area is set to the center.
* @param[in] camera The handle to the camera
* @return @c 0 on success, otherwise a negative error value
/**
* @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
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
/**
* @brief Sets the exposure mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] mode The exposure mode
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the exposure mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] mode The exposure mode
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Retrieves all supported exposure modes by invoking the callback function once for each supported exposure mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
/**
* @brief Sets the exposure value.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] value The exposure value
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the exposure value.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] value The exposure value
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the available exposure value.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks If the min value is greater than the max value, it means that this feature is not supported.
* @param[in] camera The handle to the camera
* @param[out] min The minimum exposure value
/**
* @brief Sets the ISO level.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] iso The ISO level
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the ISO level.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] iso The ISO level
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Retrieves all supported ISO levels by invoking the callback function once for each supported ISO level.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
/**
* @brief Sets the theater mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks If you want to display the preview image on the external display with the full screen mode, use this function.
* @param[in] camera The handle to the camera
* @param[in] mode The theater mode
/**
* @brief Gets the theater mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] mode The theater mode
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Retrieves all supported theater modes by invoking callback function once for each supported theater modes.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
/**
* @brief Sets the brightness level.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks If the min value is greater than the max value from camera_attr_get_brightness_range(), \n
* it means that this feature is not supported.
* @param[in] camera The handle to the camera
/**
* @brief Gets the brightness level.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] level The brightness level
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the available brightness level.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks If the min value is greater than the max value, it means that this feature is not supported.
* @param[in] camera The handle to the camera
* @param[out] min The minimum brightness level
/**
* @brief Sets the contrast level.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] level The contrast level
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the contrast level.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] level The contrast level
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the available contrast level.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks If the min value is greater than the max value, it means that this feature is not supported.
* @param[in] camera The handle to the camera
* @param[out] min The minimum contrast level
/**
* @brief Sets the white balance mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] whitebalance The white balance mode
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the white balance mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] whitebalance The white balance mode
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Retrieves all supported white balances by invoking the callback function once for each supported white balance.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
/**
* @brief Sets the camera effect mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] effect The camera effect mode
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the camera effect mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] effect The camera effect mode
* @return @c 0 on success, otherwise a negative error value
/**
* @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
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
/**
* @brief Sets the scene mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] mode The scene mode
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the scene mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] mode The scene mode
* @return @c 0 on success, otherwise a negative error value
/**
* @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
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
/**
* @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
+ * @since_tizen 2.3
* @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
/**
* @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
+ * @since_tizen 2.3
* @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
/**
* @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
+ * @since_tizen 2.3
* @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
/**
* @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
+ * @since_tizen 2.3
* @remarks You must release @a description using free().
* @param[in] camera The handle to the camera
* @param[out] description A pointer to a string
/**
* @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
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] orientation The camera orientation
* @return @c 0 on success, otherwise a negative error value
/**
* @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
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] orientation The camera orientation
* @return @c 0 on success, otherwise a negative error value
/**
* @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
+ * @since_tizen 2.3
* @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
/**
* @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
+ * @since_tizen 2.3
* @remarks You must release @a software using free().
* @param[in] camera The handle to the camera
* @param[out] software A pointer to a string
/**
* @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
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] latitude The latitude data
* @param[in] longitude The longitude data
/**
* @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
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] latitude The latitude data
* @param[out] longitude The longitude data
/**
* @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
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @return @c 0 on success, otherwise a negative error value
* @retval #CAMERA_ERROR_NONE Successful
/**
* @brief Sets the camera's flash mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @remarks Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif, while setting the flash mode, if the flash was preempted by other APIs,\n
+ * @since_tizen 2.3
+ * @remarks Since 2.4, while setting the flash mode, if the flash was preempted by other APIs,\n
* then this function returns #CAMERA_ERROR_DEVICE_BUSY error.
* @param[in] camera The handle to the camera
* @param[in] mode The flash mode
/**
* @brief Gets the camera's flash mode.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] mode The flash mode
* @return @c 0 on success, otherwise a negative error value
/**
* @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
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data passed to the callback registration function
/**
* @brief Gets the camera len's orientation angle.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] angle The orientation angle
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Sets the stream rotation.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] rotation The stream rotation
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the stream rotation.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] rotation The stream rotation
* @return @c 0 on success, otherwise a negative error value
/**
* @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
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
/**
* @brief Sets the stream flip.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] flip The stream flip
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the stream flip.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] flip The stream flip
* @return @c 0 on success, otherwise a negative error value
/**
* @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
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
* @param[in] user_data The user data to be passed to the callback function
/**
* @brief Invoked when the HDR capture process is updated.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @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 set it using camera_attr_set_hdr_capture_progress_cb().
/**
* @brief Sets the mode of HDR (High Dynamic Range) capture.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks Taking multiple pictures at different exposure levels and intelligently stitching them together so that we eventually arrive at a picture that is representative in both dark and bright areas.\n
* If this attribute is set to @c true. camera_attr_hdr_progress_cb() is invoked during capture.\n
* If you set #CAMERA_ATTR_HDR_MODE_KEEP_ORIGINAL, the capturing callback is invoked twice. The first callback is delivering origin image data. The second callback is delivering improved image data.
/**
* @brief Gets the mode of HDR (High Dynamic Range) capture.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] mode The mode of HDR capture
* @return @c 0 on success, otherwise a negative error value
/**
* @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
+ * @since_tizen 2.3
* @remarks This callback notifies progress of the HDR process.
* @param[in] camera The handle to the camera
* @param[in] callback The callback function to be invoked
/**
* @brief Unsets the HDR capture progress callback function.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @return @c 0 on success, otherwise a negative error value
* @retval #CAMERA_ERROR_NONE Successful
/**
* @ingroup CAPI_MEDIA_CAMERA_CAPABILITY_MODULE
* @brief Gets the support state of HDR capture.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] camera The handle to the camera
* @return @c true if supported, otherwise @c false
/**
* @brief Enables/Disables the anti-shake feature.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks This feature is used for image capture.
* @param[in] camera The handle to the camera
* @param[in] enable If @c true the anti-shake feature is enabled, otherwise @c false
/**
* @brief Gets the state of the anti-shake feature.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] enabled The state of anti-shake
* @return @c 0 on success, otherwise a negative error value
/**
* @ingroup CAPI_MEDIA_CAMERA_CAPABILITY_MODULE
* @brief Gets the support state of the anti-shake feature.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] camera The handle to the camera
* @return @c true if supported, otherwise @c false
/**
* @brief Enables/Disables the video stabilization feature.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks If video stabilization is enabled, zero shutter lag is disabled.\n
* This feature is used to record a video.
* @param[in] camera The handle to the camera
/**
* @brief Gets the state of the video stabilization feature.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] enabled The state of video stabilization
* @return @c 0 on success, otherwise a negative error value
/**
* @ingroup CAPI_MEDIA_CAMERA_CAPABILITY_MODULE
* @brief Gets the support state of the video stabilization feature.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] camera The handle to the camera
* @return @c true if supported, otherwise @c false
/**
* @brief Enables/Disables auto contrast.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[in] enable If @c true auto contrast is enabled, otherwise @c false
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets the state of auto contrast.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @param[in] camera The handle to the camera
* @param[out] enabled The state of auto contrast
* @return @c 0 on success, otherwise a negative error value
/**
* @brief Gets state of support of auto contrast feature.
* @ingroup CAPI_MEDIA_CAMERA_CAPABILITY_MODULE
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
* @param[in] camera The handle to the camera
* @return true on supported, otherwise false
/**
* @brief Disables shutter sound.
- * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ * @since_tizen 2.3
* @remarks In some countries, this operation is not permitted.
* @param[in] camera The handle to the camera
* @param[in] disable If @c true shutter sound is disabled, otherwise @c false
projects / platform / core / api / camera.git / commitdiff