summaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorThomas McGuire <thomas.mcguire.qnx@kdab.com>2013-02-08 10:48:30 +0100
committerThe Qt Project <gerrit-noreply@qt-project.org>2013-02-26 15:24:39 +0100
commitc0f3653aea1c86ba2fecb0f8b0c6865f025031a4 (patch)
tree7737cf8a28c179a38d4ad9069ab20fd37c9cfd9b /src
parente3de1d31fe05455f1f22085bb3607047d8ba718d (diff)
Document the IR Proximity value behavior on BlackBerry
Task-number: QTBUG-28087 Change-Id: Ibf2a37dce4c57506bf2073bee9f483d48c94e71c Reviewed-by: Tennessee Carmel-Veilleux <tcarmelveilleux@rim.com> Reviewed-by: Lorn Potter <lorn.potter@jollamobile.com>
Diffstat (limited to 'src')
-rw-r--r--src/sensors/qirproximitysensor.cpp6
1 files changed, 6 insertions, 0 deletions
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.
*/
/*!