Tizen Native API  7.0
Functions | Typedefs
Attributes
Camera

The Attributes API provides functions to fetch camera attributes.

Required Header

#include <camera.h>

Overview

The Camera Attributes API provides functions to get/set basic camera attributes.

With the Camera Attributes API you are able to set and get camera attributes like:

  • Preview frame rate
  • Supported FPS
  • Image quality
  • Zoom level
  • Auto focus mode
  • Supported auto focus mode
  • Exposure mode
  • Supported exposure mode
  • Exposure value
  • ISO level
  • Supported ISO
  • Brightness level
  • Contrast level
  • White balance mode
  • Supported white balance
  • Effect mode
  • Supported effect mode
  • Scene mode
  • Supported scene mode
  • On/off camera information
  • Image description
  • Orientation information
  • Software tag
  • GPS latitude data
  • GPS longitude data
  • GPS altitude data
  • Flash mode
  • Supported flash mode

Foreach Operations

FOREACH CALLBACK DESCRIPTION
camera_attr_foreach_supported_fps() camera_attr_supported_fps_cb() Supported FPS
camera_attr_foreach_supported_af_mode() camera_attr_supported_af_mode_cb() Supported auto focus mode
camera_attr_foreach_supported_exposure_mode() camera_attr_supported_exposure_mode_cb() Supported exposure mode
camera_attr_foreach_supported_iso() camera_attr_supported_iso_cb() Supported ISO
camera_attr_foreach_supported_whitebalance() camera_attr_supported_whitebalance_cb() Supported whitebalance
camera_attr_foreach_supported_effect() camera_attr_supported_effect_cb() Supported effect mode
camera_attr_foreach_supported_scene_mode() camera_attr_supported_scene_mode_cb() Supported scene mode
camera_attr_foreach_supported_flash_mode() camera_attr_supported_flash_mode_cb() Supported flash mode

Related Features

This API is related with the following features:

  • http://tizen.org/feature/camera
  • http://tizen.org/feature/camera.back
  • http://tizen.org/feature/camera.back.flash
  • http://tizen.org/feature/camera.front
  • http://tizen.org/feature/camera.front.flash

It is recommended to design feature related codes in your application for reliability.
You can check if a device supports the related features for this API by using System Information, thereby controlling the procedure of your application.
To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.
More details on featuring your application can be found from Feature Element.

Functions

int camera_attr_set_preview_fps (camera_h camera, camera_attr_fps_e fps)
 Sets the preview frame rate.
int camera_attr_get_preview_fps (camera_h camera, camera_attr_fps_e *fps)
 Gets the frames per second of a preview video stream.
int camera_attr_set_extra_preview_bitrate (camera_h camera, int stream_id, int bitrate)
 Sets the bitrate of extra preview.
int camera_attr_get_extra_preview_bitrate (camera_h camera, int stream_id, int *bitrate)
 Gets the bitrate of extra preview.
int camera_attr_set_extra_preview_gop_interval (camera_h camera, int stream_id, int interval)
 Sets the GOP (Group Of Pictures) interval of extra preview.
int camera_attr_get_extra_preview_gop_interval (camera_h camera, int stream_id, int *interval)
 Gets the GOP (Group Of Pictures) interval of extra preview.
int camera_attr_get_preview_frame_rotation (camera_h camera, camera_rotation_e *rotation)
 Gets the rotation of preview frame.
int camera_attr_set_image_quality (camera_h camera, int quality)
 Sets quality of the image.
int camera_attr_get_image_quality (camera_h camera, int *quality)
 Gets the quality of a still image, which is captured.
int camera_attr_get_encoded_preview_bitrate (camera_h camera, int *bitrate)
 Gets the bit rate of encoded preview.
int camera_attr_set_encoded_preview_bitrate (camera_h camera, int bitrate)
 Sets the bit rate of encoded preview.
int camera_attr_get_encoded_preview_gop_interval (camera_h camera, int *interval)
 Gets the GOP (Group Of Pictures) interval of encoded preview.
int camera_attr_set_encoded_preview_gop_interval (camera_h camera, int interval)
 Sets the GOP (Group Of Pictures) interval of encoded preview.
int camera_attr_set_zoom (camera_h camera, int zoom)
 Sets the zoom level.
int camera_attr_get_zoom (camera_h camera, int *zoom)
 Gets the zoom level.
int camera_attr_get_zoom_range (camera_h camera, int *min, int *max)
 Gets the available zoom level.
int camera_attr_set_af_mode (camera_h camera, camera_attr_af_mode_e mode)
 Sets the auto focus mode.
int camera_attr_get_af_mode (camera_h camera, camera_attr_af_mode_e *mode)
 Gets the auto focus mode.
int camera_attr_set_af_area (camera_h camera, int x, int y)
 Sets auto focus area.
int camera_attr_clear_af_area (camera_h camera)
 Clears the auto focus area.
int camera_attr_set_exposure_mode (camera_h camera, camera_attr_exposure_mode_e mode)
 Sets the exposure mode.
int camera_attr_get_exposure_mode (camera_h camera, camera_attr_exposure_mode_e *mode)
 Gets the exposure mode.
int camera_attr_set_exposure (camera_h camera, int value)
 Sets the exposure value.
int camera_attr_get_exposure (camera_h camera, int *value)
 Gets the exposure value.
int camera_attr_get_exposure_range (camera_h camera, int *min, int *max)
 Gets the available exposure value.
int camera_attr_set_iso (camera_h camera, camera_attr_iso_e iso)
 Sets the ISO level.
int camera_attr_get_iso (camera_h camera, camera_attr_iso_e *iso)
 Gets the ISO level.
int camera_attr_set_theater_mode (camera_h camera, camera_attr_theater_mode_e mode)
 Sets the theater mode.
int camera_attr_get_theater_mode (camera_h camera, camera_attr_theater_mode_e *mode)
 Gets the theater mode.
int camera_attr_set_brightness (camera_h camera, int level)
 Sets the brightness level.
int camera_attr_get_brightness (camera_h camera, int *level)
 Gets the brightness level.
int camera_attr_get_brightness_range (camera_h camera, int *min, int *max)
 Gets the available brightness level.
int camera_attr_set_contrast (camera_h camera, int level)
 Sets the contrast level.
int camera_attr_get_contrast (camera_h camera, int *level)
 Gets the contrast level.
int camera_attr_get_contrast_range (camera_h camera, int *min, int *max)
 Gets the available contrast level.
int camera_attr_set_hue (camera_h camera, int level)
 Sets the hue level.
int camera_attr_get_hue (camera_h camera, int *level)
 Gets the hue level.
int camera_attr_get_hue_range (camera_h camera, int *min, int *max)
 Gets the available hue level.
int camera_attr_set_whitebalance (camera_h camera, camera_attr_whitebalance_e whitebalance)
 Sets the white balance mode.
int camera_attr_get_whitebalance (camera_h camera, camera_attr_whitebalance_e *whitebalance)
 Gets the white balance mode.
int camera_attr_set_effect (camera_h camera, camera_attr_effect_mode_e effect)
 Sets the camera effect mode.
int camera_attr_get_effect (camera_h camera, camera_attr_effect_mode_e *effect)
 Gets the camera effect mode.
int camera_attr_set_scene_mode (camera_h camera, camera_attr_scene_mode_e mode)
 Sets the scene mode.
int camera_attr_get_scene_mode (camera_h camera, camera_attr_scene_mode_e *mode)
 Gets the scene mode.
int camera_attr_enable_tag (camera_h camera, bool enable)
 Enables to write EXIF (Exchangeable image file format) tags in a JPEG file.
int camera_attr_is_enabled_tag (camera_h camera, bool *enabled)
 Gets the value that indicates whether writing EXIF (Exchangeable image file format) tags in a JPEG file is enabled.
int camera_attr_set_tag_image_description (camera_h camera, const char *description)
 Sets the camera image description in the EXIF (Exchangeable image file format) tag.
int camera_attr_get_tag_image_description (camera_h camera, char **description)
 Gets the camera image description in EXIF (Exchangeable image file format) tag.
int camera_attr_set_tag_orientation (camera_h camera, camera_attr_tag_orientation_e orientation)
 Sets the camera orientation in the EXIF (Exchangeable image file format) tag.
int camera_attr_get_tag_orientation (camera_h camera, camera_attr_tag_orientation_e *orientation)
 Gets the camera orientation in the EXIF (Exchangeable image file format) tag.
int camera_attr_set_tag_software (camera_h camera, const char *software)
 Sets the software information in the EXIF (Exchangeable image file format) tag.
int camera_attr_get_tag_software (camera_h camera, char **software)
 Gets the software information in the EXIF (Exchangeable image file format) tag.
int camera_attr_set_geotag (camera_h camera, double latitude, double longitude, double altitude)
 Sets the geotag (GPS data) in the EXIF (Exchangeable image file format) tag.
int camera_attr_get_geotag (camera_h camera, double *latitude, double *longitude, double *altitude)
 Gets the geotag (GPS data) in the EXIF (Exchangeable image file format) tag.
int camera_attr_remove_geotag (camera_h camera)
 Removes the geotag (GPS data) in the EXIF (Exchangeable image file format) tag.
int camera_attr_set_flash_mode (camera_h camera, camera_attr_flash_mode_e mode)
 Sets the camera's flash mode.
int camera_attr_get_flash_mode (camera_h camera, camera_attr_flash_mode_e *mode)
 Gets the camera's flash mode.
int camera_attr_get_lens_orientation (camera_h camera, int *angle)
 Gets the camera len's orientation angle.
int camera_attr_set_stream_rotation (camera_h camera, camera_rotation_e rotation)
 Sets the stream rotation.
int camera_attr_get_stream_rotation (camera_h camera, camera_rotation_e *rotation)
 Gets the stream rotation.
int camera_attr_set_stream_flip (camera_h camera, camera_flip_e flip)
 Sets the stream flip.
int camera_attr_get_stream_flip (camera_h camera, camera_flip_e *flip)
 Gets the stream flip.
int camera_attr_set_hdr_mode (camera_h camera, camera_attr_hdr_mode_e mode)
 Sets the mode of HDR (High Dynamic Range) capture.
int camera_attr_get_hdr_mode (camera_h camera, camera_attr_hdr_mode_e *mode)
 Gets the mode of HDR (High Dynamic Range) capture.
int camera_attr_set_hdr_capture_progress_cb (camera_h camera, camera_attr_hdr_progress_cb callback, void *user_data)
 Sets a callback function to be invoked when HDR capture is progressing.
int camera_attr_unset_hdr_capture_progress_cb (camera_h camera)
 Unsets the HDR capture progress callback function.
int camera_attr_enable_anti_shake (camera_h camera, bool enable)
 Enables/Disables the anti-shake feature.
int camera_attr_is_enabled_anti_shake (camera_h camera, bool *enabled)
 Gets the state of the anti-shake feature.
int camera_attr_enable_video_stabilization (camera_h camera, bool enable)
 Enables/Disables the video stabilization feature.
int camera_attr_is_enabled_video_stabilization (camera_h camera, bool *enabled)
 Gets the state of the video stabilization feature.
int camera_attr_enable_auto_contrast (camera_h camera, bool enable)
 Enables/Disables auto contrast.
int camera_attr_is_enabled_auto_contrast (camera_h camera, bool *enabled)
 Gets the state of auto contrast.
int camera_attr_disable_shutter_sound (camera_h camera, bool disable)
 Disables shutter sound.
int camera_attr_set_pan (camera_h camera, camera_attr_ptz_move_type_e move_type, int pan_step)
 Sets the position to move horizontally.
int camera_attr_get_pan (camera_h camera, int *pan_step)
 Gets the current horizontal position of the camera.
int camera_attr_get_pan_range (camera_h camera, int *min, int *max)
 Gets lower limit and upper limit for pan position.
int camera_attr_set_tilt (camera_h camera, camera_attr_ptz_move_type_e move_type, int tilt_step)
 Sets the position to move vertically.
int camera_attr_get_tilt (camera_h camera, int *tilt_step)
 Gets the current vertical position of the camera.
int camera_attr_get_tilt_range (camera_h camera, int *min, int *max)
 Gets lower limit and upper limit for tilt position.
int camera_attr_set_ptz_type (camera_h camera, camera_attr_ptz_type_e ptz_type)
 Sets the type of PTZ (Pan Tilt Zoom).
int camera_attr_set_display_roi_area (camera_h camera, int x, int y, int width, int height)
 Sets the ROI (Region Of Interest) area of display.
int camera_attr_get_display_roi_area (camera_h camera, int *x, int *y, int *width, int *height)
 Gets the ROI (Region Of Interest) area of display.

Typedefs

typedef void(* camera_attr_hdr_progress_cb )(int percent, void *user_data)
 Invoked when the HDR capture process is updated.

Typedef Documentation

typedef void(* camera_attr_hdr_progress_cb)(int percent, void *user_data)

Invoked when the HDR capture process is updated.

Since :
2.3
Parameters:
[in]percentThe progress percentage of HDR capture
[in]user_dataThe user data passed from the callback registration function
Precondition:
camera_start_capture() will invoke this callback if you set it using camera_attr_set_hdr_capture_progress_cb().
See also:
camera_attr_get_hdr_mode()
camera_attr_set_hdr_capture_progress_cb()
camera_attr_unset_hdr_capture_progress_cb()
camera_attr_is_supported_hdr_capture()

Enumeration Type Documentation

enum camera_attr_af_mode_e

Enumeration for the auto focus mode.

Since :
2.3
Enumerator:
CAMERA_ATTR_AF_NONE 

auto-focus is not set

CAMERA_ATTR_AF_NORMAL 

auto-focus in the normal mode

CAMERA_ATTR_AF_MACRO 

auto-focus in the macro mode(close distance)

CAMERA_ATTR_AF_FULL 

auto-focus in the full mode(all range scan, limited by device spec)

enum camera_attr_effect_mode_e

Enumeration for the color tone, which provides the impression of looking through a tinted glass.

Since :
2.3
Enumerator:
CAMERA_ATTR_EFFECT_NONE 

None

CAMERA_ATTR_EFFECT_MONO 

Mono

CAMERA_ATTR_EFFECT_SEPIA 

Sepia

CAMERA_ATTR_EFFECT_NEGATIVE 

Negative

CAMERA_ATTR_EFFECT_BLUE 

Blue

CAMERA_ATTR_EFFECT_GREEN 

Green

CAMERA_ATTR_EFFECT_AQUA 

Aqua

CAMERA_ATTR_EFFECT_VIOLET 

Violet

CAMERA_ATTR_EFFECT_ORANGE 

Orange

CAMERA_ATTR_EFFECT_GRAY 

Gray

CAMERA_ATTR_EFFECT_RED 

Red

CAMERA_ATTR_EFFECT_ANTIQUE 

Antique

CAMERA_ATTR_EFFECT_WARM 

Warm

CAMERA_ATTR_EFFECT_PINK 

Pink

CAMERA_ATTR_EFFECT_YELLOW 

Yellow

CAMERA_ATTR_EFFECT_PURPLE 

Purple

CAMERA_ATTR_EFFECT_EMBOSS 

Emboss

CAMERA_ATTR_EFFECT_OUTLINE 

Outline

CAMERA_ATTR_EFFECT_SOLARIZATION 

Solarization

CAMERA_ATTR_EFFECT_SKETCH 

Sketch

CAMERA_ATTR_EFFECT_WASHED 

Washed

CAMERA_ATTR_EFFECT_VINTAGE_WARM 

Vintage warm

CAMERA_ATTR_EFFECT_VINTAGE_COLD 

Vintage cold

CAMERA_ATTR_EFFECT_POSTERIZATION 

Posterization

CAMERA_ATTR_EFFECT_CARTOON 

Cartoon

CAMERA_ATTR_EFFECT_SELECTIVE_RED 

Selective color - Red

CAMERA_ATTR_EFFECT_SELECTIVE_GREEN 

Selective color - Green

CAMERA_ATTR_EFFECT_SELECTIVE_BLUE 

Selective color - Blue

CAMERA_ATTR_EFFECT_SELECTIVE_YELLOW 

Selective color - Yellow

CAMERA_ATTR_EFFECT_SELECTIVE_RED_YELLOW 

Selective color - Red and Yellow

CAMERA_ATTR_EFFECT_OTHER_GRAPHICS 

Other Graphic effects

enum camera_attr_exposure_mode_e

Enumeration for the camera exposure modes.

Since :
2.3
Enumerator:
CAMERA_ATTR_EXPOSURE_MODE_OFF 

Off

CAMERA_ATTR_EXPOSURE_MODE_ALL 

All mode

CAMERA_ATTR_EXPOSURE_MODE_CENTER 

Center mode

CAMERA_ATTR_EXPOSURE_MODE_SPOT 

Spot mode

CAMERA_ATTR_EXPOSURE_MODE_CUSTOM 

Custom mode

enum camera_attr_flash_mode_e

Enumeration for the flash mode.

Since :
2.3
Enumerator:
CAMERA_ATTR_FLASH_MODE_OFF 

Always off

CAMERA_ATTR_FLASH_MODE_ON 

Always splashes

CAMERA_ATTR_FLASH_MODE_AUTO 

Depending on intensity of light, strobe starts to flash

CAMERA_ATTR_FLASH_MODE_REDEYE_REDUCTION 

Red eye reduction. Multiple flash before capturing

CAMERA_ATTR_FLASH_MODE_SLOW_SYNC 

Slow sync curtain synchronization

CAMERA_ATTR_FLASH_MODE_FRONT_CURTAIN 

Front curtain synchronization

CAMERA_ATTR_FLASH_MODE_REAR_CURTAIN 

Rear curtain synchronization

CAMERA_ATTR_FLASH_MODE_PERMANENT 

Keep turned on until turning off

enum camera_attr_fps_e

Enumeration to preview FPS.

Since :
2.3
Enumerator:
CAMERA_ATTR_FPS_AUTO 

AUTO FPS

CAMERA_ATTR_FPS_7 

7 FPS

CAMERA_ATTR_FPS_8 

8 FPS

CAMERA_ATTR_FPS_15 

15 FPS

CAMERA_ATTR_FPS_20 

20 FPS

CAMERA_ATTR_FPS_24 

24 FPS

CAMERA_ATTR_FPS_25 

25 FPS

CAMERA_ATTR_FPS_30 

30 FPS

CAMERA_ATTR_FPS_60 

60 FPS

CAMERA_ATTR_FPS_90 

90 FPS

CAMERA_ATTR_FPS_120 

120 FPS

enum camera_attr_hdr_mode_e

Enumeration for HDR capture mode.

Since :
2.3
Enumerator:
CAMERA_ATTR_HDR_MODE_DISABLE 

Disable HDR capture

CAMERA_ATTR_HDR_MODE_ENABLE 

Enable HDR capture

CAMERA_ATTR_HDR_MODE_KEEP_ORIGINAL 

Enable HDR capture and keep original image data

enum camera_attr_iso_e

Enumeration for the ISO levels of the camera.

Since :
2.3
Enumerator:
CAMERA_ATTR_ISO_AUTO 

ISO auto mode

CAMERA_ATTR_ISO_50 

ISO 50

CAMERA_ATTR_ISO_100 

ISO 100

CAMERA_ATTR_ISO_200 

ISO 200

CAMERA_ATTR_ISO_400 

ISO 400

CAMERA_ATTR_ISO_800 

ISO 800

CAMERA_ATTR_ISO_1600 

ISO 1600

CAMERA_ATTR_ISO_3200 

ISO 3200

enum camera_attr_ptz_move_type_e

Enumeration for PTZ (Pan Tilt Zoom) movement type.

Since :
3.0
Enumerator:
CAMERA_ATTR_PTZ_MOVE_ABSOLUTE 

Move to a specific coordinate position

CAMERA_ATTR_PTZ_MOVE_RELATIVE 

Move a specific distance from the current position

enum camera_attr_ptz_type_e

Enumeration for PTZ (Pan Tilt Zoom) type.

Since :
3.0
Enumerator:
CAMERA_ATTR_PTZ_TYPE_MECHANICAL 

Move the camera device physically

CAMERA_ATTR_PTZ_TYPE_ELECTRONIC 

Zoom digitally and move into portion of the image

enum camera_attr_scene_mode_e

Enumeration for the scene mode.

The mode of operation can be in daylight, night, or back-light.

Since :
2.3
Enumerator:
CAMERA_ATTR_SCENE_MODE_NORMAL 

Normal

CAMERA_ATTR_SCENE_MODE_PORTRAIT 

Portrait

CAMERA_ATTR_SCENE_MODE_LANDSCAPE 

Landscape

CAMERA_ATTR_SCENE_MODE_SPORTS 

Sports

CAMERA_ATTR_SCENE_MODE_PARTY_N_INDOOR 

Party & indoor

CAMERA_ATTR_SCENE_MODE_BEACH_N_INDOOR 

Beach & indoor

CAMERA_ATTR_SCENE_MODE_SUNSET 

Sunset

CAMERA_ATTR_SCENE_MODE_DUSK_N_DAWN 

Dusk & dawn

CAMERA_ATTR_SCENE_MODE_FALL_COLOR 

Fall

CAMERA_ATTR_SCENE_MODE_NIGHT_SCENE 

Night scene

CAMERA_ATTR_SCENE_MODE_FIREWORK 

Firework

CAMERA_ATTR_SCENE_MODE_TEXT 

Text

CAMERA_ATTR_SCENE_MODE_SHOW_WINDOW 

Show window

CAMERA_ATTR_SCENE_MODE_CANDLE_LIGHT 

Candle light

CAMERA_ATTR_SCENE_MODE_BACKLIGHT 

Backlight

CAMERA_ATTR_SCENE_MODE_AQUA 

Aqua

enum camera_attr_tag_orientation_e

Enumeration for the orientation values of tag.

Since :
2.3
Enumerator:
CAMERA_ATTR_TAG_ORIENTATION_TOP_LEFT 

Row #0 is at the top, Column #0 is to the left

CAMERA_ATTR_TAG_ORIENTATION_TOP_RIGHT 

Row #0 is at the top, Column #0 is to the right (flipped)

CAMERA_ATTR_TAG_ORIENTATION_BOTTOM_RIGHT 

Row #0 is at the bottom, Column #0 is to the right

CAMERA_ATTR_TAG_ORIENTATION_BOTTOM_LEFT 

Row #0 is at the bottom, Column #0 is to the left (flipped)

CAMERA_ATTR_TAG_ORIENTATION_LEFT_TOP 

Row #0 is to the left, Column #0 is at the top (flipped)

CAMERA_ATTR_TAG_ORIENTATION_RIGHT_TOP 

Row #0 is to the right, Column #0 is at the top

CAMERA_ATTR_TAG_ORIENTATION_RIGHT_BOTTOM 

Row #0 is to the right, Column #0 is at the bottom (flipped)

CAMERA_ATTR_TAG_ORIENTATION_LEFT_BOTTOM 

Row #0 is to the left, Column #0 is at the bottom

enum camera_attr_theater_mode_e

Enumeration for the theater mode.

Since :
2.3
Enumerator:
CAMERA_ATTR_THEATER_MODE_DISABLE 

Disable theater mode - External display shows same image as device display

CAMERA_ATTR_THEATER_MODE_ENABLE 

Enable theater mode - Preview image is displayed on external display with full screen mode, but preview image is not shown on device display

CAMERA_ATTR_THEATER_MODE_CLONE 

Clone mode - Preview image is displayed on external display with full screen mode. Also preview image is shown by the UI on device display

enum camera_attr_whitebalance_e

Enumeration for the white balance levels of the camera.

Since :
2.3
Enumerator:
CAMERA_ATTR_WHITE_BALANCE_NONE 

None

CAMERA_ATTR_WHITE_BALANCE_AUTOMATIC 

Automatic

CAMERA_ATTR_WHITE_BALANCE_DAYLIGHT 

Daylight

CAMERA_ATTR_WHITE_BALANCE_CLOUDY 

Cloudy

CAMERA_ATTR_WHITE_BALANCE_FLUORESCENT 

Fluorescent

CAMERA_ATTR_WHITE_BALANCE_INCANDESCENT 

Incandescent

CAMERA_ATTR_WHITE_BALANCE_SHADE 

Shade

CAMERA_ATTR_WHITE_BALANCE_HORIZON 

Horizon

CAMERA_ATTR_WHITE_BALANCE_FLASH 

Flash

CAMERA_ATTR_WHITE_BALANCE_CUSTOM 

Custom

Function Documentation

int camera_attr_clear_af_area ( camera_h  camera)

Clears the auto focus area.

Since :
2.3
Remarks:
The focusing area is set to the center.
Parameters:
[in]cameraThe handle to the camera
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInvalid operation
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_af_mode()
camera_attr_set_af_area()
int camera_attr_disable_shutter_sound ( camera_h  camera,
bool  disable 
)

Disables shutter sound.

Since :
2.3
Remarks:
In some countries, this operation is not permitted.
Parameters:
[in]cameraThe handle to the camera
[in]disableIf true shutter sound is disabled, otherwise false
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONDisabling shutter sound is not permitted
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
int camera_attr_enable_anti_shake ( camera_h  camera,
bool  enable 
)

Enables/Disables the anti-shake feature.

Since :
2.3
Remarks:
This feature is used for image capture.
Parameters:
[in]cameraThe handle to the camera
[in]enableIf true the anti-shake feature is enabled, otherwise false
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_is_enabled_anti_shake()
camera_attr_is_supported_anti_shake()
int camera_attr_enable_auto_contrast ( camera_h  camera,
bool  enable 
)

Enables/Disables auto contrast.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]enableIf true auto contrast is enabled, otherwise false
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED or CAMERA_STATE_PREVIEW.
See also:
camera_attr_is_enabled_auto_contrast()
int camera_attr_enable_tag ( camera_h  camera,
bool  enable 
)

Enables to write EXIF (Exchangeable image file format) tags in a JPEG file.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]enableIf true writing EXIF tags in a JPEG file is enabled, otherwise false
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_is_enabled_tag()
int camera_attr_enable_video_stabilization ( camera_h  camera,
bool  enable 
)

Enables/Disables the video stabilization feature.

Since :
2.3
Remarks:
If video stabilization is enabled, zero shutter lag is disabled.
This feature is used to record a video.
Parameters:
[in]cameraThe handle to the camera
[in]enableIf true video stabilization is enabled, otherwise false
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_is_enabled_video_stabilization()
camera_attr_is_supported_video_stabilization()
int camera_attr_get_af_mode ( camera_h  camera,
camera_attr_af_mode_e *  mode 
)

Gets the auto focus mode.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]modeThe auto focus mode
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_foreach_supported_af_mode()
camera_attr_set_af_mode()
camera_attr_af_mode_e
int camera_attr_get_brightness ( camera_h  camera,
int *  level 
)

Gets the brightness level.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]levelThe brightness level
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_brightness()
camera_attr_get_brightness_range()
int camera_attr_get_brightness_range ( camera_h  camera,
int *  min,
int *  max 
)

Gets the available brightness level.

Since :
2.3
Remarks:
If the min value is greater than the max value, it means that this feature is not supported.
Parameters:
[in]cameraThe handle to the camera
[out]minThe minimum brightness level
[out]maxThe maximum brightness level
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_brightness()
camera_attr_get_brightness()
int camera_attr_get_contrast ( camera_h  camera,
int *  level 
)

Gets the contrast level.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]levelThe contrast level
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_contrast()
camera_attr_get_contrast_range()
int camera_attr_get_contrast_range ( camera_h  camera,
int *  min,
int *  max 
)

Gets the available contrast level.

Since :
2.3
Remarks:
If the min value is greater than the max value, it means that this feature is not supported.
Parameters:
[in]cameraThe handle to the camera
[out]minThe minimum contrast level
[out]maxThe maximum contrast level
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_contrast()
camera_attr_get_contrast()
int camera_attr_get_display_roi_area ( camera_h  camera,
int *  x,
int *  y,
int *  width,
int *  height 
)

Gets the ROI (Region Of Interest) area of display.

Since :
3.0
Parameters:
[in]cameraThe handle to the camera
[out]xX coordinate of area
[out]yY coordinate of area
[out]widthWidth of area
[out]heightHeight of area
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_display_roi_area()
int camera_attr_get_effect ( camera_h  camera,
camera_attr_effect_mode_e *  effect 
)

Gets the camera effect mode.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]effectThe camera effect mode
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_foreach_supported_effect()
camera_attr_set_effect()
int camera_attr_get_encoded_preview_bitrate ( camera_h  camera,
int *  bitrate 
)

Gets the bit rate of encoded preview.

Since :
3.0
Parameters:
[in]cameraThe handle to the camera
[out]bitrateThe bit rate of encoded preview
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_encoded_preview_bitrate()
int camera_attr_get_encoded_preview_gop_interval ( camera_h  camera,
int *  interval 
)

Gets the GOP (Group Of Pictures) interval of encoded preview.

Since :
3.0
Parameters:
[in]cameraThe handle to the camera
[out]intervalThe GOP interval of encoded preview (millisecond)
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_encoded_preview_gop_interval()
int camera_attr_get_exposure ( camera_h  camera,
int *  value 
)

Gets the exposure value.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]valueThe exposure value
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_exposure()
int camera_attr_get_exposure_mode ( camera_h  camera,
camera_attr_exposure_mode_e *  mode 
)

Gets the exposure mode.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]modeThe exposure mode
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_exposure_mode()
camera_attr_foreach_supported_exposure_mode()
int camera_attr_get_exposure_range ( camera_h  camera,
int *  min,
int *  max 
)

Gets the available exposure value.

Since :
2.3
Remarks:
If the min value is greater than the max value, it means that this feature is not supported.
Parameters:
[in]cameraThe handle to the camera
[out]minThe minimum exposure value
[out]maxThe maximum exposure value
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_exposure()
int camera_attr_get_extra_preview_bitrate ( camera_h  camera,
int  stream_id,
int *  bitrate 
)

Gets the bitrate of extra preview.

Since :
7.0
Parameters:
[in]cameraThe handle to the camera
[in]stream_idThe id of extra preview stream
[out]bitrateThe bitrate(bps) of extra preview stream
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_extra_preview_bitrate()
int camera_attr_get_extra_preview_gop_interval ( camera_h  camera,
int  stream_id,
int *  interval 
)

Gets the GOP (Group Of Pictures) interval of extra preview.

Since :
7.0
Parameters:
[in]cameraThe handle to the camera
[in]stream_idThe id of extra preview stream
[out]intervalThe GOP interval of extra preview (millisecond)
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_extra_preview_gop_interval()
int camera_attr_get_flash_mode ( camera_h  camera,
camera_attr_flash_mode_e *  mode 
)

Gets the camera's flash mode.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]modeThe flash mode
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_foreach_supported_flash_mode()
camera_attr_set_flash_mode()
int camera_attr_get_geotag ( camera_h  camera,
double *  latitude,
double *  longitude,
double *  altitude 
)

Gets the geotag (GPS data) in the EXIF (Exchangeable image file format) tag.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]latitudeThe latitude data
[out]longitudeThe longitude data
[out]altitudeThe altitude data
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_geotag()
camera_attr_remove_geotag()
int camera_attr_get_hdr_mode ( camera_h  camera,
camera_attr_hdr_mode_e *  mode 
)

Gets the mode of HDR (High Dynamic Range) capture.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]modeThe mode of HDR capture
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_hdr_mode()
camera_attr_set_hdr_capture_progress_cb()
camera_attr_unset_hdr_capture_progress_cb()
camera_attr_is_supported_hdr_capture()
int camera_attr_get_hue ( camera_h  camera,
int *  level 
)

Gets the hue level.

Since :
5.0
Parameters:
[in]cameraThe handle to the camera
[out]levelThe hue level
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
See also:
camera_attr_set_hue()
camera_attr_get_hue_range()
int camera_attr_get_hue_range ( camera_h  camera,
int *  min,
int *  max 
)

Gets the available hue level.

Since :
5.0
Remarks:
If the min value is greater than the max value, it means that this feature is not supported.
Parameters:
[in]cameraThe handle to the camera
[out]minThe minimum hue level
[out]maxThe maximum hue level
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
See also:
camera_attr_set_hue()
camera_attr_get_hue()
int camera_attr_get_image_quality ( camera_h  camera,
int *  quality 
)

Gets the quality of a still image, which is captured.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]qualityThe quality of the image(1 ~ 100)
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_image_quality()
int camera_attr_get_iso ( camera_h  camera,
camera_attr_iso_e *  iso 
)

Gets the ISO level.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]isoThe ISO level
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_iso()
camera_attr_foreach_supported_iso()
int camera_attr_get_lens_orientation ( camera_h  camera,
int *  angle 
)

Gets the camera len's orientation angle.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]angleThe orientation angle
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_set_display_rotation()
int camera_attr_get_pan ( camera_h  camera,
int *  pan_step 
)

Gets the current horizontal position of the camera.

Since :
3.0
Parameters:
[in]cameraThe handle to the camera
[out]pan_stepThe current horizontal distance from the starting point.
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_pan()
camera_attr_get_pan_range()
int camera_attr_get_pan_range ( camera_h  camera,
int *  min,
int *  max 
)

Gets lower limit and upper limit for pan position.

Since :
3.0
Remarks:
If the min value is greater than the max value, it means that this feature is not supported.
Parameters:
[in]cameraThe handle to the camera
[out]minThe lower limit for pan
[out]maxThe upper limit for pan
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_pan()
camera_attr_get_pan()
int camera_attr_get_preview_fps ( camera_h  camera,
camera_attr_fps_e *  fps 
)

Gets the frames per second of a preview video stream.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]fpsThe frames per second of the preview video stream
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_preview_fps()
camera_attr_foreach_supported_fps()
int camera_attr_get_preview_frame_rotation ( camera_h  camera,
camera_rotation_e *  rotation 
)

Gets the rotation of preview frame.

Since :
7.0
Remarks:
The function should be called in camera_preview_cb(),
otherwise, it will return CAMERA_ERROR_INVALID_OPERATION.
Parameters:
[in]cameraThe handle to the camera
[out]rotationThe rotation of preview frame
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
int camera_attr_get_scene_mode ( camera_h  camera,
camera_attr_scene_mode_e *  mode 
)

Gets the scene mode.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]modeThe scene mode
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_foreach_supported_scene_mode()
camera_attr_set_scene_mode()
int camera_attr_get_stream_flip ( camera_h  camera,
camera_flip_e *  flip 
)

Gets the stream flip.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]flipThe stream flip
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED.
See also:
camera_attr_set_stream_rotation()
int camera_attr_get_stream_rotation ( camera_h  camera,
camera_rotation_e *  rotation 
)

Gets the stream rotation.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]rotationThe stream rotation
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED.
See also:
camera_attr_set_stream_rotation()
int camera_attr_get_tag_image_description ( camera_h  camera,
char **  description 
)

Gets the camera image description in EXIF (Exchangeable image file format) tag.

Since :
2.3
Remarks:
You must release description using free().
Parameters:
[in]cameraThe handle to the camera
[out]descriptionA pointer to a string
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_tag_image_description()
int camera_attr_get_tag_orientation ( camera_h  camera,
camera_attr_tag_orientation_e *  orientation 
)

Gets the camera orientation in the EXIF (Exchangeable image file format) tag.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]orientationThe camera orientation
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_tag_orientation()
int camera_attr_get_tag_software ( camera_h  camera,
char **  software 
)

Gets the software information in the EXIF (Exchangeable image file format) tag.

Since :
2.3
Remarks:
You must release software using free().
Parameters:
[in]cameraThe handle to the camera
[out]softwareA pointer to a string
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_tag_software()
int camera_attr_get_theater_mode ( camera_h  camera,
camera_attr_theater_mode_e *  mode 
)

Gets the theater mode.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]modeThe theater mode
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_theater_mode()
int camera_attr_get_tilt ( camera_h  camera,
int *  tilt_step 
)

Gets the current vertical position of the camera.

Since :
3.0
Parameters:
[in]cameraThe handle to the camera
[out]tilt_stepThe current vertical distance from the starting point.
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_tilt()
camera_attr_get_tilt_range()
int camera_attr_get_tilt_range ( camera_h  camera,
int *  min,
int *  max 
)

Gets lower limit and upper limit for tilt position.

Since :
3.0
Remarks:
If the min value is greater than the max value, it means that this feature is not supported.
Parameters:
[in]cameraThe handle to the camera
[out]minThe lower limit for tilt
[out]maxThe upper limit for tilt
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_tilt()
camera_attr_get_tilt()
int camera_attr_get_whitebalance ( camera_h  camera,
camera_attr_whitebalance_e *  whitebalance 
)

Gets the white balance mode.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]whitebalanceThe white balance mode
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_foreach_supported_whitebalance()
camera_attr_set_whitebalance()
int camera_attr_get_zoom ( camera_h  camera,
int *  zoom 
)

Gets the zoom level.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]zoomThe zoom level
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_zoom()
camera_attr_get_zoom_range()
int camera_attr_get_zoom_range ( camera_h  camera,
int *  min,
int *  max 
)

Gets the available zoom level.

Since :
2.3
Remarks:
If the min value is greater than the max value, it means that this feature is not supported.
Parameters:
[in]cameraThe handle to the camera
[out]minThe minimum zoom level
[out]maxThe maximum zoom level
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_zoom()
camera_attr_get_zoom()
int camera_attr_is_enabled_anti_shake ( camera_h  camera,
bool *  enabled 
)

Gets the state of the anti-shake feature.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]enabledThe state of anti-shake
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_enable_anti_shake()
camera_attr_is_supported_anti_shake()
int camera_attr_is_enabled_auto_contrast ( camera_h  camera,
bool *  enabled 
)

Gets the state of auto contrast.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]enabledThe state of auto contrast
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_enable_auto_contrast()
int camera_attr_is_enabled_tag ( camera_h  camera,
bool *  enabled 
)

Gets the value that indicates whether writing EXIF (Exchangeable image file format) tags in a JPEG file is enabled.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]enabledIf true camera information is enabled, otherwise false
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_enable_tag()
int camera_attr_is_enabled_video_stabilization ( camera_h  camera,
bool *  enabled 
)

Gets the state of the video stabilization feature.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[out]enabledThe state of video stabilization
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_enable_video_stabilization()
camera_attr_is_supported_video_stabilization()
int camera_attr_remove_geotag ( camera_h  camera)

Removes the geotag (GPS data) in the EXIF (Exchangeable image file format) tag.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED or CAMERA_STATE_PREVIEW.
See also:
camera_attr_set_geotag()
camera_attr_get_geotag()
int camera_attr_set_af_area ( camera_h  camera,
int  x,
int  y 
)

Sets auto focus area.

Since :
2.3
Remarks:
It will return CAMERA_ERROR_INVALID_OPERATION in the CAMERA_ATTR_AF_NONE mode.
The coordinates are mapped to preview area.
Parameters:
[in]cameraThe handle to the camera
[in]xThe x coordinates of the focus area
[in]yThe y coordinates of the focus area
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInvalid operation
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED or CAMERA_STATE_PREVIEW.
See also:
camera_attr_set_af_mode()
camera_attr_clear_af_area()
int camera_attr_set_af_mode ( camera_h  camera,
camera_attr_af_mode_e  mode 
)

Sets the auto focus mode.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]modeThe auto focus mode
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED or CAMERA_STATE_PREVIEW.
See also:
camera_attr_get_af_mode()
camera_attr_foreach_supported_af_mode()
camera_attr_af_mode_e
int camera_attr_set_brightness ( camera_h  camera,
int  level 
)

Sets the brightness level.

Since :
2.3
Remarks:
If the min value is greater than the max value from camera_attr_get_brightness_range(),
it means that this feature is not supported.
Parameters:
[in]cameraThe handle to the camera
[in]levelThe brightness level
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED or CAMERA_STATE_PREVIEW.
See also:
camera_attr_get_brightness()
camera_attr_get_brightness_range()
int camera_attr_set_contrast ( camera_h  camera,
int  level 
)

Sets the contrast level.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]levelThe contrast level
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED or CAMERA_STATE_PREVIEW.
See also:
camera_attr_get_contrast()
camera_attr_get_contrast_range()
int camera_attr_set_display_roi_area ( camera_h  camera,
int  x,
int  y,
int  width,
int  height 
)

Sets the ROI (Region Of Interest) area of display.

Since :
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.
The minimum value of width and height are 1.
ROI area can be set before setting ROI display mode. (since 4.0)
Parameters:
[in]cameraThe handle to the camera
[in]xX coordinate of area
[in]yY coordinate of area
[in]widthWidth of area
[in]heightHeight of area
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_get_display_roi_area()
int camera_attr_set_effect ( camera_h  camera,
camera_attr_effect_mode_e  effect 
)

Sets the camera effect mode.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]effectThe camera effect mode
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED or CAMERA_STATE_PREVIEW.
See also:
camera_attr_foreach_supported_effect()
camera_attr_get_effect()
int camera_attr_set_encoded_preview_bitrate ( camera_h  camera,
int  bitrate 
)

Sets the bit rate of encoded preview.

Since :
3.0
Remarks:
The recommended range is from 1,000 (1 kbps) to 100,000,000 (100 Mbps).
But, due to codec limitations, it may not apply.
Parameters:
[in]cameraThe handle to the camera
[in]bitrateThe bit rate of encoded preview
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_get_encoded_preview_bitrate()
int camera_attr_set_encoded_preview_gop_interval ( camera_h  camera,
int  interval 
)

Sets the GOP (Group Of Pictures) interval of encoded preview.

Since :
3.0
Remarks:
The recommended range is from 1,000 (1 second) to 600,000 (10 minutes).
But, due to codec limitations, it may not apply.
Parameters:
[in]cameraThe handle to the camera
[in]intervalThe GOP interval of encoded preview (millisecond)
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_get_encoded_preview_gop_interval()
int camera_attr_set_exposure ( camera_h  camera,
int  value 
)

Sets the exposure value.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]valueThe exposure value
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_get_exposure()
int camera_attr_set_exposure_mode ( camera_h  camera,
camera_attr_exposure_mode_e  mode 
)

Sets the exposure mode.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]modeThe exposure mode
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED or CAMERA_STATE_PREVIEW.
See also:
camera_attr_get_exposure_mode()
camera_attr_foreach_supported_exposure_mode()
int camera_attr_set_extra_preview_bitrate ( camera_h  camera,
int  stream_id,
int  bitrate 
)

Sets the bitrate of extra preview.

Since :
7.0
Parameters:
[in]cameraThe handle to the camera
[in]stream_idThe id of extra preview stream
[in]bitrateThe bitrate(bps) of extra preview
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_get_extra_preview_bitrate()
int camera_attr_set_extra_preview_gop_interval ( camera_h  camera,
int  stream_id,
int  interval 
)

Sets the GOP (Group Of Pictures) interval of extra preview.

Since :
7.0
Remarks:
The recommended range is from 1,000 (1 second) to 600,000 (10 minutes).
But, due to codec limitations, it may not apply.
Parameters:
[in]cameraThe handle to the camera
[in]stream_idThe id of extra preview stream
[in]intervalThe GOP interval of extra preview (millisecond)
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_get_extra_preview_gop_interval()
int camera_attr_set_flash_mode ( camera_h  camera,
camera_attr_flash_mode_e  mode 
)

Sets the camera's flash mode.

Since :
2.3
Remarks:
Since 2.4, while setting the flash mode, if the flash was preempted by other APIs,
then this function returns CAMERA_ERROR_DEVICE_BUSY error.
Parameters:
[in]cameraThe handle to the camera
[in]modeThe flash mode
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
CAMERA_ERROR_DEVICE_BUSYThe flash was preempted by other API
Precondition:
The camera state must be set to CAMERA_STATE_CREATED or CAMERA_STATE_PREVIEW.
See also:
camera_attr_foreach_supported_flash_mode()
camera_attr_get_flash_mode()
int camera_attr_set_geotag ( camera_h  camera,
double  latitude,
double  longitude,
double  altitude 
)

Sets the geotag (GPS data) in the EXIF (Exchangeable image file format) tag.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]latitudeThe latitude data
[in]longitudeThe longitude data
[in]altitudeThe altitude data
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED or CAMERA_STATE_PREVIEW.
See also:
camera_attr_get_geotag()
camera_attr_remove_geotag()
int camera_attr_set_hdr_capture_progress_cb ( camera_h  camera,
camera_attr_hdr_progress_cb  callback,
void *  user_data 
)

Sets a callback function to be invoked when HDR capture is progressing.

Since :
2.3
Remarks:
This callback notifies progress of the HDR process.
Parameters:
[in]cameraThe handle to the camera
[in]callbackThe callback function to be invoked
[in]user_dataThe user data passed to the callback registration function
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_hdr_mode()
camera_attr_get_hdr_mode()
camera_attr_unset_hdr_capture_progress_cb()
camera_attr_is_supported_hdr_capture()
int camera_attr_set_hdr_mode ( camera_h  camera,
camera_attr_hdr_mode_e  mode 
)

Sets the mode of HDR (High Dynamic Range) capture.

Since :
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.
If this attribute is set to true. camera_attr_hdr_progress_cb() is invoked during capture.
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.
Parameters:
[in]cameraThe handle to the camera
[in]modeThe mode of HDR capture
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED or CAMERA_STATE_PREVIEW.
See also:
camera_attr_get_hdr_mode()
camera_attr_set_hdr_capture_progress_cb()
camera_attr_unset_hdr_capture_progress_cb()
camera_attr_is_supported_hdr_capture()
int camera_attr_set_hue ( camera_h  camera,
int  level 
)

Sets the hue level.

Since :
5.0
Parameters:
[in]cameraThe handle to the camera
[in]levelThe hue level
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
See also:
camera_attr_get_hue()
camera_attr_get_hue_range()
int camera_attr_set_image_quality ( camera_h  camera,
int  quality 
)

Sets quality of the image.

The range for image quality is 1 to 100. If quality is out of range, CAMERA_ERROR_INVALID_PARAMETER error occurred.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]qualityThe quality of image (1 ~ 100)
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED or CAMERA_STATE_PREVIEW.
See also:
camera_start_preview()
camera_attr_get_image_quality()
int camera_attr_set_iso ( camera_h  camera,
camera_attr_iso_e  iso 
)

Sets the ISO level.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]isoThe ISO level
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED or CAMERA_STATE_PREVIEW.
See also:
camera_attr_get_iso()
camera_attr_foreach_supported_iso()
int camera_attr_set_pan ( camera_h  camera,
camera_attr_ptz_move_type_e  move_type,
int  pan_step 
)

Sets the position to move horizontally.

Since :
3.0
Parameters:
[in]cameraThe handle to the camera
[in]move_typeThe PTZ (Pan Tilt Zoom) move type
[in]pan_stepThe step to move the camera
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_PREVIEW.
See also:
camera_attr_get_pan()
camera_attr_get_pan_range()
int camera_attr_set_preview_fps ( camera_h  camera,
camera_attr_fps_e  fps 
)

Sets the preview frame rate.

Since :
2.3
Remarks:
This function should be called before previewing (see camera_start_preview()).
Parameters:
[in]cameraThe handle to the camera
[in]fpsThe frame rate
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED.
See also:
camera_start_preview()
camera_attr_get_preview_fps()
camera_attr_foreach_supported_fps()
int camera_attr_set_ptz_type ( camera_h  camera,
camera_attr_ptz_type_e  ptz_type 
)

Sets the type of PTZ (Pan Tilt Zoom).

Since :
3.0
Parameters:
[in]cameraThe handle to the camera
[in]ptz_typePTZ type
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_PREVIEW.
See also:
camera_attr_get_pan()
camera_attr_set_pan()
camera_attr_get_pan_range()
camera_attr_get_tilt()
camera_attr_set_tilt()
camera_attr_get_tilt_range()
camera_attr_foreach_supported_ptz_type()
int camera_attr_set_scene_mode ( camera_h  camera,
camera_attr_scene_mode_e  mode 
)

Sets the scene mode.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]modeThe scene mode
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED or CAMERA_STATE_PREVIEW.
See also:
camera_attr_foreach_supported_scene_mode()
camera_attr_get_scene_mode()
int camera_attr_set_stream_flip ( camera_h  camera,
camera_flip_e  flip 
)

Sets the stream flip.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]flipThe stream flip
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED.
See also:
camera_attr_set_stream_rotation()
int camera_attr_set_stream_rotation ( camera_h  camera,
camera_rotation_e  rotation 
)

Sets the stream rotation.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]rotationThe stream rotation
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED.
See also:
camera_attr_get_stream_rotation()
int camera_attr_set_tag_image_description ( camera_h  camera,
const char *  description 
)

Sets the camera image description in the EXIF (Exchangeable image file format) tag.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]descriptionThe string with description
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_get_tag_image_description()
int camera_attr_set_tag_orientation ( camera_h  camera,
camera_attr_tag_orientation_e  orientation 
)

Sets the camera orientation in the EXIF (Exchangeable image file format) tag.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]orientationThe camera orientation
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_get_tag_orientation()
int camera_attr_set_tag_software ( camera_h  camera,
const char *  software 
)

Sets the software information in the EXIF (Exchangeable image file format) tag.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]softwareThe software information tag
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_get_tag_software()
int camera_attr_set_theater_mode ( camera_h  camera,
camera_attr_theater_mode_e  mode 
)

Sets the theater mode.

Since :
2.3
Remarks:
If you want to display the preview image on the external display with the full screen mode, use this function.
Parameters:
[in]cameraThe handle to the camera
[in]modeThe theater mode
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
This function is valid only when the external display is connected.
See also:
camera_attr_get_theater_mode()
int camera_attr_set_tilt ( camera_h  camera,
camera_attr_ptz_move_type_e  move_type,
int  tilt_step 
)

Sets the position to move vertically.

Since :
3.0
Parameters:
[in]cameraThe handle to the camera
[in]move_typeThe PTZ (Pan Tilt Zoom) move type
[in]tilt_stepThe step to move the camera
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_OPERATIONInternal error
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_PREVIEW.
See also:
camera_attr_get_tilt()
camera_attr_get_tilt_range()
int camera_attr_set_whitebalance ( camera_h  camera,
camera_attr_whitebalance_e  whitebalance 
)

Sets the white balance mode.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]whitebalanceThe white balance mode
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED or CAMERA_STATE_PREVIEW.
See also:
camera_attr_foreach_supported_whitebalance()
camera_attr_get_whitebalance()
int camera_attr_set_zoom ( camera_h  camera,
int  zoom 
)

Sets the zoom level.

The range for the zoom level is received from camera_attr_get_zoom_range(). If zoom is out of range, the CAMERA_ERROR_INVALID_PARAMETER error occurs.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
[in]zoomThe zoom level
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_INVALID_STATEInvalid state
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
Precondition:
The camera state must be set to CAMERA_STATE_CREATED or CAMERA_STATE_PREVIEW.
See also:
camera_attr_get_zoom()
camera_attr_get_zoom_range()
int camera_attr_unset_hdr_capture_progress_cb ( camera_h  camera)

Unsets the HDR capture progress callback function.

Since :
2.3
Parameters:
[in]cameraThe handle to the camera
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTEDThe socket to multimedia server is disconnected
See also:
camera_attr_set_hdr_mode()
camera_attr_get_hdr_mode()
camera_attr_set_hdr_capture_progress_cb()
camera_attr_is_supported_hdr_capture()