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:

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_device_manager_foreach_supported_device (camera_device_manager_h manager, camera_supported_device_cb callback, void *user_data)
	Retrieves all supported devices by invoking the callback function once for each supported device.
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.
bool	camera_is_supported_extra_preview (camera_h camera)
	Gets the extra preview 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_fps_by_resolution (camera_h camera, int width, int height, 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 by resolution.
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.
int	camera_attr_foreach_supported_ptz_type (camera_h camera, camera_attr_supported_ptz_type_cb callback, void *user_data)
	Retrieves all supported PTZ (Pan Tilt Zoom) types by invoking callback function once for each supported ptz type.
Typedefs
typedef bool(*	camera_supported_preview_resolution_cb )(int width, int height, void *user_data)
	Invoked once for each supported preview resolution.
typedef bool(*	camera_supported_capture_resolution_cb )(int width, int height, void *user_data)
	Invoked once for each supported capture resolution.
typedef bool(*	camera_supported_capture_format_cb )(camera_pixel_format_e format, void *user_data)
	Invoked 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)
	Invoked once for the pixel format of each supported preview format.
typedef bool(*	camera_supported_device_cb )(camera_device_s device, void user_data)
	Invoked once for the each supported device.
typedef bool(*	camera_attr_supported_af_mode_cb )(camera_attr_af_mode_e mode, void *user_data)
	Invoked to get each supported auto-focus mode.
typedef bool(*	camera_attr_supported_exposure_mode_cb )(camera_attr_exposure_mode_e mode, void *user_data)
	Invoked to get each supported exposure mode.
typedef bool(*	camera_attr_supported_iso_cb )(camera_attr_iso_e iso, void *user_data)
	Invoked to get each supported ISO mode.
typedef bool(*	camera_attr_supported_whitebalance_cb )(camera_attr_whitebalance_e wb, void *user_data)
	Invoked to get each supported white balance.
typedef bool(*	camera_attr_supported_effect_cb )(camera_attr_effect_mode_e effect, void *user_data)
	Invoked to get each supported effect mode.
typedef bool(*	camera_attr_supported_scene_mode_cb )(camera_attr_scene_mode_e mode, void *user_data)
	Invoked to get each supported scene mode.
typedef bool(*	camera_attr_supported_flash_mode_cb )(camera_attr_flash_mode_e mode, void *user_data)
	Invoked to get each supported flash mode.
typedef bool(*	camera_attr_supported_fps_cb )(camera_attr_fps_e fps, void *user_data)
	Invoked to get each supported FPS mode.
typedef bool(*	camera_attr_supported_stream_flip_cb )(camera_flip_e flip, void *user_data)
	Invoked to get each supported stream flip mode.
typedef bool(*	camera_attr_supported_stream_rotation_cb )(camera_rotation_e rotation, void *user_data)
	Invoked to get each supported stream rotation mode.
typedef bool(*	camera_attr_supported_theater_mode_cb )(camera_attr_theater_mode_e mode, void *user_data)
	Invoked to get each supported theater mode.
typedef bool(*	camera_attr_supported_ptz_type_cb )(camera_attr_ptz_type_e type, void *user_data)
	Invoked to get each supported PTZ (Pan Tilt Zoom) type.

Typedef Documentation

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

Invoked to get each supported auto-focus mode.

Since :: 2.3.1

Parameters:

[in]	mode	The supported auto-focus mode
[in]	user_data	The 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)

Invoked to get each supported effect mode.

Since :: 2.3.1

Parameters:

[in]	effect	The supported effect mode
[in]	user_data	The 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()

typedef bool(* camera_attr_supported_exposure_mode_cb)(camera_attr_exposure_mode_e mode, void *user_data)

Invoked to get each supported exposure mode.

Since :: 2.3.1

Parameters:

[in]	mode	The supported exposure mode
[in]	user_data	The 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)

Invoked to get each supported flash mode.

Since :: 2.3.1

Parameters:

[in]	mode	The supported flash mode
[in]	user_data	The 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)

Invoked to get each supported FPS mode.

Since :: 2.3.1

Parameters:

[in]	fps	The supported FPS mode
[in]	user_data	The 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)

Invoked to get each supported ISO mode.

Since :: 2.3.1

Parameters:

[in]	iso	The supported ISO mode
[in]	user_data	The 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_ptz_type_cb)(camera_attr_ptz_type_e type, void *user_data)

Invoked to get each supported PTZ (Pan Tilt Zoom) type.

Since :: 3.0

Parameters:

[in]	type	The supported ptz type
[in]	user_data	The 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_ptz_mode() will invoke this callback.

See also:: camera_attr_foreach_supported_ptz_mode()

typedef bool(* camera_attr_supported_scene_mode_cb)(camera_attr_scene_mode_e mode, void *user_data)

Invoked to get each supported scene mode.

Since :: 2.3.1

Parameters:

[in]	mode	The supported scene mode
[in]	user_data	The 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)

Invoked to get each supported stream flip mode.

Since :: 2.3.1

Parameters:

[in]	flip	The supported stream flip mode
[in]	user_data	The 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)

Invoked to get each supported stream rotation mode.

Since :: 2.3.1

Parameters:

[in]	rotation	The supported stream rotation mode
[in]	user_data	The 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)

Invoked to get each supported theater mode.

Since :: 2.3.1

Parameters:

[in]	mode	The supported theater mode
[in]	user_data	The 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()

typedef bool(* camera_attr_supported_whitebalance_cb)(camera_attr_whitebalance_e wb, void *user_data)

Invoked to get each supported white balance.

Since :: 2.3.1

Parameters:

[in]	wb	The supported white balance mode
[in]	user_data	The 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)

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

Since :: 2.3.1

Parameters:

[in]	format	The supported pixel format
[in]	user_data	The 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)

Invoked once for each supported capture resolution.

Since :: 2.3.1

Parameters:

[in]	width	The capture resolution width
[in]	height	The capture resolution height
[in]	user_data	The 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_device_cb)(camera_device_s *device, void *user_data)

Invoked once for the each supported device.

Since :: 7.0

Remarks:: The device should not be released and it can be used only in the callback. To use outside, make a copy.

Parameters:

[in]	device	The camera device
[in]	user_data	The 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_device_manager_foreach_supported_device() will invoke this callback.

See also:: camera_device_manager_foreach_supported_device()

typedef bool(* camera_supported_preview_format_cb)(camera_pixel_format_e format, void *user_data)

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

Since :: 2.3.1

Parameters:

[in]	format	The supported preview data format
[in]	user_data	The 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)

Invoked once for each supported preview resolution.

Since :: 2.3.1

Parameters:

[in]	width	The preview image width
[in]	height	The preview image height
[in]	user_data	The 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]	camera	The handle to the camera
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

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

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]	camera	The handle to the camera
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

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

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()

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.

Since :: 2.3.1

Parameters:

[in]	camera	The handle to the camera
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

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

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()

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.

Since :: 2.3.1

Parameters:

[in]	camera	The handle to the camera
[in]	callback	The callback function to be invoked
[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_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_SERVICE_DISCONNECTED	The socket to multimedia server is disconnected

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]	camera	The handle to the camera
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

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

Postcondition:: This function invokes camera_attr_supported_fps_cb() repeatedly 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_fps_by_resolution	(	camera_h	camera,
		int	width,
		int	height,
		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 by resolution.

Since :: 3.0

Parameters:

[in]	camera	The handle to the camera
[in]	width	Required preview resolution's width
[in]	height	Required preview resolution's height
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

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

Postcondition:: This function invokes camera_attr_supported_fps_cb() repeatedly 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]	camera	The handle to the camera
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

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

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()

int camera_attr_foreach_supported_ptz_type	(	camera_h	camera,
		camera_attr_supported_ptz_type_cb	callback,
		void *	user_data
	)

Retrieves all supported PTZ (Pan Tilt Zoom) types by invoking callback function once for each supported ptz type.

Since :: 3.0

Parameters:

[in]	camera	The handle to the camera
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

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

Postcondition:: This function invokes camera_attr_supported_ptz_type_cb() to get all supported ptz type.

See also:: camera_attr_set_ptz_type()

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.

Since :: 2.3.1

Parameters:

[in]	camera	The handle to the camera
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

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

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()

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.

Since :: 2.3.1

Parameters:

[in]	camera	The handle to the camera
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

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

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()

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.

Since :: 2.3.1

Parameters:

[in]	camera	The handle to the camera
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

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

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()

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.

Since :: 2.3.1

Parameters:

[in]	camera	The handle to the camera
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

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

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()

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.

Since :: 2.3.1

Parameters:

[in]	camera	The handle to the camera
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

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

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()

bool camera_attr_is_supported_anti_shake ( camera_h camera )

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] camera The handle to the camera

Returns:: true if supported, otherwise false

Exceptions:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: camera_attr_enable_anti_shake(); camera_attr_is_enabled_anti_shake()

bool camera_attr_is_supported_auto_contrast ( camera_h camera )

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] camera The handle to the camera

Returns:: true on supported, otherwise false

Exceptions:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: camera_attr_enable_auto_contrast(); camera_attr_is_enabled_auto_contrast()

bool camera_attr_is_supported_hdr_capture ( camera_h camera )

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] camera The handle to the camera

Returns:: true if supported, otherwise false

Exceptions:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter

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()

bool camera_attr_is_supported_video_stabilization ( camera_h camera )

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] camera The handle to the camera

Returns:: true if supported, otherwise false

Exceptions:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: camera_attr_enable_video_stabilization(); camera_attr_is_enabled_video_stabilization()

int camera_device_manager_foreach_supported_device	(	camera_device_manager_h	manager,
		camera_supported_device_cb	callback,
		void *	user_data
	)

Retrieves all supported devices by invoking the callback function once for each supported device.

Since :: 7.0

Parameters:

[in]	manager	The handle to the camera device manager
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter
CAMERA_ERROR_INVALID_OPERATION	Invalid operation

Postcondition:: This function invokes camera_supported_device_cb() repeatedly to retrieve each supported device.

See also:: camera_supported_device_cb(); camera_device_manager_initialize(); camera_device_manager_deinitialize()

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]	camera	The handle to the camera
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

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

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()

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.

Since :: 2.3.1

Parameters:

[in]	camera	The handle to the camera
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

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

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]	camera	The handle to the camera
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

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

Postcondition:: This function invokes camera_supported_preview_format_cb() repeatedly to retrieve each supported preview format.

See also:: camera_set_preview_format(); camera_get_preview_format(); camera_supported_preview_format_cb()

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.

Since :: 2.3.1

Parameters:

[in]	camera	The handle to the camera
[in]	callback	The callback function to be invoked
[in]	user_data	The user data to be passed to the callback function

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

Return values:

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

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]	camera	The handle to the camera
[out]	device_count	The device count

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

Return values:

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

bool camera_is_supported_continuous_capture ( camera_h camera )

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] camera The handle to the camera

Returns:: true on supported, otherwise false

Exceptions:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter

bool camera_is_supported_extra_preview ( camera_h camera )

Gets the extra preview feature's supported state.

Since :: 7.0

Remarks:: The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.

Parameters:

[in] camera The handle to the camera

Returns:: true if supported, otherwise false

Exceptions:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter

bool camera_is_supported_face_detection ( camera_h camera )

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] camera The handle to the camera

Returns:: true if supported, otherwise false

Exceptions:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: camera_start_face_detection(); camera_stop_face_detection()

bool camera_is_supported_media_packet_preview_cb ( camera_h camera )

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] camera The handle to the camera

Returns:: true if supported, otherwise false

Exceptions:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter

bool camera_is_supported_zero_shutter_lag ( camera_h camera )

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] camera The handle to the camera

Returns:: true if supported, otherwise false

Exceptions:

CAMERA_ERROR_NONE	Successful
CAMERA_ERROR_NOT_SUPPORTED	The feature is not supported
CAMERA_ERROR_PERMISSION_DENIED	The access to the resources can not be granted
CAMERA_ERROR_INVALID_PARAMETER	Invalid parameter

Required Header

Overview

Related Features

Functions

Typedefs

Typedef Documentation

Function Documentation