USGS

Isis 3.0 Object Programmers' Reference

Home

Isis::Tool Class Reference

Base class for the Qisis tools. More...

#include <Tool.h>

Inheritance diagram for Isis::Tool:
Inheritance graph
Collaboration diagram for Isis::Tool:
Collaboration graph

Public Slots

void activate (bool)
 Activates the tool.
 
virtual void updateTool ()
 Updates the tool.
 
void setCubeViewport (MdiCubeViewport *cvp)
 Sets the current viewport to the given cvp.
 

Signals

void clearWarningSignal ()
 
void toolActivated ()
 
void viewportChanged ()
 

Public Member Functions

 Tool (QWidget *parent)
 Tool constructor.
 
void addTo (ViewportMainWindow *mw)
 Adds the tool to the application.
 
void addTo (ToolPad *toolpad)
 Adds the tool to the toolpad.
 
virtual QString menuName () const
 Anytime a tool is created, you must give it a name for the menu.
 
virtual void addTo (QMenu *menu)
 
virtual void addToPermanent (QToolBar *toolbar)
 
void addToActive (QToolBar *toolbar)
 
virtual void addTo (Workspace *ws)
 Adds the given workspace to the cubeviewport list.
 
QString toolIconDir () const
 returns the path to the icon directory.
 
virtual void paintViewport (MdiCubeViewport *vp, QPainter *painter)
 
RubberBandToolrubberBandTool ()
 
void setList (ToolList *currentList)
 

Protected Types

typedef QVector
< MdiCubeViewport * > 
CubeViewportList
 A list of cubeviewports.
 

Protected Slots

virtual void rubberBandComplete ()
 
virtual void screenPixelsChanged ()
 This is called when actions change which pixels from the cube are displayed.
 
virtual void mouseEnter ()
 
virtual void mouseMove (QPoint p)
 
virtual void mouseMove (QPoint p, Qt::MouseButton)
 
virtual void mouseLeave ()
 
virtual void mouseDoubleClick (QPoint p)
 
virtual void mouseButtonPress (QPoint p, Qt::MouseButton s)
 
virtual void mouseButtonRelease (QPoint p, Qt::MouseButton s)
 Resets the Warning to Nowarning when a different activity occurs on the application.
 
virtual void updateMeasure ()
 
virtual void scaleChanged ()
 
virtual void stretchRequested (MdiCubeViewport *, int)
 
void registerTool (MdiCubeViewport *viewport)
 Registers the tool to the viewport.
 

Protected Member Functions

MdiCubeViewportcubeViewport () const
 Return the current cubeviewport.
 
CubeViewportListcubeViewportList () const
 Return the list of cubeviewports.
 
virtual QActiontoolPadAction (ToolPad *toolpad)
 Anytime a tool is created, you must setup a tool pad action with it.
 
virtual QWidgetcreateToolBarWidget (QStackedWidget *parent)
 Anytime a tool is created, you must add it to the tool bar.
 
virtual void addConnections (MdiCubeViewport *cvp)
 Anytime a tool is created, you must add the connections for it.
 
virtual void removeConnections (MdiCubeViewport *cvp)
 Anytime a tool is created, you must be able to remove it's connections.
 
virtual void enableRubberBandTool ()
 Anytime a tool is created, you may use the rubber band tool.
 
Workspaceworkspace ()
 

Private Member Functions

void addViewportConnections ()
 Makes all the connections for the tool.
 
void removeViewportConnections ()
 Removes all the connections from the tool.
 
void enableToolBar ()
 Enables entire tool bar.
 
void disableToolBar ()
 Disables entire tool bar.
 

Private Attributes

MdiCubeViewportm_cvp
 current cubeviewport
 
Workspacem_workspace
 
bool m_active
 Is the tool acitve?
 
QWidgetm_toolBarWidget
 The tool bar on which this tool resides.
 
QActionm_toolPadAction
 The tool pad on which this tool resides.
 
QString m_toolIconDir
 The pathway to the icon directory.
 
ToolListm_toolList
 

Detailed Description

Base class for the Qisis tools.

Author
????-??-?? Jeff Anderson
History:

2007-04-30 Tracie Sucharski, Added Qpainter to parameters for the paintViewport method. This will allow the tools to use the CubeViewport painter rather than creating a new one which causes warnings in Qt4.

2007-09-11 Steven Lambright - Added code to handle the rubber band tool

2007-11-19 Stacy Alley - Added code for the new ViewportMainWindow class which is used to keep track of the size and location of the qisis windows.

2009-03-27 Noah Hilt, Steven Lambright - Removed old rubber band and changed cubeViewportList to call the Workspace viewport list.

2010-03-18 Sharmila Prasad - Reset warning status when a different tool is chosen, done on mouse double click, press or release

2010-05-24 Eric Hyer - setCubeViewport is now public

2010-06-26 Eric Hyer - Now uses MdiCubeViewport

2010-11-08 Eric Hyer - Added connects and disconnects for cubeViewport's new mouseMove signal

2012-02-27 Tracie Sucharski - Added the signal, toolActivated, to enable a tool to connect and respond when user selects a given tool using the toolPad button.

Definition at line 81 of file Tool.h.

Member Typedef Documentation

A list of cubeviewports.

Definition at line 219 of file Tool.h.

Constructor & Destructor Documentation

Isis::Tool::Tool ( QWidget parent)

Tool constructor.

Parameters
parent

Definition at line 26 of file Tool.cpp.

References m_active, m_cvp, m_toolBarWidget, m_toolIconDir, and m_toolPadAction.

Member Function Documentation

virtual void Isis::Tool::addConnections ( MdiCubeViewport cvp)
inlineprotectedvirtual

Anytime a tool is created, you must add the connections for it.

Parameters
cvp

Reimplemented in Isis::TrackTool, and Isis::WindowTool.

Definition at line 253 of file Tool.h.

Referenced by addViewportConnections().

void Isis::Tool::addTo ( ToolPad toolpad)

Adds the tool to the toolpad.

Parameters
toolpad

Definition at line 97 of file Tool.cpp.

References activate(), Isis::ToolPad::addAction(), m_toolPadAction, and toolPadAction().

void Isis::Tool::addTo ( Workspace ws)
virtual

Adds the given workspace to the cubeviewport list.

Parameters
ws

Reimplemented in Isis::EditTool, Isis::FileTool, Isis::SpecialPixelTool, and Isis::WindowTool.

Definition at line 44 of file Tool.cpp.

References registerTool(), and setCubeViewport().

void Isis::Tool::addToActive ( QToolBar toolbar)
Parameters
toolbar

Definition at line 111 of file Tool.cpp.

References createToolBarWidget(), disableToolBar(), and m_toolBarWidget.

Referenced by addTo(), and Isis::Workspace::Workspace().

virtual void Isis::Tool::addToPermanent ( QToolBar toolbar)
inlinevirtual
Parameters
toolbar

Reimplemented in Isis::AdvancedTrackTool, Isis::FileTool, Isis::HelpTool, Isis::SpecialPixelTool, Isis::BlinkTool, and Isis::WindowTool.

Definition at line 111 of file Tool.h.

Referenced by addTo(), and Isis::Workspace::Workspace().

void Isis::Tool::addViewportConnections ( )
private

Makes all the connections for the tool.

Definition at line 186 of file Tool.cpp.

References addConnections(), enableRubberBandTool(), m_cvp, m_toolPadAction, mouseButtonPress(), mouseButtonRelease(), mouseDoubleClick(), mouseMove(), and screenPixelsChanged().

Referenced by activate(), and setCubeViewport().

virtual QWidget* Isis::Tool::createToolBarWidget ( QStackedWidget *  parent)
inlineprotectedvirtual
MdiCubeViewport* Isis::Tool::cubeViewport ( ) const
inlineprotected

Return the current cubeviewport.

Returns
CubeViewport*

Definition at line 211 of file Tool.h.

References m_cvp.

Referenced by Isis::WindowTool::addConnections(), Isis::TrackTool::addConnections(), Isis::StretchTool::advancedStretchChanged(), Isis::FindTool::centerLinkedViewports(), Isis::StretchTool::changeStretch(), Isis::BandTool::changeView(), Isis::BandTool::copyLinkedViewports(), Isis::FileTool::discard(), enableToolBar(), Isis::FileTool::exportView(), Isis::StatisticsTool::getStatistics(), Isis::FindTool::handleRecordClicked(), Isis::EditTool::LineToPoints(), Isis::TrackTool::locateCursor(), Isis::SunShadowTool::mouseButtonPress(), Isis::RubberBandTool::mouseButtonRelease(), Isis::EditTool::mouseButtonRelease(), Isis::FeatureNomenclatureTool::mouseButtonRelease(), Isis::FindTool::mouseButtonRelease(), Isis::StretchTool::mouseButtonRelease(), Isis::MatchTool::mouseButtonRelease(), Isis::QnetTool::mouseButtonRelease(), Isis::AdvancedTrackTool::mouseLeave(), Isis::ScatterPlotTool::mouseMove(), Isis::SunShadowTool::mouseMove(), Isis::TrackTool::mouseMove(), Isis::RubberBandTool::mouseMove(), Isis::SunShadowTool::paintViewport(), Isis::RubberBandTool::paintViewport(), Isis::FindTool::paintViewport(), Isis::FileTool::print(), Isis::SunShadowTool::recalculateShadowHeight(), Isis::EditTool::redoEdit(), Isis::FindTool::refresh(), Isis::HistogramTool::refreshPlot(), Isis::SpatialPlotTool::refreshPlot(), Isis::SpectralPlotTool::refreshPlot(), Isis::WindowTool::removeConnections(), Isis::TrackTool::removeConnections(), Isis::RubberBandTool::repaint(), Isis::WindowTool::resizeWindows(), Isis::HistogramTool::rubberBandComplete(), Isis::MeasureTool::rubberBandComplete(), Isis::ZoomTool::rubberBandComplete(), Isis::EditTool::rubberBandComplete(), Isis::StretchTool::rubberBandComplete(), Isis::FileTool::save(), Isis::FileTool::saveAs(), Isis::FileTool::saveAsCubeByOption(), Isis::FileTool::saveAsReducedCube(), Isis::FileTool::saveInfo(), Isis::BandTool::setBandBin(), Isis::BandTool::setList(), Isis::StretchTool::setStretchAcrossBands(), Isis::StretchTool::setStretchAllViewports(), Isis::StretchTool::showAdvancedDialog(), Isis::ScatterPlotTool::showNewScatterPlotConfig(), Isis::StretchTool::stretchChanged(), Isis::StretchTool::stretchGlobal(), Isis::StretchTool::stretchGlobalAllBands(), Isis::StretchTool::stretchRegional(), Isis::EditTool::undoEdit(), Isis::StretchTool::updateAdvStretchDialogforAll(), Isis::StretchTool::updateHistograms(), Isis::TrackTool::updateLabels(), Isis::MeasureTool::updateMeasure(), Isis::AdvancedTrackTool::updateRow(), Isis::WindowTool::updateTool(), Isis::BlinkTool::updateTool(), Isis::SpecialPixelTool::updateTool(), Isis::SunShadowTool::updateTool(), Isis::BandTool::updateTool(), Isis::AbstractPlotTool::updateTool(), Isis::ZoomTool::updateTool(), Isis::FileTool::updateTool(), Isis::EditTool::updateTool(), Isis::FindTool::updateTool(), Isis::StretchTool::updateTool(), Isis::AbstractPlotTool::viewportsToPlot(), Isis::EditTool::writeToCube(), Isis::ZoomTool::zoomBy(), Isis::ZoomTool::zoomFit(), Isis::ZoomTool::zoomFitHeight(), Isis::ZoomTool::zoomFitWidth(), and Isis::ZoomTool::zoomManual().

Tool::CubeViewportList * Isis::Tool::cubeViewportList ( ) const
protected

Return the list of cubeviewports.

Returns
CubeViewportList*

Definition at line 389 of file Tool.cpp.

References Isis::Workspace::cubeViewportList().

Referenced by Isis::BlinkTool::advance(), Isis::SpecialPixelTool::apply(), Isis::FindTool::centerLinkedViewports(), Isis::WindowTool::changeCursor(), Isis::FileTool::closeAll(), Isis::BandTool::copyAllViewports(), Isis::BandTool::copyLinkedViewports(), Isis::MatchTool::createPoint(), Isis::BlinkTool::eventFilter(), Isis::FeatureNomenclatureTool::featuresIdentified(), Isis::FeatureNomenclatureTool::findMissingNomenclature(), Isis::FeatureNomenclatureTool::findNomenclatureStateChanged(), Isis::FindTool::handleLinkClicked(), Isis::WindowTool::linkWindows(), Isis::RubberBandTool::mouseButtonRelease(), Isis::RubberBandTool::mouseMove(), Isis::QnetTool::openGround(), Isis::StereoTool::paintAllViewports(), Isis::MatchTool::paintAllViewports(), Isis::QnetTool::paintAllViewports(), Isis::FindTool::refresh(), Isis::ScatterPlotTool::repaintViewports(), Isis::AbstractPlotTool::repaintViewports(), Isis::WindowTool::resizeWindows(), Isis::BlinkTool::reverse(), Isis::ZoomTool::rubberBandComplete(), Isis::MatchTool::serialNumberList(), Isis::FeatureNomenclatureTool::setFontColor(), Isis::FeatureNomenclatureTool::setFontSize(), Isis::FeatureNomenclatureTool::setShowApprovedOnly(), Isis::StretchTool::setStretchAllViewports(), Isis::FeatureNomenclatureTool::setVectorType(), Isis::StretchTool::stretchGlobalAllViewports(), Isis::BlinkTool::toggleLink(), Isis::WindowTool::unlinkWindows(), Isis::MeasureTool::updateMeasure(), Isis::AdvancedTrackTool::updateRow(), Isis::WindowTool::updateTool(), Isis::BlinkTool::updateTool(), Isis::FindTool::updateTool(), Isis::AbstractPlotTool::viewportsToPlot(), Isis::ZoomTool::zoomBy(), Isis::ZoomTool::zoomFit(), Isis::ZoomTool::zoomFitHeight(), Isis::ZoomTool::zoomFitWidth(), and Isis::ZoomTool::zoomManual().

void Isis::Tool::disableToolBar ( )
private

Disables entire tool bar.

Definition at line 284 of file Tool.cpp.

References m_toolBarWidget.

Referenced by activate(), and addToActive().

void Isis::Tool::enableRubberBandTool ( )
protectedvirtual

Anytime a tool is created, you may use the rubber band tool.

Enable the use of the rubberband tool.

Reimplemented in Isis::RubberBandTool, Isis::ZoomTool, Isis::MeasureTool, Isis::StereoTool, Isis::SpatialPlotTool, Isis::SpectralPlotTool, and Isis::HistogramTool.

Definition at line 338 of file Tool.cpp.

References Isis::RubberBandTool::disable().

Referenced by addViewportConnections().

void Isis::Tool::enableToolBar ( )
private

Enables entire tool bar.

Definition at line 296 of file Tool.cpp.

References cubeViewport(), m_toolBarWidget, and updateTool().

Referenced by activate(), and setCubeViewport().

virtual QString Isis::Tool::menuName ( ) const
inlinevirtual

Anytime a tool is created, you must give it a name for the menu.

Returns
QString

Reimplemented in Isis::FindTool, Isis::StretchTool, Isis::FeatureNomenclatureTool, Isis::AdvancedTrackTool, Isis::ZoomTool, Isis::FileTool, Isis::MeasureTool, Isis::BandTool, Isis::HelpTool, Isis::SpecialPixelTool, Isis::BlinkTool, Isis::WindowTool, and Isis::PanTool.

Definition at line 97 of file Tool.h.

Referenced by addTo(), and Isis::Workspace::Workspace().

void Isis::Tool::mouseButtonPress ( QPoint  p,
Qt::MouseButton  s 
)
protectedvirtualslot
Parameters
p
s

Definition at line 366 of file Tool.cpp.

Referenced by addViewportConnections(), and removeViewportConnections().

void Isis::Tool::mouseButtonRelease ( QPoint  p,
Qt::MouseButton  s 
)
protectedvirtualslot

Resets the Warning to Nowarning when a different activity occurs on the application.

This is called by all the mouseButtonRelease events in all the tools.

Parameters
p
s

Reimplemented in Isis::FeatureNomenclatureTool.

Definition at line 379 of file Tool.cpp.

Referenced by addViewportConnections(), Isis::StretchTool::mouseButtonRelease(), and removeViewportConnections().

void Isis::Tool::mouseDoubleClick ( QPoint  p)
protectedvirtualslot
Parameters
p

Definition at line 357 of file Tool.cpp.

Referenced by addViewportConnections(), and removeViewportConnections().

void Isis::Tool::mouseMove ( QPoint  p)
protectedvirtualslot
Parameters
p

Definition at line 351 of file Tool.cpp.

Referenced by addViewportConnections(), and removeViewportConnections().

virtual void Isis::Tool::paintViewport ( MdiCubeViewport vp,
QPainter *  painter 
)
inlinevirtual
void Isis::Tool::registerTool ( MdiCubeViewport viewport)
protectedslot

Registers the tool to the viewport.

Parameters
viewport

Definition at line 326 of file Tool.cpp.

References m_cvp, and Isis::MdiCubeViewport::registerTool().

Referenced by addTo().

virtual void Isis::Tool::removeConnections ( MdiCubeViewport cvp)
inlineprotectedvirtual

Anytime a tool is created, you must be able to remove it's connections.

Parameters
cvp

Reimplemented in Isis::MeasureTool, Isis::TrackTool, and Isis::WindowTool.

Definition at line 261 of file Tool.h.

Referenced by removeViewportConnections().

void Isis::Tool::removeViewportConnections ( )
private

Removes all the connections from the tool.

Definition at line 237 of file Tool.cpp.

References m_cvp, mouseButtonPress(), mouseButtonRelease(), mouseDoubleClick(), mouseMove(), removeConnections(), and screenPixelsChanged().

Referenced by activate(), and setCubeViewport().

virtual void Isis::Tool::screenPixelsChanged ( )
inlineprotectedvirtualslot

This is called when actions change which pixels from the cube are displayed.

Definition at line 162 of file Tool.h.

Referenced by addViewportConnections(), removeViewportConnections(), and Isis::FeatureNomenclatureTool::viewportDone().

void Isis::Tool::setCubeViewport ( MdiCubeViewport cvp)
slot

Sets the current viewport to the given cvp.

Parameters
cvp

Definition at line 159 of file Tool.cpp.

References addViewportConnections(), enableToolBar(), m_active, m_cvp, removeViewportConnections(), and updateTool().

Referenced by addTo(), and Isis::FileTool::closeAll().

virtual QAction* Isis::Tool::toolPadAction ( ToolPad toolpad)
inlineprotectedvirtual

Member Data Documentation

bool Isis::Tool::m_active
private

Is the tool acitve?

Definition at line 278 of file Tool.h.

Referenced by activate(), setCubeViewport(), and Tool().

MdiCubeViewport* Isis::Tool::m_cvp
private

current cubeviewport

Definition at line 275 of file Tool.h.

Referenced by addViewportConnections(), cubeViewport(), registerTool(), removeViewportConnections(), setCubeViewport(), and Tool().

QWidget* Isis::Tool::m_toolBarWidget
private

The tool bar on which this tool resides.

Definition at line 279 of file Tool.h.

Referenced by addToActive(), disableToolBar(), enableToolBar(), and Tool().

QString Isis::Tool::m_toolIconDir
private

The pathway to the icon directory.

Definition at line 281 of file Tool.h.

Referenced by Tool(), and toolIconDir().

QAction* Isis::Tool::m_toolPadAction
private

The tool pad on which this tool resides.

Definition at line 280 of file Tool.h.

Referenced by activate(), addTo(), addViewportConnections(), and Tool().


The documentation for this class was generated from the following files: