diff options
author | Thomas McGuire <thomas.mcguire.qnx@kdab.com> | 2013-02-08 10:48:30 +0100 |
---|---|---|
committer | The Qt Project <gerrit-noreply@qt-project.org> | 2013-02-26 15:24:39 +0100 |
commit | c0f3653aea1c86ba2fecb0f8b0c6865f025031a4 (patch) | |
tree | 7737cf8a28c179a38d4ad9069ab20fd37c9cfd9b /src/sensors | |
parent | e3de1d31fe05455f1f22085bb3607047d8ba718d (diff) | |
download | qtsensors-c0f3653aea1c86ba2fecb0f8b0c6865f025031a4.tar.gz |
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/sensors')
-rw-r--r-- | src/sensors/qirproximitysensor.cpp | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/src/sensors/qirproximitysensor.cpp b/src/sensors/qirproximitysensor.cpp index 4b7eeec..6197bb9 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. */ /*! |