From d9776fc6aa8e90926fa024bb64c4e31406d1d091 Mon Sep 17 00:00:00 2001 From: Paul Olav Tvete Date: Tue, 6 Aug 2013 14:40:40 +0200 Subject: Define the sensor coordinate system unambiguously All illustrations in the documentation show devices with phone form factors, i.e. portrait orientation. Some tablets have a native landscape orientation. It is not clear from the documentation if the sensor coordinate system should be relative to the portrait orientation or the native orientation. This change defines the native orientation as the canonical orientation. Task-number: QTBUG-32144 Change-Id: I870cb3c9b5aec04f2ed8394a4407b53b888e82c3 Reviewed-by: Thomas McGuire --- src/sensors/doc/src/qtsensors-cpp.qdoc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) (limited to 'src/sensors') diff --git a/src/sensors/doc/src/qtsensors-cpp.qdoc b/src/sensors/doc/src/qtsensors-cpp.qdoc index 2f60592a..5157ddad 100644 --- a/src/sensors/doc/src/qtsensors-cpp.qdoc +++ b/src/sensors/doc/src/qtsensors-cpp.qdoc @@ -56,7 +56,9 @@ Where rotation around an axis is used, the rotation shall be expressed as a Righ \image sensors-coordinates3.jpg -In general, sensor data is oriented to the top of the device. If values are to be displayed on +In general, sensor data is oriented relative to \l QPlatformScreen::nativeOrientation, i.e +to the top of the device when the device is held in its natural orientation (normally +when the device logo appears the right side up). If values are to be displayed on the screen the values may need to be transformed so that they match the user interface orientation. A sensor may define its data as being oriented to the UI. This will be noted in the documentation for the sensor. -- cgit v1.2.3