com.atakmap.android.drawing.tools

Class TelestrationTool

java.lang.Object

com.atakmap.android.toolbar.Tool

com.atakmap.android.drawing.tools.TelestrationTool

All Implemented Interfaces:

android.view.View.OnKeyListener

public class TelestrationTool
extends Tool

Modified from ShapeCreationTool Telestration provides the user with functionality to freehand mark on the map surface. Captures the touch and drag points of the user and on release draws a simplified polyline.

Field Summary

Fields

Modifier and Type	Field and Description
protected MapGroup	_mapGroup
static java.lang.String	TOOL_IDENTIFIER
protected java.util.Stack<DrawingShape>	undoStack

Fields inherited from class com.atakmap.android.toolbar.Tool

_identifier, _mapListenerCount

Constructor Summary

Constructors

Constructor and Description
TelestrationTool(MapView mapView, MapGroup drawingGroup, android.widget.ImageButton teleStrationButton, DrawingToolsToolbar drawingToolsToolbar, android.widget.ImageButton toggleButton, android.widget.Button undoButton, android.widget.Button doneButton, android.widget.Button deleteTelestrationButton, android.widget.ImageButton telestrationColorButton, android.content.Context context)

Method Summary

Modifier and Type	Method and Description
protected void	clearExtraListeners() Clears all listeners from the map except for those involved with fundamental map operations, ie pan and pinch.
void	dispose() Called only by the parent during final cleanup activities.
protected void	initButton() Performs button initialization, setting up onclick listeners etc.
boolean	onKey(android.view.View v, int keyCode, android.view.KeyEvent event)
protected boolean	onToolBegin(android.os.Bundle extras) Called when this tool has been asked to start (and after the last tool has cleaned up)
protected void	onToolEnd() Called when this tool has been asked to end, either directly or by the user selecting a new tool or possibly a new toolbar.
protected void	setActive(boolean active) Called to set whether a tool is actively being used.
boolean	shouldEndOnBack() Returns whether this tool should end when the back button is pressed.
void	undo()

Methods inherited from class com.atakmap.android.toolbar.Tool

endTool, findPoint, getActive, getIdentifier, popAllMapListeners, popMapListeners, pushMapListeners, requestBeginTool, requestEndTool

Methods inherited from class java.lang.Object

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

Field Detail

undoStack

protected final java.util.Stack<DrawingShape> undoStack

TOOL_IDENTIFIER

public static final java.lang.String TOOL_IDENTIFIER

See Also:

Constant Field Values

_mapGroup

protected final MapGroup _mapGroup

Constructor Detail

TelestrationTool

public TelestrationTool(MapView mapView,
                        MapGroup drawingGroup,
                        android.widget.ImageButton teleStrationButton,
                        DrawingToolsToolbar drawingToolsToolbar,
                        android.widget.ImageButton toggleButton,
                        android.widget.Button undoButton,
                        android.widget.Button doneButton,
                        android.widget.Button deleteTelestrationButton,
                        android.widget.ImageButton telestrationColorButton,
                        android.content.Context context)

Method Detail

onKey

public boolean onKey(android.view.View v,
                     int keyCode,
                     android.view.KeyEvent event)

Specified by:

onKey in interface android.view.View.OnKeyListener

Overrides:

onKey in class Tool

dispose

public void dispose()

Description copied from class: Tool

Called only by the parent during final cleanup activities.

Specified by:

dispose in class Tool

onToolBegin

protected boolean onToolBegin(android.os.Bundle extras)

Description copied from class: Tool

Called when this tool has been asked to start (and after the last tool has cleaned up)

Overrides:

onToolBegin in class Tool

Parameters:

extras - extra params that were passed by the GUI

Returns:

true if tool is now active, false if it has already finished.

onToolEnd

protected void onToolEnd()

Description copied from class: Tool

Called when this tool has been asked to end, either directly or by the user selecting a new tool or possibly a new toolbar.

Overrides:

onToolEnd in class Tool

shouldEndOnBack

public boolean shouldEndOnBack()

Description copied from class: Tool

Returns whether this tool should end when the back button is pressed.

Overrides:

shouldEndOnBack in class Tool

Returns:

undo

public void undo()

setActive

protected void setActive(boolean active)

Description copied from class: Tool

Called to set whether a tool is actively being used. Generally, this should be automatically handled by the onToolBegin(), onToolEnd() life cycle. Override to update GUI elements to reflect the new value.

Overrides:

setActive in class Tool

clearExtraListeners

protected void clearExtraListeners()

Description copied from class: Tool

Clears all listeners from the map except for those involved with fundamental map operations, ie pan and pinch.

Overrides:

clearExtraListeners in class Tool

initButton

protected void initButton()

Performs button initialization, setting up onclick listeners etc. Overide if the default behavior (start tool if it isn't started, stop if if it is) isn't sufficient.