camera_set_3a_face_id()

#include <camera/camera_api.h>
 

camera_error_t camera_set_3a_face_id(camera_handle_t handle,                 
                                     uint32_t id)

Since:

BlackBerry 10.2.0

Arguments:

handle

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

id

The face ID to select. This must be a valid face ID previously returned by the camera_meta_get_face_id() function.

Library:

libcamapi (For the qcc command, use the -l camapi option to link against this library)

Description:

Use this function to instruct the 3A face-detection priority algorithms to operate only on the face identified by the caller. The face ID must correspond to a valid face as reported by the face detection metadata and retrieved by a call to camera_meta_get_face_id().

You can only use this function after face-detection priority 3A algorithms are enabled using camera_set_3a_face_priority().

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.