camera_meta_get_face_region()

Retrieve the bounding box associated with a face that is detected in the image.

Synopsis:

int camera_meta_get_face_region(const camera_metadata_t metadata,                 
                                camera_region_t *region)

Since:

BlackBerry 10.0.0

Arguments:

metadata: The metadata supplied to the user-defined consumer function by camera_meta_iterate_metadata().

region: A pointer to a camera_region_t structure that will be updated with the coordinates of the bounding box defining the face.

Library:

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

Description:

This function extracts the bounding box from the provided face metadata and returns it as a camera_region_t value.

Returns:

CAMERA_EOK when the function successfully completes, otherwise another camera_error_t value that provides the reason that the call failed.