From f71384cd6141c50f589178d309db3ceeb848fb30 Mon Sep 17 00:00:00 2001
From: Mathias Agopian
Date: Fri, 19 Nov 2010 16:25:11 -0800
Subject: [PATCH] Fix SensorManager.getOrientation() documentation.
This function doesn't use the same reference coordinate system used
for the rotation matrix, unlike what the documentation previously
stated.
Change-Id: I38abeb74540d33b67f72993b54d7a00a73588dde
---
core/java/android/hardware/SensorManager.java | 16 +++++++++++++---
docs/html/images/axis_globe_inverted.png | Bin 0 -> 6296 bytes
2 files changed, 13 insertions(+), 3 deletions(-)
create mode 100644 docs/html/images/axis_globe_inverted.png
diff --git a/core/java/android/hardware/SensorManager.java b/core/java/android/hardware/SensorManager.java
index 3f6e4ce49d1c1..c178aee3d5488 100644
--- a/core/java/android/hardware/SensorManager.java
+++ b/core/java/android/hardware/SensorManager.java
@@ -1158,7 +1158,7 @@ public class SensorManager
*
*
*
+ * alt="World coordinate-system diagram." border="0" />
*
*
*
@@ -1521,9 +1521,19 @@ public class SensorManager
*
values[1]: pitch, rotation around the X axis.
* values[2]: roll, rotation around the Y axis.
*
+ * The reference coordinate-system used is different from the world
+ * coordinate-system defined for the rotation matrix:
+ *
+ * - X is defined as the vector product Y.Z (It is tangential to
+ * the ground at the device's current location and roughly points West).
+ * - Y is tangential to the ground at the device's current location and
+ * points towards the magnetic North Pole.
+ * - Z points towards the center of the Earth and is perpendicular to the ground.
+ *
+ *
*
- *
+ *
*
*
* All three angles above are in radians and positive in the
diff --git a/docs/html/images/axis_globe_inverted.png b/docs/html/images/axis_globe_inverted.png
new file mode 100644
index 0000000000000000000000000000000000000000..bd78c7f6bbc230c1c2a99f16bf77a8bc17296cca
GIT binary patch
literal 6296
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