camera_set_3a_face

Configure 3A algorithms for face-detection priority.

Synopsis:

#include <camera/camera_api.h>

camera_error_t camera_set_3a_face_priority(camera_handle_t handle,                 
                                           uint32_t priority)

Since:

BlackBerry 10.0.0

Arguments:

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

priority: A bitmask of 3A algorithms to switch to 3A face-detection priority mode.

Library:

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

Description:

The autofocus, auto exposure, and auto white balance algorithms (the 3A algorithms) may be switched into face-detection priority mode. When in face-detection priority mode, the 3A algorithms will prioritize focus, exposure, or white balance on faces in the scene.

For the priority argument, you can specify the 3A algorithms to switch to face-detection priority by ORing values from the camera_3a_t enumerated type. The following are examples:

To enable 3A face-detection priority for autofocus and auto exposure, but not auto white balance, use the value of (CAMERA_3A_AUTOFOCUS | CAMERA_3A_AUTOEXPOSURE).
To disable 3A face-detection priority for all 3A algorithms, use the value of CAMERA_3A_NONE.

Note: Not all cameras may allow the independent switching of individual 3A algorithms to face-detection priority mode. For example, it may be required that auto focus and auto exposure be switched to face- detection priority mode together. Use the camera_get_3a_face_priority_modes() function to discover these restrictions.

Note: Enabling 3A face-detection priority for a given mode will clear any corresponding camera_region_t definitions. For example, if priority includes CAMERA_3A_AUTOEXPOSURE, the camera_region_t set by camera_set_exposure_regions() is cleared.

After 3A face-priority algorithms are enabled, the camera will select a default face to track. You can explicitly select a different face using camera_set_3a_face_id().

The viewfinder must be running before using this function.

Returns: