camera_meta_get_face_roll()

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.