com.nutiteq.utils

Class OrientationManager

java.lang.Object

com.nutiteq.utils.OrientationManager

public class OrientationManager
extends Object

Collects and communicates information about the user's current orientation and location.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	OrientationManager.OnChangedListener Classes should implement this interface if they want to be notified of changes in the user's location, orientation, or the accuracy of the compass.

Constructor Summary

Constructors

Constructor and Description
OrientationManager(android.hardware.SensorManager sensorManager, android.location.LocationManager locationManager) Initializes a new instance of OrientationManager, using the specified context to access system services.

Method Summary

Methods

Modifier and Type	Method and Description
void	addOnChangedListener(OrientationManager.OnChangedListener listener) Adds a listener that will be notified when the user's location or orientation changes.
float	getHeading() Gets the user's current heading, in degrees.
android.location.Location	getLocation() Gets the user's current location.
float	getPitch() Gets the user's current pitch (head tilt angle), in degrees.
boolean	hasInterference() Gets a value indicating whether there is too much magnetic field interference for the compass to be reliable.
boolean	hasLocation() Gets a value indicating whether the orientation manager knows the user's current location.
void	removeOnChangedListener(OrientationManager.OnChangedListener listener) Removes a listener from the list of those that will be notified when the user's location or orientation changes.
void	start() Starts tracking the user's location and orientation.
void	stop() Stops tracking the user's location and orientation.

Methods inherited from class java.lang.Object

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

Constructor Detail

OrientationManager

public OrientationManager(android.hardware.SensorManager sensorManager,
                  android.location.LocationManager locationManager)

Initializes a new instance of OrientationManager, using the specified context to access system services.

Method Detail

addOnChangedListener

public void addOnChangedListener(OrientationManager.OnChangedListener listener)

Adds a listener that will be notified when the user's location or orientation changes.

removeOnChangedListener

public void removeOnChangedListener(OrientationManager.OnChangedListener listener)

Removes a listener from the list of those that will be notified when the user's location or orientation changes.

start

public void start()

Starts tracking the user's location and orientation. After calling this method, any OrientationManager.OnChangedListeners added to this object will be notified of these events.

stop

public void stop()

Stops tracking the user's location and orientation. Listeners will no longer be notified of these events.

hasInterference

public boolean hasInterference()

Gets a value indicating whether there is too much magnetic field interference for the compass to be reliable.

Returns:

true if there is magnetic interference, otherwise false

hasLocation

public boolean hasLocation()

Gets a value indicating whether the orientation manager knows the user's current location.

Returns:

true if the user's location is known, otherwise false

getHeading

public float getHeading()

Gets the user's current heading, in degrees. The result is guaranteed to be between 0 and 360.

Returns:

the user's current heading, in degrees

getPitch

public float getPitch()

Gets the user's current pitch (head tilt angle), in degrees. The result is guaranteed to be between -90 and 90.

Returns:

the user's current pitch angle, in degrees

getLocation

public android.location.Location getLocation()

Gets the user's current location.

Returns:

the user's current location