camera_get_ev_bracketing_limits()

Retrieve the exposure value (EV) bracketing limits.

Synopsis:

#include <camera/camera_api.h>
 
camera_error_t camera_get_ev_bracketing_limits(camera_handle_t handle,                 
                                               uint32_t *max_num,                 
                                               double *min_delta,                 
                                               double *max_delta)

Since:

BlackBerry 10.0.0

Arguments:

handle

The handle returned by a call to the camera_open() function.

max_num

A pointer to a uint32_t value that will be updated with the maximum number of bracketing deltas that are supported by the camera.

min_delta

A pointer to a double value that will be updated with the minimum EV delta that is supported by the camera.

max_delta

A pointer to a double value that will be updated with the maximum EV delta that is supported by the camera.

Library:

libcamapi (For the qcc command, use the -l camapi option to link against this library)

Description:

EV Bracketing is a technique that involves taking several shots of the same subject using different exposure levels. To use this function, pass in pointers to the max_num, min_delta, and max_delta arguments to retrieve the appropriate limits supported by the camera.

The viewfinder must be configured for CAMERA_VFMODE_EV_BRACKETING mode before using this function. For more information about new and deprecated viewfinder functionality, see Viewfinder modes.

Returns:

CAMERA_EOK when the function successfully completes, otherwise another camera_error_t value that provides the reason that the call failed.