com.atakmap.android.maps

Class MapView

java.lang.Object

AtakMapView

com.atakmap.android.maps.MapView

public class MapView
extends AtakMapView

The content view for a MapActivity

Responsible for dispatched MapEvents:

• MapEvent.MAP_MOVED when the position, zoom, or focus changes

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MapView.RenderStack

Field Summary

Fields

Modifier and Type	Field and Description
static MapView	_mapView
static java.lang.String	GDAL_DIRNAME

Constructor Summary

Constructors

Constructor and Description
MapView(android.content.Context context, android.util.AttributeSet attrs) Create the view in a given context and attributes

Method Summary

Modifier and Type	Method and Description
void	addLayer(MapView.RenderStack stack, int position, Layer layer)
void	addLayer(MapView.RenderStack stack, Layer layer)
void	addOnGenericMotionListener(android.view.View.OnGenericMotionListener l) Adds the specified View.OnGenericMotionListener
void	addOnKeyListener(android.view.View.OnKeyListener l) Adds the specified View.OnKeyListener
void	addOnTouchListener(android.view.View.OnTouchListener l) Adds the specified View.OnTouchListener.
void	addOnTouchListenerAt(int index, android.view.View.OnTouchListener l) Adds the specified View.OnTouchListener at the specified index.
GeoBounds	createHitbox(GeoPoint center, double radius) Deprecated. No longer efficient with perspective camera rendering Utilize screen point data from the GL thread where possible
void	destroy()
boolean	dispatchKeyEvent(android.view.KeyEvent event)
void	executeOnActive(java.lang.Runnable task) Run a task only if/when the map activity is active For more info see MapActivity.executeOnActive(Runnable)
GeoPointMetaData	getCenterPoint()
java.lang.Object	getComponentExtra(java.lang.String name) Get arbitrary data set by a MapComponent.
java.lang.String	getDeviceCallsign() Retreives the device callsign.
static java.lang.String	getDeviceUid() Returns the device uid which is exactly the same as the self markers uid.
double	getFramerate() Returns the current calculated framerate of the app.
android.os.Bundle	getGPUInfo() Returns a bundle with some basic GPU information.
GLAntiMeridianHelper	getIDLHelper()
java.util.List<Layer>	getLayers(MapView.RenderStack stack)
MapData	getMapData() Obtain data associated with the map that is not defined by any other MapView getters and setters.
MapEventDispatcher	getMapEventDispatcher()
MapItem	getMapItem(java.lang.String uid) Return the MapItem if contained on the MapView provided a UID.
MapOverlayManager	getMapOverlayManager()
MapTouchController	getMapTouchController() Get the object that controls the map based on touch gestures
static MapView	getMapView() Obtain the MapView.
double	getMaxMapTilt() Returns the maximum allowed tilt level for the system.
double	getMaxMapTilt(double mapScale) Returns the maximum allowed tilt level for the system at a specific map scale.
double	getMinMapTilt() At any given zoom level, there may be a point in which there is a minimal tilt level.
double	getMinMapTilt(double mapScale) At any given zoom level, there may be a point in which there is a minimal tilt level.
GeoPointMetaData	getPointWithElevation() Obtains the centerpoint of the MapView with the associated Elevation.
GeoPointMetaData	getPrecisePoint(GeoPointMetaData geoPoint) Deprecated. Will be removed without replacement
RasterLayer2	getRasterLayerAt2(GeoPoint point)
RootMapGroup	getRootGroup() Get the root MapGroup
Marker	getSelfMarker() Obtain the self marker for the system.
protected void	initGLSurface()
GeoPointMetaData	inverseWithElevation(float x, float y) Deprecated. See MapRenderer2#inverse(PointD, GeoPoint, MapRenderer2.InverseMode, int, MapRenderer2.DisplayOrigin) and ElevationManager#getElevation(double, double, ElevationManager.QueryParameters, GeoPointMetaData)
boolean	isAutoSelectProjection() Return the state of the map if auto selection of the projection is enabled.
boolean	isPortrait()
boolean	onGenericMotionEvent(android.view.MotionEvent event)
protected void	onMapMoved()
protected void	onSizeChanged(int w, int h, int oldw, int oldh)
void	popStack(MapView.RenderStack stack)
void	postOnActive(java.lang.Runnable task) Post a task only if/when the map activity is active For more info see MapActivity.postOnActive(Runnable)
void	pushStack(MapView.RenderStack stack)
protected void	registerServiceProviders()
void	removeLayer(MapView.RenderStack stack, Layer layer)
void	removeOnGenericMotionListener(android.view.View.OnGenericMotionListener l) Removes the specified View.OnGenericMotionListener
void	removeOnKeyListener(android.view.View.OnKeyListener l) Removes the specified View.OnKeyListener
boolean	removeOnTouchListener(android.view.View.OnTouchListener l) Removes the specified View.OnTouchListener.
void	setAutoSelectProjection(boolean auto)
void	setComponentExtra(java.lang.String name, java.lang.Object extra) Set arbitrary data from a MapComponent.
void	setDeviceCallsign(java.lang.String callsign) Used to set the transient value of the device callsign and does not effect the default user callsign between system restarts.
boolean	setProjection(Projection proj)
void	setRelativeScaling(float s)
void	setSelfMarker(Marker m) Method called by LocationMapComponent to register the self marker with the rest of the system.
void	updateView(double latitude, double longitude, double scale, double rotation, double tilt, boolean animate)

Methods inherited from class java.lang.Object

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

Field Detail

_mapView

public static MapView _mapView

GDAL_DIRNAME

public static final java.lang.String GDAL_DIRNAME

Constructor Detail

MapView

public MapView(android.content.Context context,
               android.util.AttributeSet attrs)

Create the view in a given context and attributes

Parameters:

context - the context

attrs - the attributes

Method Detail

getMapView

public static MapView getMapView()

Obtain the MapView. The obtained reference to the mapView is only guaranteed to be non-null after MapView construction and prior to a call to dispose()

destroy

public void destroy()

registerServiceProviders

protected void registerServiceProviders()

initGLSurface

protected void initGLSurface()

getFramerate

public double getFramerate()

Returns the current calculated framerate of the app.

getGPUInfo

public android.os.Bundle getGPUInfo()

Returns a bundle with some basic GPU information.

setRelativeScaling

public void setRelativeScaling(float s)

getMapTouchController

public MapTouchController getMapTouchController()

Get the object that controls the map based on touch gestures

Returns:

the MapTouchController for the map view.

addOnTouchListener

public void addOnTouchListener(android.view.View.OnTouchListener l)

Adds the specified View.OnTouchListener.

Parameters:

l - The View.OnTouchListener to add

addOnTouchListenerAt

public void addOnTouchListenerAt(int index,
                                 android.view.View.OnTouchListener l)

Adds the specified View.OnTouchListener at the specified index. The specified listener may intercept touch events prior to all other registered listeners by specifying an index of 0.

Parameters:

index - The index

l - The View.OnTouchListener to add

removeOnTouchListener

public boolean removeOnTouchListener(android.view.View.OnTouchListener l)

Removes the specified View.OnTouchListener.

Parameters:

l - The View.OnTouchListener to add

addOnKeyListener

public void addOnKeyListener(android.view.View.OnKeyListener l)

Adds the specified View.OnKeyListener

Parameters:

l - The View.OnKeyListener to add

removeOnKeyListener

public void removeOnKeyListener(android.view.View.OnKeyListener l)

Removes the specified View.OnKeyListener

Parameters:

l - The View.OnKeyListener to remove

addOnGenericMotionListener

public void addOnGenericMotionListener(android.view.View.OnGenericMotionListener l)

Adds the specified View.OnGenericMotionListener

Parameters:

l - The View.OnGenericMotionListener to add

removeOnGenericMotionListener

public void removeOnGenericMotionListener(android.view.View.OnGenericMotionListener l)

Removes the specified View.OnGenericMotionListener

Parameters:

l - The View.OnGenericMotionListener to remove

dispatchKeyEvent

public final boolean dispatchKeyEvent(android.view.KeyEvent event)

onGenericMotionEvent

public final boolean onGenericMotionEvent(android.view.MotionEvent event)

onMapMoved

protected void onMapMoved()

getMapEventDispatcher

public MapEventDispatcher getMapEventDispatcher()

getMapOverlayManager

public MapOverlayManager getMapOverlayManager()

getRootGroup

public RootMapGroup getRootGroup()

Get the root MapGroup

Returns:

return the root map group

getMapItem

public MapItem getMapItem(java.lang.String uid)

Return the MapItem if contained on the MapView provided a UID. Although this is not marked deprecated, please use getRootGroup().deepFindItemWithDataString("uid", uid) or getRootGroup().deepFindUID(uid)

addLayer

public void addLayer(MapView.RenderStack stack,
                     Layer layer)

addLayer

public void addLayer(MapView.RenderStack stack,
                     int position,
                     Layer layer)

removeLayer

public void removeLayer(MapView.RenderStack stack,
                        Layer layer)

pushStack

public void pushStack(MapView.RenderStack stack)

popStack

public void popStack(MapView.RenderStack stack)

getLayers

public java.util.List<Layer> getLayers(MapView.RenderStack stack)

getPrecisePoint

@Deprecated
public GeoPointMetaData getPrecisePoint(GeoPointMetaData geoPoint)

Deprecated. Will be removed without replacement

Returns a precise point, derived from the underlying imagery, based on the specified point as projected into the current view.

Parameters:

geoPoint - A coordinate

Returns:

A precise coordinate, possibly containing CE/LE and elevation information that is derived from the underlying imagery.

getRasterLayerAt2

public RasterLayer2 getRasterLayerAt2(GeoPoint point)

getDeviceCallsign

public java.lang.String getDeviceCallsign()

Retreives the device callsign. This may be different than the callsign stored in shared preferences if the device is making use of the wave relay callsign that is being passed to it via callsign mocking. Callsign mocking is considered to be temporary and when the callsign is no longer being mocked, the device will revert back to the callsign set in shared preferences. If you would like to know the shared preference version of the callsign, please use the key "locationCallsign" to query the saved preference value.

Returns:

the current callsign based on a combination of the shared preference and the validitity of the mocking state.

getDeviceUid

public static java.lang.String getDeviceUid()

Returns the device uid which is exactly the same as the self markers uid.

setDeviceCallsign

public void setDeviceCallsign(java.lang.String callsign)

Used to set the transient value of the device callsign and does not effect the default user callsign between system restarts. To change the device callsign please make use of the shared preference key "locationCallsign".

Parameters:

callsign - the transient state of the device callsign which does not persist.

setComponentExtra

public void setComponentExtra(java.lang.String name,
                              java.lang.Object extra)

Set arbitrary data from a MapComponent. This makes the data available to other MapComponents. This is useful for loosely coupling MapComponents.

Parameters:

name - a unique name for the extra data Object

extra - the extra data Object

getComponentExtra

public java.lang.Object getComponentExtra(java.lang.String name)

Get arbitrary data set by a MapComponent. This allows for dynamic coupling of MapComponents.

Parameters:

name - the unique name of the extra Object

Returns:

an extra related to the component

getMapData

public MapData getMapData()

Obtain data associated with the map that is not defined by any other MapView getters and setters.

Returns:

MapData a bundle like structure of name value pairs.

isAutoSelectProjection

public boolean isAutoSelectProjection()

Return the state of the map if auto selection of the projection is enabled.

setAutoSelectProjection

public void setAutoSelectProjection(boolean auto)

inverseWithElevation

@Deprecated
public GeoPointMetaData inverseWithElevation(float x,
                                                         float y)

Deprecated. See MapRenderer2#inverse(PointD, GeoPoint, MapRenderer2.InverseMode, int, MapRenderer2.DisplayOrigin) and ElevationManager#getElevation(double, double, ElevationManager.QueryParameters, GeoPointMetaData)

Computes the corresponding geodetic coordinate for the specified screen coordinate with the addition of looking up the elevation data.

Parameters:

x - the x value for the screen coordinate

y - the y value for the screen coordinate

setSelfMarker

public void setSelfMarker(Marker m)

Method called by LocationMapComponent to register the self marker with the rest of the system. Once the self marker is initialized, it will not be possible to reinitialize it or set it to another value.

Parameters:

m - the self marker.

getSelfMarker

public Marker getSelfMarker()

Obtain the self marker for the system.

Returns:

the self marker for the system.

getIDLHelper

public GLAntiMeridianHelper getIDLHelper()

getPointWithElevation

public GeoPointMetaData getPointWithElevation()

Obtains the centerpoint of the MapView with the associated Elevation.

Returns:

the center point of the map with the best available DTED elevation for the altitude/elevation.

getCenterPoint

public GeoPointMetaData getCenterPoint()

createHitbox

@Deprecated
public GeoBounds createHitbox(GeoPoint center,
                                          double radius)

Deprecated. No longer efficient with perspective camera rendering Utilize screen point data from the GL thread where possible

Create a hit box for detecting touch events

Parameters:

center - Center point of hit box

radius - Inner radius of hit box in pixels

Returns:

GeoBounds hit box

onSizeChanged

protected void onSizeChanged(int w,
                             int h,
                             int oldw,
                             int oldh)

isPortrait

public boolean isPortrait()

executeOnActive

public void executeOnActive(java.lang.Runnable task)

Run a task only if/when the map activity is active For more info see MapActivity.executeOnActive(Runnable)

Parameters:

task - Task to run

postOnActive

public void postOnActive(java.lang.Runnable task)

Post a task only if/when the map activity is active For more info see MapActivity.postOnActive(Runnable)

Parameters:

task - Task to run if the activity is active (ie onStart has been called).

getMinMapTilt

public double getMinMapTilt()

At any given zoom level, there may be a point in which there is a minimal tilt level. Currently will just return 0.

Returns:

the minimum tilt level.

getMinMapTilt

public double getMinMapTilt(double mapScale)

At any given zoom level, there may be a point in which there is a minimal tilt level. Currently will just return 0.

Parameters:

mapScale - for which to return the value for the mininum map tilt level.

Returns:

the minimum tilt level for the provided mapScale

getMaxMapTilt

public double getMaxMapTilt()

Returns the maximum allowed tilt level for the system.

Returns:

a double representing the maximum tilt for the system.

getMaxMapTilt

public double getMaxMapTilt(double mapScale)

Returns the maximum allowed tilt level for the system at a specific map scale.

Returns:

a double representing the maximum tilt for the current scale value not exceeding the current maximum tilt for the system.

updateView

public void updateView(double latitude,
                       double longitude,
                       double scale,
                       double rotation,
                       double tilt,
                       boolean animate)

setProjection

public boolean setProjection(Projection proj)