Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 0c285639 authored by Brian Duddie's avatar Brian Duddie
Browse files

Clarify optionality of velocity in head tracker sensor 

Bug: 218911221
Test: n/a, comment update only
Change-Id: I893397c9446e5c976e3dc9e68d65d67e7128ba9e
parent 4eb921fc

core/java/android/hardware/SensorEvent.java

+9 −5
Original line number Diff line number Diff line
@@ -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