Clarify optionality of velocity in head tracker sensor

Bug: 218911221
Test: n/a, comment update only
Change-Id: I893397c9446e5c976e3dc9e68d65d67e7128ba9e
This commit is contained in:
Brian Duddie
2022-02-14 10:41:29 -08:00
parent 4eb921fca1
commit 0c285639a7

View File

@@ -664,16 +664,20 @@ public class SensorEvent {
* The first three elements provide the transform from the (arbitrary, possibly slowly drifting)
* reference frame to the head frame. The magnitude of this vector is in range [0, π]
* radians, while the value of individual axes is in range [-π, π]. The next three
* elements provide the estimated rotational velocity of the user's head relative to itself, in
* radians per second.
* elements optionally provide the estimated rotational velocity of the user's head relative to
* itself, in radians per second. If a given sensor does not support determining velocity, these
* elements are set to 0.
*
* <ul>
* <li> values[0] : X component of Euler vector representing rotation</li>
* <li> values[1] : Y component of Euler vector representing rotation</li>
* <li> values[2] : Z component of Euler vector representing rotation</li>
* <li> values[3] : X component of Euler vector representing angular velocity</li>
* <li> values[4] : Y component of Euler vector representing angular velocity</li>
* <li> values[5] : Z component of Euler vector representing angular velocity</li>
* <li> values[3] : X component of Euler vector representing angular velocity (if
* supported, otherwise 0)</li>
* <li> values[4] : Y component of Euler vector representing angular velocity (if
* supported, otherwise 0)</li>
* <li> values[5] : Z component of Euler vector representing angular velocity (if
* supported, otherwise 0)</li>
* </ul>
*
* <h4>{@link android.hardware.Sensor#TYPE_ACCELEROMETER_LIMITED_AXES