camera_config_ev_bracketing()

Set the exposure bracketing parameters.

Synopsis:

#include <camera/camera_api.h>
 
camera_error_t camera_config_ev_bracketing(camera_handle_t handle, uint32_t num, double *ev_deltas)

Arguments:

handle

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

num

The number of exposure bracket delta values.

ev_deltas

A pointer to an array of exposures deltas values.

Library:

libcamapi

Description:

This function can be called if the CAMERA_FEATURE_EVBRACKETING feature is available. You can determine whether the feature is available by calling the camera_can_feature() function.

An array of EV deltas can be configured when a burst is triggered. The exposure deltas will be applied to successive frames. For example, {-3.0, 0.0, +3.0} in conjunction with a three-shot burst would yield three images. The first underexposed by three stops, the second at nominal exposure, and the third would be overexposed by three stops.

Before you use this function, you must start the photo viewfinder. You can use the camera_get_ev_bracketing_limits() function to determine the exposure bracketing minimum and maximum values, as well as the maximum set in the num argument.

   camera_error_t camretcode;
   double ev_deltas[] = {-3.0, 0.0, +3.0};
   retcode = camera_config_ev_bracketing( handle,
                                          sizeof(ev_deltas)/sizeof(double),
                                          ev_deltas );

Returns:

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