camera_meta_get_face_roll()
Extract the detected face roll angle from the provided face metadata.
Synopsis:
int camera_meta_get_face_roll(const camera_metadata_t metadata, float *roll)
Since:
BlackBerry 10.0.0
Arguments:
- metadata
-
The metadata supplied to the user-defined consumer function by camera_meta_iterate_metadata().
- roll
-
The angle of rotation of the face around the z-axis.
Library:
libcamapi (For the qcc command, use the -l camapi option to link against this library)Description:
The roll value ranges from -180 degrees to +180 degrees relative to the preview buffer coordinate space. A negative roll angle indicates that the face is rotated counter-clockwise from the camera's frame of reference. A positive roll angle indicates that the face is rotated clockwise from the camera's frame of reference.
Returns:
CAMERA_EOK when the function successfully completes, CAMERA_ENODATA if the camera did not provide a roll value otherwise another camera_error_t value that provides the reason that the call failed.
Last modified: 2014-06-24