Camera Library Referencecamera_3a.h Parent topic: camera_3a.h

camera_set_exposure_regions()

Configure the auto exposure regions on the camera

Synopsis:

#include <camera/camera_3a.h>
camera_error_t camera_set_exposure_regions(camera_handle_t handle,
                                           int numregions,
                                           camera_region_t *regions)

Arguments:

handle
The handle returned by a call to the camera_open() function.
numregions
The number of regions to apply, which is the number of elements in the regions array.
regions
A pointer to an array of exposure regions to apply. The region co-ordinates are interpreted relative to a viewfinder buffer with (0, 0) representing the top-left corner of the frame, and (width-1, height-1) representing the bottom-right corner. If CAMERA_IMGPROP_ROTATION is applied to the viewfinder, then the co-ordinate frame of reference is also rotated accordingly.

Library:

libcamapi

Description:

When exposure regions are defined, the auto exposure algorithm will give exposure priority to objects in the defined areas of the scene.

Call this function only if the CAMERA_FEATURE_REGIONEXPOSURE feature is available. You can call camera_can_feature() to determine if the CAMERA_FEATURE_REGIONEXPOSURE is available.

The maximum number of exposure regions that you can configure is returned by the numsupported argument of the camera_get_exposure_regions() function.

After setting the regions, you must call the camera_set_exposure_mode() function to commit the changes.

The viewfinder must be running before using this function.

Returns:

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

Parent topic: camera_3a.h