camera_set_focus_regions()

#include <camera/camera_api.h>
 

camera_error_t camera_set_focus_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 focus regions to apply.

Library:

libcamapi

Description:

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

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

After setting the regions, the changes will be committed only after a call to camera_set_focus_mode().

Returns:

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