From c0f3653aea1c86ba2fecb0f8b0c6865f025031a4 Mon Sep 17 00:00:00 2001 From: Thomas McGuire Date: Fri, 8 Feb 2013 10:48:30 +0100 Subject: Document the IR Proximity value behavior on BlackBerry Task-number: QTBUG-28087 Change-Id: Ibf2a37dce4c57506bf2073bee9f483d48c94e71c Reviewed-by: Tennessee Carmel-Veilleux Reviewed-by: Lorn Potter --- src/sensors/qirproximitysensor.cpp | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'src/sensors/qirproximitysensor.cpp') diff --git a/src/sensors/qirproximitysensor.cpp b/src/sensors/qirproximitysensor.cpp index 4b7eeec3..6197bb96 100644 --- a/src/sensors/qirproximitysensor.cpp +++ b/src/sensors/qirproximitysensor.cpp @@ -63,6 +63,12 @@ IMPLEMENT_READING(QIRProximityReading) The sensor reports reflectance as a decimal fraction in the range of 0 - 1. That is, 0 indicates nothing was detected within the range of the sensor and 1 indicates the infra-red signal returned at the full power level that it was sent at. + + With some IR sensors, it is quite uncommon to reach the top and the bottom of the + value range, and some parts of the range ends might not be obtainable at all. This is due to the + behavior of the sensor hardware. With these sensors, the absolute value of reflectance should never + be used directly. Instead, applications should react to the relative change of the reading values. Use + QProximitySensor if it is only necessary to check if something is close to the device or not. */ /*! -- cgit v1.2.3