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_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)
	Registers a callback function to be called when HDR capture is progressing.
int	camera_attr_unset_hdr_capture_progress_cb (camera_h camera)
	Unregisters the 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 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 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)
	Called when the HDR capture process is updated.

Typedef Documentation

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

Called when the HDR capture process is updated.

Since :: 2.3.1

Parameters:

[in]	percent	The progress percentage of HDR capture
[in]	user_data	The user data passed from the callback registration function

Precondition:: camera_start_capture() will invoke this callback if you register 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.1

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.1

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.1

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.1

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.1

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.1

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.1

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.1

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.1

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.1

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.1

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.1

Remarks:: The focusing area is set to the center.

Parameters:

[in] camera The handle to the camera

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_OPERATION	Invalid operation
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Remarks:: In some countries, this operation is not permitted.

Parameters:

[in]	camera	The handle to the camera
[in]	disable	If `true` shutter sound is disabled, otherwise `false`

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_OPERATION	Disabling shutter sound is not permitted
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Remarks:: This feature is used for image capture.

Parameters:

[in]	camera	The handle to the camera
[in]	enable	If `true` the anti-shake feature is enabled, otherwise `false`

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	enable	If `true` auto contrast is enabled, otherwise `false`

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	enable	If `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_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Remarks:: If video stabilization is enabled, zero shutter lag is disabled.
This feature is used to record a video.

Parameters:

[in]	camera	The handle to the camera
[in]	enable	If `true` video stabilization is enabled, otherwise `false`

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	mode	The auto focus mode

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	level	The brightness level

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Remarks:: If the min value is greater than the max value, it means that this feature is not supported.

Parameters:

[in]	camera	The handle to the camera
[out]	min	The minimum brightness level
[out]	max	The maximum brightness level

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	level	The contrast level

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Remarks:: If the min value is greater than the max value, it means that this feature is not supported.

Parameters:

[in]	camera	The handle to the camera
[out]	min	The minimum contrast level
[out]	max	The maximum contrast level

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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]	camera	The handle to the camera
[out]	x	X coordinate of area
[out]	y	Y coordinate of area
[out]	width	Width of area
[out]	height	Height of area

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_OPERATION	Internal error
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	effect	The camera effect mode

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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]	camera	The handle to the camera
[out]	bitrate	The bit rate of encoded preview

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_OPERATION	Internal error
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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]	camera	The handle to the camera
[out]	interval	The GOP interval of encoded preview (millisecond)

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_OPERATION	Internal error
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	value	The exposure value

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	mode	The exposure mode

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Remarks:: If the min value is greater than the max value, it means that this feature is not supported.

Parameters:

[in]	camera	The handle to the camera
[out]	min	The minimum exposure value
[out]	max	The maximum exposure value

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

See also:: camera_attr_set_exposure()

int camera_attr_get_flash_mode	(	camera_h	camera,
		camera_attr_flash_mode_e *	mode
	)

Gets the camera's flash mode.

Since :: 2.3.1

Parameters:

[in]	camera	The handle to the camera
[out]	mode	The flash mode

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	latitude	The latitude data
[out]	longitude	The longitude data
[out]	altitude	The altitude data

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	mode	The mode of HDR capture

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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]	camera	The handle to the camera
[out]	level	The hue level

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported

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]	camera	The handle to the camera
[out]	min	The minimum hue level
[out]	max	The maximum hue level

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported

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.1

Parameters:

[in]	camera	The handle to the camera
[out]	quality	The quality of the image(1 ~ 100)

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	iso	The ISO level

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	angle	The orientation angle

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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 position of the camera.

Since :: 3.0

Parameters:

[in]	camera	The handle to the camera
[out]	pan_step	The current horizontal distance from the starting point.

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_OPERATION	Internal error
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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]	camera	The handle to the camera
[out]	min	The lower limit for pan
[out]	max	The upper limit for pan

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_OPERATION	Internal error
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	fps	The frames per second of the preview video stream

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

See also:: camera_attr_set_preview_fps(); camera_attr_foreach_supported_fps()

int camera_attr_get_scene_mode	(	camera_h	camera,
		camera_attr_scene_mode_e *	mode
	)

Gets the scene mode.

Since :: 2.3.1

Parameters:

[in]	camera	The handle to the camera
[out]	mode	The scene mode

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	flip	The stream flip

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	rotation	The stream rotation

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Remarks:: You must release description using free().

Parameters:

[in]	camera	The handle to the camera
[out]	description	A pointer to a string

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	orientation	The camera orientation

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Remarks:: You must release software using free().

Parameters:

[in]	camera	The handle to the camera
[out]	software	A pointer to a string

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	mode	The theater mode

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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 position of the camera.

Since :: 3.0

Parameters:

[in]	camera	The handle to the camera
[out]	tilt_step	The current vertical distance from the starting point.

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_OPERATION	Internal error
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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]	camera	The handle to the camera
[out]	min	The lower limit for tilt
[out]	max	The upper limit for tilt

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_OPERATION	Internal error
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	whitebalance	The white balance mode

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	zoom	The zoom level

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Remarks:: If the min value is greater than the max value, it means that this feature is not supported.

Parameters:

[in]	camera	The handle to the camera
[out]	min	The minimum zoom level
[out]	max	The maximum zoom level

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	enabled	The state of anti-shake

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	enabled	The state of auto contrast

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	enabled	If `true` camera information is enabled, otherwise `false`

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[out]	enabled	The state of video stabilization

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in] camera The handle to the camera

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Remarks:: This API is invalid in the CAMERA_ATTR_AF_NONE mode.
The coordinates are mapped to preview area.

Parameters:

[in]	camera	The handle to the camera
[in]	x	The x coordinates of the focus area
[in]	y	The y coordinates of the focus area

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_OPERATION	Invalid operation
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	mode	The auto focus mode

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

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]	camera	The handle to the camera
[in]	level	The brightness level

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	level	The contrast level

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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]	camera	The handle to the camera
[in]	x	X coordinate of area
[in]	y	Y coordinate of area
[in]	width	Width of area
[in]	height	Height of area

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_OPERATION	Internal error
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	effect	The camera effect mode

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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]	camera	The handle to the camera
[in]	bitrate	The bit rate of encoded preview

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_OPERATION	Internal error
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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]	camera	The handle to the camera
[in]	interval	The GOP interval of encoded preview (millisecond)

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_OPERATION	Internal error
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	value	The exposure value

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	mode	The exposure mode

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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_flash_mode	(	camera_h	camera,
		camera_attr_flash_mode_e	mode
	)

Sets the camera's flash mode.

Since :: 2.3.1

Remarks:: Since 3.0, while setting the flash mode, if the flash was preempted by other APIs,
then this function returns CAMERA_ERROR_DEVICE_BUSY error.

Parameters:

[in]	camera	The handle to the camera
[in]	mode	The flash mode

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected
CAMERA_ERROR_DEVICE_BUSY	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	latitude	The latitude data
[in]	longitude	The longitude data
[in]	altitude	The altitude data

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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
	)

Registers a callback function to be called when HDR capture is progressing.

Since :: 2.3.1

Remarks:: This callback notifies progress of the HDR process.

Parameters:

[in]	camera	The handle to the camera
[in]	callback	The callback function to invoke
[in]	user_data	The user data passed to the callback registration function

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

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]	camera	The handle to the camera
[in]	mode	The mode of HDR capture

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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]	camera	The handle to the camera
[in]	level	The hue level

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported

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.1

Parameters:

[in]	camera	The handle to the camera
[in]	quality	The quality of image (1 ~ 100)

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	iso	The ISO level

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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]	camera	The handle to the camera
[in]	move_type	The PTZ(Pan Tilt Zoom) move type
[in]	pan_step	The step to move the camera

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_OPERATION	Internal error
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Remarks:: This function should be called before previewing (see camera_start_preview()).

Parameters:

[in]	camera	The handle to the camera
[in]	fps	The frame rate

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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]	camera	The handle to the camera
[in]	ptz_type	PTZ type

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_OPERATION	Internal error
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	mode	The scene mode

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	flip	The stream flip

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	rotation	The stream rotation

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	description	The string with description

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	orientation	The camera orientation

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	software	The software information tag

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Remarks:: If you want to display the preview image on the external display with the full screen mode, use this function.

Parameters:

[in]	camera	The handle to the camera
[in]	mode	The theater mode

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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]	camera	The handle to the camera
[in]	move_type	The PTZ(Pan Tilt Zoom) move type
[in]	tilt_step	The step to move the camera

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_OPERATION	Internal error
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	whitebalance	The white balance mode

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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.1

Parameters:

[in]	camera	The handle to the camera
[in]	zoom	The zoom level

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_STATE	Invalid state
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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 )

Unregisters the callback function.

Since :: 2.3.1

Parameters:

[in] camera The handle to the camera

Returns:: 0 on success, otherwise a negative error value

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_SERVICE_DISCONNECTED	The 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()

Required Header

Overview

Foreach Operations

Related Features

Functions

Typedefs

Typedef Documentation

Enumeration Type Documentation

Function Documentation