camera_get_focus_state()

#include <camera/camera_api.h>
 

camera_error_t camera_get_focus_state(camera_handle_t handle,                 
                                      camera_focusstate_t *state,                 
                                      camera_region_t *region)

Since:

BlackBerry 10.0.0

Arguments:

handle

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

state

A pointer to a camera_focusstate_t value that will be updated with the focus state of the camera.

region

A pointer to a camera_region_t value 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 (For the qcc command, use the -l camapi option to link against this library)

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.

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.