Package adams.gui.visualization.segmentation.tool

Class AbstractTool

java.lang.Object

adams.core.logging.LoggingObject

adams.core.logging.CustomLoggingLevelObject

adams.gui.visualization.segmentation.tool.AbstractTool

All Implemented Interfaces:

CleanUpHandler, GlobalInfoSupporter, LoggingLevelHandler, LoggingSupporter, SizeOfHandler, Tool, Serializable

Direct Known Subclasses:

AbstractToolWithParameterPanel, Clear, Pointer

public abstract class AbstractTool
extends CustomLoggingLevelObject
implements Tool

Ancestor for tools.

Author:

FracPete (fracpete at waikato dot ac dot nz)

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected ToolKeyAdapter	m_KeyListener	the key listener.
protected ToolMouseAdapter	m_Listener	the mouse listener.
protected ToolMouseMotionAdapter	m_MotionListener	the mouse motion listener.
protected PaintOperation	m_PaintOperation	the paint operation.
protected CanvasPanel	m_PanelCanvas	the canvas panel to operate on.
protected BasePanel	m_PanelFullOptions	the full option panel.
protected BasePanel	m_PanelOptions	the options panel.

Fields inherited from class adams.core.logging.LoggingObject

m_Logger, m_LoggingIsEnabled, m_LoggingLevel

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractTool()	Initializes the tool.

Method Summary

Modifier and Type	Method	Description
void	activate()	Gets called to activate the tool.
void	annotationsChanged()	Hook method for when new annotations have been set.
boolean	apply(BaseFlatButton button)	Applies the settings (if valid).
protected String	checkBeforeApply()	Checks the parameters before applying them.
void	cleanUp()	Cleans up data structures, frees up memory.
protected BaseFlatButton	createApplyButton()	Generates the apply button.
protected abstract Cursor	createCursor()	Creates the mouse cursor to use.
protected ToolKeyAdapter	createKeyListener()	Creates the key listener to use.
protected abstract ToolMouseAdapter	createMouseListener()	Creates the mouse listener to use.
protected abstract ToolMouseMotionAdapter	createMouseMotionListener()	Creates the mouse motion listener to use.
protected abstract BasePanel	createOptionPanel()	Creates the panel for setting the options.
protected PaintOperation	createPaintOperation()	Creates the paint operation to use.
void	deactivate()	Gets called to deactivate the tool.
protected abstract void	doApply()	Applies the settings.
Color	getActiveColor()	Returns the active color.
CombinedLayer.CombinedSubLayer	getActiveCombinedSubLayer()	Returns the active combined sub layer.
BufferedImage	getActiveImage()	Returns the active image.
OverlayLayer	getActiveOverlay()	Returns the active overlay layer.
CanvasPanel	getCanvas()	Returns the currently set canvas panel.
Cursor	getCursor()	Returns the mouse cursor to use.
ToolKeyAdapter	getKeyListener()	Returns the mouse listener to use.
LayerManager	getLayerManager()	Returns the layer manager.
protected String	getModifiedIcon()	Returns the icon name for the modified state.
ToolMouseAdapter	getMouseListener()	Returns the mouse listener to use.
ToolMouseMotionAdapter	getMouseMotionListener()	Returns the mouse motion listener to use.
BasePanel	getOptionPanel()	Returns the panel for setting the options.
PaintOperation	getPaintOperation()	Returns the paint operation for the tool.
protected String	getUnmodifiedIcon()	Returns the icon name for the unmodified state.
double	getZoom()	Returns the current zoom.
boolean	hasActiveCombinedSubLayer()	Returns whether an active combined sub layer is present.
boolean	hasActiveOverlay()	Returns whether an active overlay layer is present.
boolean	hasAnyActive()	Returns whether any active layer is present.
protected void	initialize()	Initializes the members.
boolean	isAutomaticUndoEnabled()	Returns whether automatic undo is enabled.
protected void	setApplyButtonState(BaseFlatButton button, boolean modified)	Sets the state of the "Apply" button according to the modified flag.
void	setCanvas(CanvasPanel value)	Sets the canvas panel to use.

Methods inherited from class adams.core.logging.CustomLoggingLevelObject

setLoggingLevel

Methods inherited from class adams.core.logging.LoggingObject

configureLogger, getLogger, getLoggingLevel, initializeLogging, isLoggingEnabled, sizeOf

Methods inherited from class java.lang.Object

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

Methods inherited from interface adams.core.GlobalInfoSupporter

globalInfo

Methods inherited from interface adams.core.logging.LoggingLevelHandler

getLoggingLevel, setLoggingLevel

Methods inherited from interface adams.core.logging.LoggingSupporter

getLogger, isLoggingEnabled

Methods inherited from interface adams.gui.visualization.segmentation.tool.Tool

getIcon, getName

Field Detail

m_PanelCanvas

protected CanvasPanel m_PanelCanvas

the canvas panel to operate on.

m_Listener

protected ToolMouseAdapter m_Listener

the mouse listener.

m_MotionListener

protected ToolMouseMotionAdapter m_MotionListener

the mouse motion listener.

m_KeyListener

protected ToolKeyAdapter m_KeyListener

the key listener.

m_PaintOperation

protected PaintOperation m_PaintOperation

the paint operation.

m_PanelOptions

protected BasePanel m_PanelOptions

the options panel.

m_PanelFullOptions

protected BasePanel m_PanelFullOptions

the full option panel.

Constructor Detail

AbstractTool

protected AbstractTool()

Initializes the tool.

Method Detail

initialize

protected void initialize()

Initializes the members.

setCanvas

public void setCanvas(CanvasPanel value)

Sets the canvas panel to use.

Specified by:

setCanvas in interface Tool

Parameters:

value - the panel

getCanvas

public CanvasPanel getCanvas()

Returns the currently set canvas panel.

Specified by:

getCanvas in interface Tool

Returns:

the panel, null if none set

getLayerManager

public LayerManager getLayerManager()

Returns the layer manager.

Specified by:

getLayerManager in interface Tool

Returns:

the layer manager, null if not available

hasAnyActive

public boolean hasAnyActive()

Returns whether any active layer is present.

Specified by:

hasAnyActive in interface Tool

Returns:

true if an active layer present

See Also:

hasActiveOverlay(), hasActiveCombinedSubLayer()

hasActiveOverlay

public boolean hasActiveOverlay()

Returns whether an active overlay layer is present.

Specified by:

hasActiveOverlay in interface Tool

Returns:

true if available

getActiveOverlay

public OverlayLayer getActiveOverlay()

Returns the active overlay layer.

Specified by:

getActiveOverlay in interface Tool

Returns:

the layer, null if none available

hasActiveCombinedSubLayer

public boolean hasActiveCombinedSubLayer()

Returns whether an active combined sub layer is present.

Specified by:

hasActiveCombinedSubLayer in interface Tool

Returns:

true if available

getActiveCombinedSubLayer

public CombinedLayer.CombinedSubLayer getActiveCombinedSubLayer()

Returns the active combined sub layer.

Specified by:

getActiveCombinedSubLayer in interface Tool

Returns:

the layer, null if none available

getActiveImage

public BufferedImage getActiveImage()

Returns the active image.

Specified by:

getActiveImage in interface Tool

Returns:

the image or null if none active

getActiveColor

public Color getActiveColor()

Returns the active color.

Specified by:

getActiveColor in interface Tool

Returns:

the color or null if none active

getZoom

public double getZoom()

Returns the current zoom.

Specified by:

getZoom in interface Tool

Returns:

the zoom (1.0 = 100%)

isAutomaticUndoEnabled

public boolean isAutomaticUndoEnabled()

Returns whether automatic undo is enabled.

Specified by:

isAutomaticUndoEnabled in interface Tool

Returns:

true if enabled

createCursor

protected abstract Cursor createCursor()

Creates the mouse cursor to use.

Returns:

the cursor

getCursor

public Cursor getCursor()

Returns the mouse cursor to use.

Specified by:

getCursor in interface Tool

Returns:

the cursor

createMouseListener

protected abstract ToolMouseAdapter createMouseListener()

Creates the mouse listener to use.

Returns:

the listener, null if not applicable

getMouseListener

public ToolMouseAdapter getMouseListener()

Returns the mouse listener to use.

Specified by:

getMouseListener in interface Tool

Returns:

the listener

createMouseMotionListener

protected abstract ToolMouseMotionAdapter createMouseMotionListener()

Creates the mouse motion listener to use.

Returns:

the listener, null if not applicable

getMouseMotionListener

public ToolMouseMotionAdapter getMouseMotionListener()

Returns the mouse motion listener to use.

Specified by:

getMouseMotionListener in interface Tool

Returns:

the listener

createKeyListener

protected ToolKeyAdapter createKeyListener()

Creates the key listener to use.
Default implementation just returns null.

Returns:

the listener, null if not applicable

getKeyListener

public ToolKeyAdapter getKeyListener()

Returns the mouse listener to use.

Specified by:

getKeyListener in interface Tool

Returns:

the listener

createPaintOperation

protected PaintOperation createPaintOperation()

Creates the paint operation to use.
Default implementation just returns the NullOperation.

Returns:

the operation

getPaintOperation

public PaintOperation getPaintOperation()

Returns the paint operation for the tool.

Specified by:

getPaintOperation in interface Tool

Returns:

the paint operation

checkBeforeApply

protected String checkBeforeApply()

Checks the parameters before applying them.
Default implementation just returns null.

Returns:

null if checks passed, otherwise error message (gets displayed in GUI)

doApply

protected abstract void doApply()

Applies the settings.

apply

public boolean apply(BaseFlatButton button)

Applies the settings (if valid).

Returns:

true if applied

See Also:

doApply(), checkBeforeApply()

getUnmodifiedIcon

protected String getUnmodifiedIcon()

Returns the icon name for the unmodified state.

Returns:

the image name

getModifiedIcon

protected String getModifiedIcon()

Returns the icon name for the modified state.

Returns:

the image name

createApplyButton

protected BaseFlatButton createApplyButton()

Generates the apply button.

Returns:

the button

setApplyButtonState

protected void setApplyButtonState(BaseFlatButton button,
                                   boolean modified)

Sets the state of the "Apply" button according to the modified flag.

Parameters:

button - the button to update

modified - whether applying needs doing or not

createOptionPanel

protected abstract BasePanel createOptionPanel()

Creates the panel for setting the options.

Returns:

the options panel

getOptionPanel

public BasePanel getOptionPanel()

Returns the panel for setting the options.

Specified by:

getOptionPanel in interface Tool

Returns:

the options panel

activate

public void activate()

Gets called to activate the tool.
Default implementation does nothing.

Specified by:

activate in interface Tool

deactivate

public void deactivate()

Gets called to deactivate the tool.
Default implementation does nothing.

Specified by:

deactivate in interface Tool

annotationsChanged

public void annotationsChanged()

Hook method for when new annotations have been set.

Specified by:

annotationsChanged in interface Tool

cleanUp

public void cleanUp()

Cleans up data structures, frees up memory.

Specified by:

cleanUp in interface CleanUpHandler