camera_get_focus_state()

Updated: April 19, 2023

Retrieve the focus state of the camera

Synopsis:

#include <camera/camera_3a.h>
camera_error_t camera_get_focus_state(camera_handle_t handle,
                                      camera_focusstate_t *state,
                                      camera_region_t *region)

Arguments:

handle
The handle returned by a call to the camera_open() function.
state
A pointer to a camera_focusstate_t that will be updated with the focus state of the camera.
region
A pointer to a camera_region_t that will be updated with the region that the focus has locked to. This argument only returns valid data when state reports CAMERA_FOCUSSTATE_LOCKED.

Library:

libcamapi

Description:

Determine the focus state and the region of focus. Typically, you call this function when a status event of type CAMERA_STATUS_FOCUS_CHANGE is received.

Returns:

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