sensor_event_get_face

Retrieve whether a face was detected close to our touching the screen.

Synopsis:

#include <bps/sensor.h>

BPS_API int sensor_event_get_face_detect(bps_event_t *event) BPS_DEPRECATED

Since:

BlackBerry 10.0.0

Arguments:

event: The SENSOR_FACE_DETECT_READING event to get the value from.

Library:

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

Description:

Deprecated:

This function is deprecated, use the proximity sensor.

The sensor_event_get_face_detect() function returns 1 when an object is detected to be close to or touching the screen. Otherwise it returns 0. The value is retrieved from a SENSOR_FACE_DETECT_READING event.

Returns:

A value of 1 when an object is detected to be close to or touching the screen on the device, 0 if no object is close to or touching the screen, and -1 with errno value set if an an error occurred.