camera_config_photo_face_detect()

Configure face-detection metadata reporting for still images.

Synopsis:

#include <camera/camera_api.h>
 
camera_error_t camera_config_photo_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 reporting of face-detection metadata for still images, 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 still image face-detection metadata if the feature is supported on the camera. You can call the the camera_can_feature() function with the CAMERA_FEATURE_FACEDETECT property to determine if the camera supports the face-detection feature.

Still image 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.