com.google.appinventor.components.runtime.util

Class OrientationSensorUtil

java.lang.Object

com.google.appinventor.components.runtime.util.OrientationSensorUtil

public class OrientationSensorUtil
extends java.lang.Object

Functionality related to OrientationSensor, placed in this static utility class for easier testing.

Method Summary

Methods

Modifier and Type	Method and Description
static float	normalizeAzimuth(float azimuth) Normalizes azimuth to be in the range [0, 360).
static float	normalizePitch(float pitch) Normalizes pitch to be in the range [-180, +180).
static float	normalizeRoll(float roll) Normalizes roll to be in the range [-90, +90] degrees.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

normalizeAzimuth

public static float normalizeAzimuth(float azimuth)

Normalizes azimuth to be in the range [0, 360).

Parameters:

azimuth - an angle in degrees, likely to be in (-360, +360)

Returns:

an equivalent angle in the range [0, 360)

normalizePitch

public static float normalizePitch(float pitch)

Normalizes pitch to be in the range [-180, +180).

Parameters:

pitch - an angle in degrees, likely to be in (-360, +360)

Returns:

an equivalent angle in the range [-180, +180)

normalizeRoll

public static float normalizeRoll(float roll)

Normalizes roll to be in the range [-90, +90] degrees. The App Inventor definition of Roll in the documentation is:

0 degrees when the device is level, increasing to 90 degrees as the device is tilted up onto its left side, and decreasing to -90 degrees when the device is tilted up onto its right side.

After rotating the phone more than 90 degrees, Roll decreased. For compatibility, we are guaranteeing the same behavior.

Parameters:

roll - an angle likely to be in the range [-180, +180]

Returns:

the equivalent angle in the range [-90, +90], where angles with an absolute value greater than 90 are reflected over the x-axis; the value is not defined for inputs outside of [-180, +180]