Tizen Native API
Capability

The Capability API provides capability information of the camera.

Required Header

#include <camera.h>

Overview

The Camera Capability API provides functions to obtain capability information of the camera device.

Related Features

This API is related with the following features:

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

bool camera_is_supported_continuous_capture (camera_h camera)
 Gets continuous capture feature's supported state.
int camera_foreach_supported_preview_resolution (camera_h camera, camera_supported_preview_resolution_cb callback, void *user_data)
 Retrieves all supported camera preview resolutions by invoking the callback function once for each supported camera preview resolution.
int camera_foreach_supported_capture_resolution (camera_h camera, camera_supported_capture_resolution_cb callback, void *user_data)
 Retrieves all supported camera captured resolutions by invoking the callback function once for each supported camera capture resolution.
int camera_foreach_supported_capture_format (camera_h camera, camera_supported_capture_format_cb callback, void *user_data)
 Retrieves all supported camera capture formats by invoking the callback function once for each supported camera capture format.
int camera_foreach_supported_preview_format (camera_h camera, camera_supported_preview_format_cb callback, void *user_data)
 Retrieves all supported camera preview formats by invoking the callback function once for each supported camera preview format.
bool camera_is_supported_face_detection (camera_h camera)
 Gets the face detection feature's supported state.
bool camera_is_supported_zero_shutter_lag (camera_h camera)
 Gets the zero shutter lag feature's supported state.
int camera_get_device_count (camera_h camera, int *device_count)
 Gets the camera device count.
bool camera_is_supported_media_packet_preview_cb (camera_h camera)
 Gets the media packet preview callback feature's supported state.
int camera_attr_foreach_supported_fps (camera_h camera, camera_attr_supported_fps_cb callback, void *user_data)
 Retrieves all supported FPS modes by invoking the callback function once for each supported FPS mode.
int camera_attr_foreach_supported_af_mode (camera_h camera, camera_attr_supported_af_mode_cb callback, void *user_data)
 Retrieves all supported auto focus modes by invoking the callback function once for each supported auto focus mode.
int camera_attr_foreach_supported_exposure_mode (camera_h camera, camera_attr_supported_exposure_mode_cb callback, void *user_data)
 Retrieves all supported exposure modes by invoking the callback function once for each supported exposure mode.
int camera_attr_foreach_supported_iso (camera_h camera, camera_attr_supported_iso_cb callback, void *user_data)
 Retrieves all supported ISO levels by invoking the callback function once for each supported ISO level.
int camera_attr_foreach_supported_theater_mode (camera_h camera, camera_attr_supported_theater_mode_cb callback, void *user_data)
 Retrieves all supported theater modes by invoking callback function once for each supported theater modes.
int camera_attr_foreach_supported_whitebalance (camera_h camera, camera_attr_supported_whitebalance_cb callback, void *user_data)
 Retrieves all supported white balances by invoking the callback function once for each supported white balance.
int camera_attr_foreach_supported_effect (camera_h camera, camera_attr_supported_effect_cb callback, void *user_data)
 Retrieves all supported effect modes by invoking the callback function once for each supported effect mode.
int camera_attr_foreach_supported_scene_mode (camera_h camera, camera_attr_supported_scene_mode_cb callback, void *user_data)
 Retrieves all supported scene modes by invoking the callback function once for each supported scene mode.
int camera_attr_foreach_supported_flash_mode (camera_h camera, camera_attr_supported_flash_mode_cb callback, void *user_data)
 Retrieves all supported flash modes by invoking the callback function once for each supported flash mode.
int camera_attr_foreach_supported_stream_rotation (camera_h camera, camera_attr_supported_stream_rotation_cb callback, void *user_data)
 Retrieves all supported stream rotation modes by invoking callback function once for each supported stream rotation mode.
int camera_attr_foreach_supported_stream_flip (camera_h camera, camera_attr_supported_stream_flip_cb callback, void *user_data)
 Retrieves all supported stream flip modes by invoking callback function once for each supported stream flip mode.
bool camera_attr_is_supported_hdr_capture (camera_h camera)
 Gets the support state of HDR capture.
bool camera_attr_is_supported_anti_shake (camera_h camera)
 Gets the support state of the anti-shake feature.
bool camera_attr_is_supported_video_stabilization (camera_h camera)
 Gets the support state of the video stabilization feature.
bool camera_attr_is_supported_auto_contrast (camera_h camera)
 Gets state of support of auto contrast feature.

Typedefs

typedef bool(* camera_supported_preview_resolution_cb )(int width, int height, void *user_data)
 Called once for each supported preview resolution.
typedef bool(* camera_supported_capture_resolution_cb )(int width, int height, void *user_data)
 Called once for each supported capture resolution.
typedef bool(* camera_supported_capture_format_cb )(camera_pixel_format_e format, void *user_data)
 Called once for the pixel format of each supported capture format.
typedef bool(* camera_supported_preview_format_cb )(camera_pixel_format_e format, void *user_data)
 Called once for the pixel format of each supported preview format.
typedef bool(* camera_attr_supported_af_mode_cb )(camera_attr_af_mode_e mode, void *user_data)
 Called to get each supported auto-focus mode.
typedef bool(* camera_attr_supported_exposure_mode_cb )(camera_attr_exposure_mode_e mode, void *user_data)
 Called to get each supported exposure mode.
typedef bool(* camera_attr_supported_iso_cb )(camera_attr_iso_e iso, void *user_data)
 Called to get each supported ISO mode.
typedef bool(* camera_attr_supported_whitebalance_cb )(camera_attr_whitebalance_e wb, void *user_data)
 Called to get each supported white balance.
typedef bool(* camera_attr_supported_effect_cb )(camera_attr_effect_mode_e effect, void *user_data)
 Called to get each supported effect mode.
typedef bool(* camera_attr_supported_scene_mode_cb )(camera_attr_scene_mode_e mode, void *user_data)
 Called to get each supported scene mode.
typedef bool(* camera_attr_supported_flash_mode_cb )(camera_attr_flash_mode_e mode, void *user_data)
 Called to get each supported flash mode.
typedef bool(* camera_attr_supported_fps_cb )(camera_attr_fps_e fps, void *user_data)
 Called to get each supported FPS mode.
typedef bool(* camera_attr_supported_stream_flip_cb )(camera_flip_e flip, void *user_data)
 Called to get each supported stream flip mode.
typedef bool(* camera_attr_supported_stream_rotation_cb )(camera_rotation_e rotation, void *user_data)
 Called to get each supported stream rotation mode.
typedef bool(* camera_attr_supported_theater_mode_cb )(camera_attr_theater_mode_e mode, void *user_data)
 Called to get each supported theater mode.

Typedef Documentation

typedef bool(* camera_attr_supported_af_mode_cb)(camera_attr_af_mode_e mode, void *user_data)

Called to get each supported auto-focus mode.

Parameters:
[in]modeThe supported auto-focus mode
[in]user_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop,
otherwise false to break out of the loop
Precondition:
camera_attr_foreach_supported_af_mode() will invoke this callback.
See also:
camera_attr_foreach_supported_af_mode()
typedef bool(* camera_attr_supported_effect_cb)(camera_attr_effect_mode_e effect, void *user_data)

Called to get each supported effect mode.

Parameters:
[in]effectThe supported effect mode
[in]user_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop,
otherwise false to break out of the loop
Precondition:
camera_attr_foreach_supported_effect() will invoke this callback.
See also:
camera_attr_foreach_supported_effect()

Called to get each supported exposure mode.

Parameters:
[in]modeThe supported exposure mode
[in]user_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop,
otherwise false to break out of the loop
Precondition:
camera_attr_foreach_supported_exposure_mode() will invoke this callback.
See also:
camera_attr_foreach_supported_exposure_mode()
camera_attr_exposure_mode_e
typedef bool(* camera_attr_supported_flash_mode_cb)(camera_attr_flash_mode_e mode, void *user_data)

Called to get each supported flash mode.

Parameters:
[in]modeThe supported flash mode
[in]user_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop,
otherwise false to break out of the loop
Precondition:
camera_attr_foreach_supported_flash_mode() will invoke this callback.
See also:
camera_attr_foreach_supported_flash_mode()
typedef bool(* camera_attr_supported_fps_cb)(camera_attr_fps_e fps, void *user_data)

Called to get each supported FPS mode.

Parameters:
[in]modeThe supported FPS mode
[in]user_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop,
otherwise false to break out of the loop
Precondition:
camera_attr_foreach_supported_fps() will invoke this callback.
See also:
camera_attr_foreach_supported_fps()
typedef bool(* camera_attr_supported_iso_cb)(camera_attr_iso_e iso, void *user_data)

Called to get each supported ISO mode.

Parameters:
[in]isoThe supported ISO mode
[in]user_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop,
otherwise false to break out of the loop
Precondition:
camera_attr_foreach_supported_iso() will invoke this callback.
See also:
camera_attr_foreach_supported_iso()
typedef bool(* camera_attr_supported_scene_mode_cb)(camera_attr_scene_mode_e mode, void *user_data)

Called to get each supported scene mode.

Parameters:
[in]modeThe supported scene mode
[in]user_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop,
otherwise false to break out of the loop
Precondition:
camera_attr_foreach_supported_scene_mode() will invoke this callback.
See also:
camera_attr_foreach_supported_scene_mode()
camera_attr_scene_mode_e
typedef bool(* camera_attr_supported_stream_flip_cb)(camera_flip_e flip, void *user_data)

Called to get each supported stream flip mode.

Parameters:
[in]modeThe supported stream flip mode
[in]user_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop,
false to break out of the loop
Precondition:
camera_attr_foreach_supported_stream_flip() will invoke this callback.
See also:
camera_attr_foreach_supported_stream_flip()
typedef bool(* camera_attr_supported_stream_rotation_cb)(camera_rotation_e rotation, void *user_data)

Called to get each supported stream rotation mode.

Parameters:
[in]modeThe supported stream rotation mode
[in]user_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop,
false to break out of the loop
Precondition:
camera_attr_foreach_supported_stream_rotation() will invoke this callback.
See also:
camera_attr_foreach_supported_stream_rotation()
typedef bool(* camera_attr_supported_theater_mode_cb)(camera_attr_theater_mode_e mode, void *user_data)

Called to get each supported theater mode.

Parameters:
[in]modeThe supported theater mode
[in]user_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop,
false to break out of the loop
Precondition:
camera_attr_foreach_supported_theater_mode() will invoke this callback.
See also:
camera_attr_foreach_supported_theater_mode()

Called to get each supported white balance.

Parameters:
[in]wbThe supported white balance mode
[in]user_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop,
otherwise false to break out of the loop
Precondition:
camera_attr_foreach_supported_whitebalance() will invoke this callback.
See also:
camera_attr_foreach_supported_whitebalance()
camera_attr_whitebalance_e
typedef bool(* camera_supported_capture_format_cb)(camera_pixel_format_e format, void *user_data)

Called once for the pixel format of each supported capture format.

Since :
2.3.1
Parameters:
[in]formatThe supported pixel format
[in]user_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop,
otherwise false to break out of the loop
Precondition:
camera_foreach_supported_capture_format() will invoke this callback.
See also:
camera_foreach_supported_capture_format()
typedef bool(* camera_supported_capture_resolution_cb)(int width, int height, void *user_data)

Called once for each supported capture resolution.

Since :
2.3.1
Parameters:
[in]widthThe capture resolution width
[in]heightThe capture resolution height
[in]user_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop,
otherwise false to break out of the loop
Precondition:
camera_foreach_supported_capture_resolution() will invoke this callback.
See also:
camera_foreach_supported_capture_resolution()
typedef bool(* camera_supported_preview_format_cb)(camera_pixel_format_e format, void *user_data)

Called once for the pixel format of each supported preview format.

Since :
2.3.1
Parameters:
[in]formatThe supported preview data format
[in]user_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop,
otherwise false to break out of the loop
Precondition:
camera_foreach_supported_preview_format() will invoke this callback.
See also:
camera_foreach_supported_preview_format()
typedef bool(* camera_supported_preview_resolution_cb)(int width, int height, void *user_data)

Called once for each supported preview resolution.

Since :
2.3.1
Parameters:
[in]widthThe preview image width
[in]heightThe preview image height
[in]user_dataThe user data passed from the foreach function
Returns:
true to continue with the next iteration of the loop,
otherwise false to break out of the loop
Precondition:
camera_foreach_supported_preview_resolution() will invoke this callback.
See also:
camera_foreach_supported_preview_resolution()

Function Documentation

int camera_attr_foreach_supported_af_mode ( camera_h  camera,
camera_attr_supported_af_mode_cb  callback,
void *  user_data 
)

Retrieves all supported auto focus modes by invoking the callback function once for each supported auto focus mode.

Since :
2.3.1
Parameters:
[in]cameraThe handle to the camera
[in]callbackThe callback function to invoke
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
Postcondition:
This function invokes camera_attr_supported_af_mode_cb() to get all the supported auto focus modes.
See also:
camera_attr_set_af_mode()
camera_attr_get_af_mode()
camera_attr_supported_af_mode_cb()
int camera_attr_foreach_supported_effect ( camera_h  camera,
camera_attr_supported_effect_cb  callback,
void *  user_data 
)

Retrieves all supported effect modes by invoking the callback function once for each supported effect mode.

Since :
2.3.1
Parameters:
[in]cameraThe handle to the camera
[in]callbackThe callback function to invoke
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
Postcondition:
This function invokes camera_attr_supported_effect_cb() to get all the supported effect modes.
See also:
camera_attr_set_effect()
camera_attr_get_effect()
camera_attr_supported_effect_cb()

Retrieves all supported exposure modes by invoking the callback function once for each supported exposure mode.

Since :
2.3.1
Parameters:
[in]cameraThe handle to the camera
[in]callbackThe callback function to be invoked
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
Postcondition:
This function invokes camera_attr_supported_exposure_mode_cb() to get all the supported exposure modes.
See also:
camera_attr_set_exposure_mode()
camera_attr_get_exposure_mode()
camera_attr_supported_exposure_mode_cb()

Retrieves all supported flash modes by invoking the callback function once for each supported flash mode.

Since :
2.3.1
Parameters:
[in]cameraThe handle to the camera
[in]callbackThe callback function to invoke
[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_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
Postcondition:
This function invokes camera_attr_supported_flash_mode_cb() to get all supported flash modes.
See also:
camera_attr_set_flash_mode()
camera_attr_get_flash_mode()
camera_attr_supported_flash_mode_cb()
int camera_attr_foreach_supported_fps ( camera_h  camera,
camera_attr_supported_fps_cb  callback,
void *  user_data 
)

Retrieves all supported FPS modes by invoking the callback function once for each supported FPS mode.

Since :
2.3.1
Parameters:
[in]cameraThe handle to the camera
[in]callbackThe callback function to invoke
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
Postcondition:
This function invokes camera_attr_supported_fps_cb() repeatly to get each supported FPS mode.
See also:
camera_attr_set_preview_fps()
camera_attr_get_preview_fps()
camera_attr_supported_fps_cb()
int camera_attr_foreach_supported_iso ( camera_h  camera,
camera_attr_supported_iso_cb  callback,
void *  user_data 
)

Retrieves all supported ISO levels by invoking the callback function once for each supported ISO level.

Since :
2.3.1
Parameters:
[in]cameraThe handle to the camera
[in]callbackThe callback function to be invoked
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
Postcondition:
This function invokes camera_attr_supported_iso_cb() to get all the supported ISO levels.
See also:
camera_attr_set_iso()
camera_attr_get_iso()
camera_attr_supported_iso_cb()

Retrieves all supported scene modes by invoking the callback function once for each supported scene mode.

Since :
2.3.1
Parameters:
[in]cameraThe handle to the camera
[in]callbackThe callback function to invoke
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
Postcondition:
This function invokes camera_attr_supported_scene_mode_cb() to get all the supported scene modes.
See also:
camera_attr_set_scene_mode()
camera_attr_get_scene_mode()
camera_attr_supported_scene_mode_cb()

Retrieves all supported stream flip modes by invoking callback function once for each supported stream flip mode.

Since :
2.3.1
Parameters:
[in]cameraThe handle to the camera
[in]callbackThe callback function to invoke
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
Postcondition:
This function invokes camera_attr_supported_stream_flip_cb() to get all supported stream flip mode.
See also:
camera_attr_set_stream_flip()
camera_attr_get_stream_flip()
camera_attr_supported_stream_flip_cb()

Retrieves all supported stream rotation modes by invoking callback function once for each supported stream rotation mode.

Since :
2.3.1
Parameters:
[in]cameraThe handle to the camera
[in]callbackThe callback function to invoke
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
Postcondition:
This function invokes camera_attr_supported_stream_rotation_cb() to get all supported stream rotation mode.
See also:
camera_attr_set_stream_rotation()
camera_attr_get_stream_rotation()
camera_attr_supported_stream_rotation_cb()

Retrieves all supported theater modes by invoking callback function once for each supported theater modes.

Since :
2.3.1
Parameters:
[in]cameraThe handle to the camera
[in]callbackThe callback function to be invoked
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
Postcondition:
This function invokes camera_attr_supported_theater_mode_cb() to get all supported theater modes.
See also:
camera_attr_set_theater_mode()
camera_attr_get_theater_mode()
camera_attr_supported_theater_mode_cb()

Retrieves all supported white balances by invoking the callback function once for each supported white balance.

Since :
2.3.1
Parameters:
[in]cameraThe handle to the camera
[in]callbackThe callback function to be invoked
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
Postcondition:
This function invokes camera_attr_supported_whitebalance_cb() to get all the supported white balances.
See also:
camera_attr_set_whitebalance()
camera_attr_get_whitebalance()
camera_attr_supported_whitebalance_cb()

Gets the support state of the anti-shake feature.

Since :
2.3.1
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]cameraThe handle to the camera
Returns:
true if supported, otherwise false
Exceptions:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
See also:
camera_attr_enable_anti_shake()
camera_attr_is_enabled_anti_shake()

Gets state of support of auto contrast feature.

Since :
2.3.1
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]cameraThe handle to the camera
Returns:
true on supported, otherwise false
Exceptions:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
See also:
camera_attr_enable_auto_contrast()
camera_attr_is_enabled_auto_contrast()

Gets the support state of HDR capture.

Since :
2.3.1
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]cameraThe handle to the camera
Returns:
true if supported, otherwise false
Exceptions:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
See also:
camera_attr_set_hdr_mode()
camera_attr_get_hdr_mode()
camera_attr_set_hdr_capture_progress_cb()
camera_attr_unset_hdr_capture_progress_cb()

Gets the support state of the video stabilization feature.

Since :
2.3.1
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]cameraThe handle to the camera
Returns:
true if supported, otherwise false
Exceptions:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
See also:
camera_attr_enable_video_stabilization()
camera_attr_is_enabled_video_stabilization()
int camera_foreach_supported_capture_format ( camera_h  camera,
camera_supported_capture_format_cb  callback,
void *  user_data 
)

Retrieves all supported camera capture formats by invoking the callback function once for each supported camera capture format.

Since :
2.3.1
Parameters:
[in]cameraThe handle to the camera
[in]callbackThe callback function to be invoked
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
Postcondition:
This function invokes camera_supported_capture_format_cb() repeatedly to retrieve each supported capture format.
See also:
camera_set_capture_format()
camera_get_capture_format()
camera_supported_capture_format_cb()

Retrieves all supported camera captured resolutions by invoking the callback function once for each supported camera capture resolution.

Since :
2.3.1
Parameters:
[in]cameraThe handle to the camera
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
Postcondition:
This function invokes camera_supported_capture_resolution_cb() repeatedly to retrieve each supported capture resolution.
See also:
camera_set_capture_resolution()
camera_get_capture_resolution()
camera_supported_capture_resolution_cb()
int camera_foreach_supported_preview_format ( camera_h  camera,
camera_supported_preview_format_cb  callback,
void *  user_data 
)

Retrieves all supported camera preview formats by invoking the callback function once for each supported camera preview format.

Since :
2.3.1
Parameters:
[in]cameraThe handle to the camera
[in]callbackThe callback function to be invoked
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
Postcondition:
This function invokes camera_supported_preview_format_cb() repeatly to retrieve each supported preview format.
See also:
camera_set_preview_format()
camera_get_preview_format()
camera_supported_preview_format_cb()

Retrieves all supported camera preview resolutions by invoking the callback function once for each supported camera preview resolution.

Since :
2.3.1
Parameters:
[in]cameraThe handle to the camera
[in]callbackThe callback function to be invoked
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported
Postcondition:
This function invokes camera_supported_preview_resolution_cb() repeatedly to retrieve each supported preview resolution.
See also:
camera_set_preview_resolution()
camera_get_preview_resolution()
camera_supported_preview_resolution_cb()
int camera_get_device_count ( camera_h  camera,
int *  device_count 
)

Gets the camera device count.

Since :
2.3.1
Remarks:
If the device supports primary and secondary camera, this returns 2. If 1 is returned, the device only supports primary camera.
Parameters:
[in]cameraThe handle to the camera
[out]device_countThe device count
Returns:
0 on success, otherwise a negative error value
Return values:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported

Gets continuous capture feature's supported state.

Since :
2.3.1
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]cameraThe handle to the camera
Returns:
true on supported, otherwise false
Exceptions:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported

Gets the face detection feature's supported state.

Since :
2.3.1
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]cameraThe handle to the camera
Returns:
true if supported, otherwise false
See also:
camera_start_face_detection()
camera_stop_face_detection()
Exceptions:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported

Gets the media packet preview callback feature's supported state.

Since :
2.3.1
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]cameraThe handle to the camera
Returns:
true if supported, otherwise false
Exceptions:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported

Gets the zero shutter lag feature's supported state.

Since :
2.3.1
Remarks:
If supporting zero shutter lag, continuous shot can be done with full capture size.
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]cameraThe handle to the camera
Returns:
true if supported, otherwise false
Exceptions:
CAMERA_ERROR_NONESuccessful
CAMERA_ERROR_INVALID_PARAMETERInvalid parameter
CAMERA_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
CAMERA_ERROR_NOT_SUPPORTEDThe feature is not supported