camera_config_vf_face_detect()

Configure viewfinder face-detection metadata reporting.

Synopsis:

#include <camera/camera_api.h>
 
camera_error_t camera_config_vf_face_detect(camera_handle_t handle,                 
                                            bool enable)

Since:

BlackBerry 10.0.0

Arguments:

handle

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

enable

Set to true to enable viewfinder face-detection metadata reporting, false otherwise.

Library:

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

Description:

Use this function to enable the reporting of viewfinder face-detection metadata if the feature is supported on the camera. You can call the camera_can_feature() function with the CAMERA_FEATURE_VFFACEDETECT to determine if the camera supports face-detection.

Viewfinder face-detection metadata is processed using the functions in camera_meta.h.

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.