org.osmdroid.views.overlay.compass

Class CompassOverlay

java.lang.Object

org.osmdroid.views.overlay.Overlay

org.osmdroid.views.overlay.compass.CompassOverlay

All Implemented Interfaces:

IOrientationConsumer, IOverlayMenuProvider, OverlayConstants

public class CompassOverlay
extends Overlay
implements IOverlayMenuProvider, IOrientationConsumer

Author:

Marc Kurtz, Manuel Stahl

Nested Class Summary

Nested classes/interfaces inherited from class org.osmdroid.views.overlay.Overlay

Overlay.Snappable

Field Summary

Fields

Modifier and Type	Field and Description
protected android.graphics.Bitmap	mCompassFrameBitmap
protected float	mCompassFrameCenterX
protected float	mCompassFrameCenterY
protected android.graphics.Bitmap	mCompassRoseBitmap
protected float	mCompassRoseCenterX
protected float	mCompassRoseCenterY
static int	MENU_COMPASS
protected MapView	mMapView
IOrientationProvider	mOrientationProvider
protected android.graphics.Paint	mPaint

Fields inherited from class org.osmdroid.views.overlay.Overlay

mResourceProxy, mScale, SHADOW_X_SKEW, SHADOW_Y_SCALE

Fields inherited from interface org.osmdroid.views.util.constants.OverlayConstants

DEBUGMODE, DEFAULT_ZOOMLEVEL_MINIMAP_DIFFERENCE, NOT_SET

Constructor Summary

Constructors

Constructor and Description
CompassOverlay(android.content.Context context, IOrientationProvider orientationProvider, MapView mapView)
CompassOverlay(android.content.Context context, IOrientationProvider orientationProvider, MapView mapView, ResourceProxy pResourceProxy)
CompassOverlay(android.content.Context context, MapView mapView)

Method Summary

Methods

Modifier and Type	Method and Description
void	disableCompass() Disable orientation updates
protected void	draw(android.graphics.Canvas c, MapView mapView, boolean shadow) Draw the overlay over the map.
protected void	drawCompass(android.graphics.Canvas canvas, float bearing, android.graphics.Rect screenRect)
boolean	enableCompass() Enable receiving orientation updates from the provided IOrientationProvider and show a compass on the map.
boolean	enableCompass(IOrientationProvider orientationProvider)
float	getOrientation()
IOrientationProvider	getOrientationProvider()
boolean	isCompassEnabled() If enabled, the map is receiving orientation updates and drawing your location on the map.
boolean	isOptionsMenuEnabled() Can be used to signal to external callers that this Overlay should not be used for providing option menu items.
boolean	onCreateOptionsMenu(android.view.Menu pMenu, int pMenuIdOffset, MapView pMapView)
void	onDetach(MapView mapView) Override to perform clean up of resources before shutdown.
boolean	onOptionsItemSelected(android.view.MenuItem pItem, int pMenuIdOffset, MapView pMapView)
void	onOrientationChanged(float orientation, IOrientationProvider source)
boolean	onPrepareOptionsMenu(android.view.Menu pMenu, int pMenuIdOffset, MapView pMapView)
void	setCompassCenter(float x, float y)
void	setOptionsMenuEnabled(boolean pOptionsMenuEnabled)
protected void	setOrientationProvider(IOrientationProvider orientationProvider)

Methods inherited from class org.osmdroid.views.overlay.Overlay

drawAt, getSafeMenuId, getSafeMenuIdSequence, isEnabled, onDoubleTap, onDoubleTapEvent, onDown, onFling, onKeyDown, onKeyUp, onLongPress, onScroll, onShowPress, onSingleTapConfirmed, onSingleTapUp, onTouchEvent, onTrackballEvent, setEnabled

Methods inherited from class java.lang.Object

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

Field Detail

mMapView

protected final MapView mMapView

mOrientationProvider

public IOrientationProvider mOrientationProvider

mPaint

protected final android.graphics.Paint mPaint

mCompassFrameBitmap

protected android.graphics.Bitmap mCompassFrameBitmap

mCompassRoseBitmap

protected android.graphics.Bitmap mCompassRoseBitmap

mCompassFrameCenterX

protected final float mCompassFrameCenterX

mCompassFrameCenterY

protected final float mCompassFrameCenterY

mCompassRoseCenterX

protected final float mCompassRoseCenterX

mCompassRoseCenterY

protected final float mCompassRoseCenterY

MENU_COMPASS

public static final int MENU_COMPASS

Constructor Detail

CompassOverlay

public CompassOverlay(android.content.Context context,
              MapView mapView)

CompassOverlay

public CompassOverlay(android.content.Context context,
              IOrientationProvider orientationProvider,
              MapView mapView)

CompassOverlay

public CompassOverlay(android.content.Context context,
              IOrientationProvider orientationProvider,
              MapView mapView,
              ResourceProxy pResourceProxy)

Method Detail

onDetach

public void onDetach(MapView mapView)

Description copied from class: Overlay

Override to perform clean up of resources before shutdown. By default does nothing.

Overrides:

onDetach in class Overlay

setCompassCenter

public void setCompassCenter(float x,
                    float y)

getOrientationProvider

public IOrientationProvider getOrientationProvider()

setOrientationProvider

protected void setOrientationProvider(IOrientationProvider orientationProvider)

drawCompass

protected void drawCompass(android.graphics.Canvas canvas,
               float bearing,
               android.graphics.Rect screenRect)

draw

protected void draw(android.graphics.Canvas c,
        MapView mapView,
        boolean shadow)

Description copied from class: Overlay

Draw the overlay over the map. This will be called on all active overlays with shadow=true, to lay down the shadow layer, and then again on all overlays with shadow=false. Callers should check isEnabled() before calling draw(). By default, draws nothing.

Specified by:

draw in class Overlay

setOptionsMenuEnabled

public void setOptionsMenuEnabled(boolean pOptionsMenuEnabled)

Specified by:

setOptionsMenuEnabled in interface IOverlayMenuProvider

isOptionsMenuEnabled

public boolean isOptionsMenuEnabled()

Description copied from interface: IOverlayMenuProvider

Can be used to signal to external callers that this Overlay should not be used for providing option menu items.

Specified by:

isOptionsMenuEnabled in interface IOverlayMenuProvider

onCreateOptionsMenu

public boolean onCreateOptionsMenu(android.view.Menu pMenu,
                          int pMenuIdOffset,
                          MapView pMapView)

Specified by:

onCreateOptionsMenu in interface IOverlayMenuProvider

onPrepareOptionsMenu

public boolean onPrepareOptionsMenu(android.view.Menu pMenu,
                           int pMenuIdOffset,
                           MapView pMapView)

Specified by:

onPrepareOptionsMenu in interface IOverlayMenuProvider

onOptionsItemSelected

public boolean onOptionsItemSelected(android.view.MenuItem pItem,
                            int pMenuIdOffset,
                            MapView pMapView)

Specified by:

onOptionsItemSelected in interface IOverlayMenuProvider

onOrientationChanged

public void onOrientationChanged(float orientation,
                        IOrientationProvider source)

Specified by:

onOrientationChanged in interface IOrientationConsumer

enableCompass

public boolean enableCompass(IOrientationProvider orientationProvider)

enableCompass

public boolean enableCompass()

Enable receiving orientation updates from the provided IOrientationProvider and show a compass on the map. You will likely want to call enableCompass() from your Activity's Activity.onResume() method, to enable the features of this overlay. Remember to call the corresponding disableCompass() in your Activity's Activity.onPause() method to turn off updates when in the background.

disableCompass

public void disableCompass()

Disable orientation updates

isCompassEnabled

public boolean isCompassEnabled()

If enabled, the map is receiving orientation updates and drawing your location on the map.

Returns:

true if enabled, false otherwise

getOrientation

public float getOrientation()