MapTouchController

java.lang.Object
- com.atakmap.android.maps.MapTouchController

All Implemented Interfaces:: android.view.GestureDetector.OnDoubleTapListener, android.view.GestureDetector.OnGestureListener, android.view.View.OnTouchListener, ScaleGestureDetector.OnScaleGestureListener

public class MapTouchController
extends java.lang.Object
implements android.view.View.OnTouchListener, android.view.GestureDetector.OnGestureListener, ScaleGestureDetector.OnScaleGestureListener, android.view.GestureDetector.OnDoubleTapListener

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static interface MapTouchController.DeconflictionListener

Nested Classes
Modifier and Type	Class and Description
`static interface`	`MapTouchController.DeconflictionListener`

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`MAXITEMS`
`static int`	`STATE_MANUAL_TILT_DISABLED`
`static int`	`STATE_PROGRAMATIC_TILT_DISABLED`
`static int`	`STATE_TILT_DISABLED`
`static int`	`STATE_TILT_ENABLED`
`static java.lang.String`	`TAG`

Constructor Summary

Constructors
Constructor and Description

MapTouchController(MapView view)

Constructors
Constructor and Description
`MapTouchController(MapView view)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected java.util.SortedSet<MapItem>`	`_fetchOrthoHitItems(android.view.MotionEvent event, int limit)`
`void`	`addDeconflictionListener(MapTouchController.DeconflictionListener l)` Add a custom deconfliction filter this is responsible for doing something wtih the sorted set.
`void`	`cancelMotionEvents()`
`void`	`dispose()`
`void`	`focus(MapItem item)`
`PointMapItem`	`getFreeForm3DItem()`
`GeoPoint`	`getFreeForm3DPoint()`
`boolean`	`getInGesture()`
`int`	`getTiltEnabledState()` Get the current tilt lock state
`static boolean`	`goTo(MapItem item, boolean select)` Pan, zoom, and bring up radial and coord overlay for a map item
`boolean`	`isCameraPanToEnabled()`
`boolean`	`isFreeForm3DEnabled()`
`boolean`	`isLongPressDragging()`
`boolean`	`isNadirClamped()` Check if the map view tilt is zero and NADIR clamping is enabled since the last touch event
`boolean`	`isUserOrientationEnabled()` Whether the user has free control over the map rotation
`static boolean`	`isValidErrorEllipse(double v)` Check to see if the value ie either a valid CE or LE.
`void`	`lockControls()`
`void`	`lockScaleFocus()` Lock the scale focus to whatever the focus point This will update when the map view size changes
`void`	`lockScaleFocus(int pixelx, int pixely)`
`boolean`	`onDoubleTap(android.view.MotionEvent event)`
`boolean`	`onDoubleTapEvent(android.view.MotionEvent event)`
`boolean`	`onDown(android.view.MotionEvent event)`
`boolean`	`onFling(android.view.MotionEvent arg0, android.view.MotionEvent arg1, float arg2, float arg3)`
`protected void`	`onItemDoubleTap(MapItem item, android.view.MotionEvent event)`
`protected void`	`onItemDragContinued(MapItem item, android.view.MotionEvent event)`
`protected void`	`onItemDragDropped(MapItem item, android.view.MotionEvent event)`
`protected boolean`	`onItemDragStarted(MapItem item, android.view.MotionEvent event)`
`protected void`	`onItemLongPress(MapItem item, android.view.MotionEvent event)`
`protected void`	`onItemPress(MapItem item, android.view.MotionEvent event)`
`protected void`	`onItemRelease(MapItem item, android.view.MotionEvent event)`
`protected boolean`	`onItemSingleTap(MapItem item, android.view.MotionEvent event)`
`void`	`onLongPress(android.view.MotionEvent event)`
`protected void`	`onMapDoubleTap(android.view.MotionEvent event)`
`protected void`	`onMapLongPress(android.view.MotionEvent event)`
`protected void`	`onMapPress(android.view.MotionEvent event)`
`protected void`	`onMapPress(android.view.MotionEvent event, GeoPoint touchPoint)`
`protected void`	`onMapRelease(android.view.MotionEvent event)`
`protected void`	`onMapSingleTap(android.view.MotionEvent event)`
`boolean`	`onScale(ScaleGestureDetector detector)` Responds to scaling events for a gesture in progress.
`boolean`	`onScaleBegin(ScaleGestureDetector detector)` Responds to the beginning of a scaling gesture.
`void`	`onScaleEnd(ScaleGestureDetector detector)` Responds to the end of a scale gesture.
`void`	`onScaleEvent(MapEvent event)` Default scale event handling called by `MapTouchEventListener`
`boolean`	`onScroll(android.view.MotionEvent e1, android.view.MotionEvent e2, float dx, float dy)`
`void`	`onShowPress(android.view.MotionEvent arg0)`
`boolean`	`onSingleTapConfirmed(android.view.MotionEvent event)`
`boolean`	`onSingleTapUp(android.view.MotionEvent arg0)`
`boolean`	`onTouch(android.view.View v, android.view.MotionEvent event)`
`void`	`removeDeconflictionListener(MapTouchController.DeconflictionListener l)` Remove a custom deconfliction filter this is responsible for doing something wtih the sorted set.
`void`	`setCameraPanToEnabled(boolean b)`
`void`	`setFreeForm3DEnabled(boolean enabled)` Set whether 3D free look is enabled
`void`	`setFreeForm3DItem(MapItem item)` Set the focused map item in free form 3D mode
`void`	`setFreeForm3DPoint(GeoPoint point)`
`void`	`setTiltEnabledState(int state)` Allows for programmatic setting of the tilt lock state.
`void`	`setToolActive(boolean toolActive)`
`void`	`setUserOrientation(boolean orientation)` Set whether the user has free control over the map rotation
`void`	`skipDeconfliction(boolean skip)`
`void`	`unlockControls()`
`void`	`unlockScaleFocus()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - TAG
```
public static final java.lang.String TAG
```
    See Also:
    
    Constant Field Values
  - MAXITEMS
```
public static final int MAXITEMS
```
    See Also:
    
    Constant Field Values
  - STATE_TILT_ENABLED
```
public static final int STATE_TILT_ENABLED
```
    See Also:
    
    Constant Field Values
  - STATE_MANUAL_TILT_DISABLED
```
public static final int STATE_MANUAL_TILT_DISABLED
```
    See Also:
    
    Constant Field Values
  - STATE_PROGRAMATIC_TILT_DISABLED
```
public static final int STATE_PROGRAMATIC_TILT_DISABLED
```
    See Also:
    
    Constant Field Values
  - STATE_TILT_DISABLED
```
public static final int STATE_TILT_DISABLED
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - MapTouchController
```
public MapTouchController(MapView view)
```
- Method Detail
  - lockControls
```
public void lockControls()
```
  - unlockControls
```
public void unlockControls()
```
  - dispose
```
public void dispose()
```
  - setCameraPanToEnabled
```
public void setCameraPanToEnabled(boolean b)
```
  - isCameraPanToEnabled
```
public boolean isCameraPanToEnabled()
```
  - onItemLongPress
```
protected void onItemLongPress(MapItem item,
                               android.view.MotionEvent event)
```
  - onItemDragStarted
```
protected boolean onItemDragStarted(MapItem item,
                                    android.view.MotionEvent event)
```
  - onItemDragContinued
```
protected void onItemDragContinued(MapItem item,
                                   android.view.MotionEvent event)
```
  - onItemDragDropped
```
protected void onItemDragDropped(MapItem item,
                                 android.view.MotionEvent event)
```
  - onMapLongPress
```
protected void onMapLongPress(android.view.MotionEvent event)
```
  - onItemPress
```
protected void onItemPress(MapItem item,
                           android.view.MotionEvent event)
```
  - onMapPress
```
protected void onMapPress(android.view.MotionEvent event)
```
  - onMapPress
```
protected void onMapPress(android.view.MotionEvent event,
                          GeoPoint touchPoint)
```
  - onItemDoubleTap
```
protected void onItemDoubleTap(MapItem item,
                               android.view.MotionEvent event)
```
  - onMapDoubleTap
```
protected void onMapDoubleTap(android.view.MotionEvent event)
```
  - onItemSingleTap
```
protected boolean onItemSingleTap(MapItem item,
                                  android.view.MotionEvent event)
```
    Parameters:
    
    item - MapItem that was clicked.
    
    event - Event representing the click.
    
    Returns:
    
    True if the item click was handled.
  - onMapSingleTap
```
protected void onMapSingleTap(android.view.MotionEvent event)
```
  - onItemRelease
```
protected void onItemRelease(MapItem item,
                             android.view.MotionEvent event)
```
  - onMapRelease
```
protected void onMapRelease(android.view.MotionEvent event)
```
  - onTouch
```
public boolean onTouch(android.view.View v,
                       android.view.MotionEvent event)
```
    Specified by:
    
    onTouch in interface android.view.View.OnTouchListener
  - onDown
```
public boolean onDown(android.view.MotionEvent event)
```
    Specified by:
    
    onDown in interface android.view.GestureDetector.OnGestureListener
  - onFling
```
public boolean onFling(android.view.MotionEvent arg0,
                       android.view.MotionEvent arg1,
                       float arg2,
                       float arg3)
```
    Specified by:
    
    onFling in interface android.view.GestureDetector.OnGestureListener
  - onLongPress
```
public void onLongPress(android.view.MotionEvent event)
```
    Specified by:
    
    onLongPress in interface android.view.GestureDetector.OnGestureListener
  - addDeconflictionListener
```
public void addDeconflictionListener(MapTouchController.DeconflictionListener l)
```
    Add a custom deconfliction filter this is responsible for doing something wtih the sorted set.
    
    Parameters:
    
    l - the deconfliction listener.
  - removeDeconflictionListener
```
public void removeDeconflictionListener(MapTouchController.DeconflictionListener l)
```
    Remove a custom deconfliction filter this is responsible for doing something wtih the sorted set.
    
    Parameters:
    
    l - the deconfliction listener.
  - goTo
```
public static boolean goTo(MapItem item,
                           boolean select)
```
    Pan, zoom, and bring up radial and coord overlay for a map item
    
    Parameters:
    
    item - The map item to go to
    
    select - True to bring up radial, false to just focus on
    
    Returns:
    
    True if the map was able to go to the item
  - focus
```
public void focus(MapItem item)
```
  - isValidErrorEllipse
```
public static boolean isValidErrorEllipse(double v)
```
    Check to see if the value ie either a valid CE or LE.
    
    Parameters:
    
    v - the value to check.
    
    Returns:
    
    true if the value is valid.
  - _fetchOrthoHitItems
```
protected java.util.SortedSet<MapItem> _fetchOrthoHitItems(android.view.MotionEvent event,
                                                           int limit)
```
  - onScroll
```
public boolean onScroll(android.view.MotionEvent e1,
                        android.view.MotionEvent e2,
                        float dx,
                        float dy)
```
    Specified by:
    
    onScroll in interface android.view.GestureDetector.OnGestureListener
  - onShowPress
```
public void onShowPress(android.view.MotionEvent arg0)
```
    Specified by:
    
    onShowPress in interface android.view.GestureDetector.OnGestureListener
  - onSingleTapUp
```
public boolean onSingleTapUp(android.view.MotionEvent arg0)
```
    Specified by:
    
    onSingleTapUp in interface android.view.GestureDetector.OnGestureListener
  - setUserOrientation
```
public void setUserOrientation(boolean orientation)
```
    Set whether the user has free control over the map rotation
    
    Parameters:
    
    orientation - True if user-controlled map rotation enabled
  - isUserOrientationEnabled
```
public boolean isUserOrientationEnabled()
```
    Whether the user has free control over the map rotation
    
    Returns:
    
    True if user-controlled map rotation enabled
  - setTiltEnabledState
```
public void setTiltEnabledState(int state)
```
    Allows for programmatic setting of the tilt lock state. The
    
    Parameters:
    
    state - can either be: STATE_TILT_ENABLED=0, STATE_MANUAL_TILT_DISABLED=1, STATE_PROGRAMATIC_TILT_DISABLED=2, STATE_TILT_DISABLED=3
  - getTiltEnabledState
```
public int getTiltEnabledState()
```
    Get the current tilt lock state
    
    Returns:
    
    Tilt lock state
  - setFreeForm3DEnabled
```
public void setFreeForm3DEnabled(boolean enabled)
```
    Set whether 3D free look is enabled
    
    Parameters:
    
    enabled - True if enabeld
  - setFreeForm3DItem
```
public void setFreeForm3DItem(MapItem item)
```
    Set the focused map item in free form 3D mode
    
    Parameters:
    
    item - Map item
  - getFreeForm3DItem
```
public PointMapItem getFreeForm3DItem()
```
  - setFreeForm3DPoint
```
public void setFreeForm3DPoint(GeoPoint point)
```
  - getFreeForm3DPoint
```
public GeoPoint getFreeForm3DPoint()
```
  - isFreeForm3DEnabled
```
public boolean isFreeForm3DEnabled()
```
  - onScale
```
public boolean onScale(ScaleGestureDetector detector)
```
    Description copied from interface: ScaleGestureDetector.OnScaleGestureListener
    
    Responds to scaling events for a gesture in progress. Reported by pointer motion.
    
    Specified by:
    
    onScale in interface ScaleGestureDetector.OnScaleGestureListener
    
    Parameters:
    
    detector - The detector reporting the event - use this to retrieve extended info about event state.
    
    Returns:
    
    Whether or not the detector should consider this event as handled. If an event was not handled, the detector will continue to accumulate movement until an event is handled. This can be useful if an application, for example, only wants to update scaling factors if the change is greater than 0.01.
  - onScaleBegin
```
public boolean onScaleBegin(ScaleGestureDetector detector)
```
    Description copied from interface: ScaleGestureDetector.OnScaleGestureListener
    
    Responds to the beginning of a scaling gesture. Reported by new pointers going down.
    
    Specified by:
    
    onScaleBegin in interface ScaleGestureDetector.OnScaleGestureListener
    
    Parameters:
    
    detector - The detector reporting the event - use this to retrieve extended info about event state.
    
    Returns:
    
    Whether or not the detector should continue recognizing this gesture. For example, if a gesture is beginning with a focal point outside of a region where it makes sense, onScaleBegin() may return false to ignore the rest of the gesture.
  - onScaleEnd
```
public void onScaleEnd(ScaleGestureDetector detector)
```
    Description copied from interface: ScaleGestureDetector.OnScaleGestureListener
    
    Responds to the end of a scale gesture. Reported by existing pointers going up. Once a scale has ended, ScaleGestureDetector.getFocusX() and ScaleGestureDetector.getFocusY() will return the location of the pointer remaining on the screen.
    
    Specified by:
    
    onScaleEnd in interface ScaleGestureDetector.OnScaleGestureListener
    
    Parameters:
    
    detector - The detector reporting the event - use this to retrieve extended info about event state.
  - onDoubleTap
```
public boolean onDoubleTap(android.view.MotionEvent event)
```
    Specified by:
    
    onDoubleTap in interface android.view.GestureDetector.OnDoubleTapListener
  - onDoubleTapEvent
```
public boolean onDoubleTapEvent(android.view.MotionEvent event)
```
    Specified by:
    
    onDoubleTapEvent in interface android.view.GestureDetector.OnDoubleTapListener
  - onSingleTapConfirmed
```
public boolean onSingleTapConfirmed(android.view.MotionEvent event)
```
    Specified by:
    
    onSingleTapConfirmed in interface android.view.GestureDetector.OnDoubleTapListener
  - onScaleEvent
```
public void onScaleEvent(MapEvent event)
```
    Default scale event handling called by MapTouchEventListener
    
    Parameters:
    
    event - MapEvent.MAP_SCALE event
  - lockScaleFocus
```
public void lockScaleFocus()
```
    Lock the scale focus to whatever the focus point This will update when the map view size changes
  - lockScaleFocus
```
public void lockScaleFocus(int pixelx,
                           int pixely)
```
  - unlockScaleFocus
```
public void unlockScaleFocus()
```
  - getInGesture
```
public boolean getInGesture()
```
  - isLongPressDragging
```
public boolean isLongPressDragging()
```
  - cancelMotionEvents
```
public void cancelMotionEvents()
```
  - setToolActive
```
public void setToolActive(boolean toolActive)
```
  - skipDeconfliction
```
public void skipDeconfliction(boolean skip)
```
  - isNadirClamped
```
public boolean isNadirClamped()
```
    Check if the map view tilt is zero and NADIR clamping is enabled since the last touch event
    
    Returns:
    
    True if NADIR and clamping enabled

Class MapTouchController

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

TAG

MAXITEMS

STATE_TILT_ENABLED

STATE_MANUAL_TILT_DISABLED

STATE_PROGRAMATIC_TILT_DISABLED

STATE_TILT_DISABLED

Constructor Detail

MapTouchController

Method Detail

lockControls

unlockControls

dispose

setCameraPanToEnabled

isCameraPanToEnabled

onItemLongPress

onItemDragStarted

onItemDragContinued

onItemDragDropped

onMapLongPress

onItemPress

onMapPress

onMapPress

onItemDoubleTap

onMapDoubleTap

onItemSingleTap

onMapSingleTap

onItemRelease

onMapRelease

onTouch

onDown

onFling

onLongPress

addDeconflictionListener

removeDeconflictionListener

goTo

focus

isValidErrorEllipse

_fetchOrthoHitItems

onScroll

onShowPress

onSingleTapUp

setUserOrientation

isUserOrientationEnabled

setTiltEnabledState

getTiltEnabledState

setFreeForm3DEnabled

setFreeForm3DItem

getFreeForm3DItem

setFreeForm3DPoint

getFreeForm3DPoint

isFreeForm3DEnabled

onScale

onScaleBegin

onScaleEnd

onDoubleTap

onDoubleTapEvent

onSingleTapConfirmed

onScaleEvent

lockScaleFocus

lockScaleFocus

unlockScaleFocus

getInGesture

isLongPressDragging

cancelMotionEvents

setToolActive

skipDeconfliction

isNadirClamped