Isis::RubberBandTool Class Reference

Rubber banding tool. More...

#include <RubberBandTool.h>

Inheritance diagram for Isis::RubberBandTool:

Collaboration diagram for Isis::RubberBandTool:

Public Types
enum	RubberBandMode {   AngleMode, CircleMode, EllipseMode, LineMode,   RectangleMode, RotatedRectangleMode, PolygonMode, SegmentedLineMode }

Public Slots
void	escapeKeyPress ()
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	modeChanged ()
void	bandingComplete ()
void	measureChange ()
void	clearWarningSignal ()
void	toolActivated ()
void	viewportChanged ()

Public Member Functions
	RubberBandTool (QWidget *parent=NULL)
	This is the constructor.
void	enable (RubberBandMode mode, bool showIndicatorColors=false)
	This is called when changing modes or turning on.
void	disable ()
	This is called when something is not using me, so turn off events, reset & repaint to clear the clear.
void	setDrawActiveViewportOnly (bool activeOnly=false)
	This called to set whether rubber band is drawn on active viewport only rather than all linked viewports.
QList< QPoint >	vertices ()
	This method returns the vertices.
RubberBandMode	currentMode ()
double	area ()
Angle	angle ()
geos::geom::Geometry *	geometry ()
QRect	rectangle ()
	This method returns a rectangle from the vertices set by the RubberBandTool.
Qt::MouseButton	mouseButton ()
	This method returns the mouse button modifier.
void	paintViewport (MdiCubeViewport *vp, QPainter *painter)
	This is the main paint method for the rubber bands.
bool	isValid ()
	This returns true if we can return complete & valid data.
bool	figureComplete ()
bool	figureValid ()
bool	figureIsPoint ()
void	enablePoints (unsigned int pixTolerance=2)
void	enableAllClicks ()
void	clear ()
	clears the rubber band!
void	addTo (ViewportMainWindow *mw)
	Adds the tool to the application.
void	addTo (ToolPad *toolpad)
	Adds the tool to the toolpad.
virtual void	addTo (QMenu *menu)
virtual void	addTo (Workspace *ws)
	Adds the given workspace to the cubeviewport list.
virtual QString	menuName () const
	Anytime a tool is created, you must give it a name for the menu.
virtual void	addToPermanent (QToolBar *toolbar)
void	addToActive (QToolBar *toolbar)
QString	toolIconDir () const
	returns the path to the icon directory.
RubberBandTool *	rubberBandTool ()
void	setList (ToolList *currentList)

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

Protected Slots
void	mouseMove (QPoint p, Qt::MouseButton)
	If tracking is not enabled, this does nothing.
void	mouseDoubleClick (QPoint p)
	This triggers on a second mouse press.
void	mouseButtonPress (QPoint p, Qt::MouseButton s)
	If the click is not the left mouse button, this does nothing.
void	mouseButtonRelease (QPoint p, Qt::MouseButton s)
	If this is not the left mouse button, this does nothing.
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	mouseLeave ()
virtual void	updateMeasure ()
virtual void	stretchRequested (MdiCubeViewport *, int)
void	registerTool (MdiCubeViewport *viewport)
	Registers the tool to the viewport.

Protected Member Functions
void	enableRubberBandTool ()
	Anytime a tool is created, you may use the rubber band tool.
void	scaleChanged ()
MdiCubeViewport *	cubeViewport () const
	Return the current cubeviewport.
CubeViewportList *	cubeViewportList () const
	Return the list of cubeviewports.
virtual QAction *	toolPadAction (ToolPad *toolpad)
	Anytime a tool is created, you must setup a tool pad action with it.
virtual QWidget *	createToolBarWidget (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.
Workspace *	workspace ()

Private Member Functions
QPoint	snapMouse (QPoint)
	moves the mouse's location p to the nearest axis
void	repaint ()
	This method will call the viewport's repaint if there is a current cube viewport.
void	paintVerticesConnected (QPainter *painter)
	This paints connecting lines to p_vertices.
void	paintRectangle (QPoint upperLeft, QPoint lowerRight, QPainter *painter)
	Given opposite corners, the other two are interpolated and the rectangle is drawn.
void	paintRectangle (QPoint upperLeft, QPoint upperRight, QPoint lowerLeft, QPoint lowerRight, QPainter *painter)
	This draws a box around the 4 points using the painter.
void	calcRectCorners (QPoint corner1, QPoint corner2, QPoint &corner3, QPoint &corner4)
	Given two set corners, and the mouse location, this method will interpolate the last two corners.
void	reset ()
	This initializes the class except for the current mode, which is set on enable.

Private Attributes
bool	p_mouseDown
bool	p_doubleClicking
bool	p_tracking
bool	p_allClicks
bool	p_drawActiveOnly
RubberBandMode	p_bandingMode
QList< QPoint > *	p_vertices
QPoint *	p_mouseLoc
Qt::MouseButton	p_mouseButton
bool	p_indicatorColors
unsigned int	p_pointTolerance

Detailed Description

Rubber banding tool.

Author

2007-09-11 Steven Lambright

History:

2007-09-11 Steven Lambright Original version

2008-01-03 Steven Lambright bug fix on the polygons

2008-05-23 Noah Hilt added getRectangle method

2008-08-18 Steven Koechle updated to work with Geos 3.0.0

2008-09-26 Steven Lambright Added Segmented line

2010-05-24 Eric Hyer - Added clear() method

2010-06-03 Eric Hyer - Fixed bug in getInstance method

2010-06-26 Eric Hyer - Now uses MdiCubeViewport

2010-11-08 Eric Hyer - Added mouse snapping

2011-09-20 Steven Lambright - Segmented lines now have updates while the user is still drawing them instead of just a complete state.

2012-02-08 Tracie Sucharski - Added method to set drawing on the active viewport only.

2012-09-18 Steven Lambright - This is no longer a singleton, which prevented it from working with multiple workspaces. Brought method naming closer to current coding standards.

Definition at line 50 of file RubberBandTool.h.

Member Typedef Documentation

typedef QVector< MdiCubeViewport * > Isis::Tool::CubeViewportList

protectedinherited

A list of cubeviewports.

Definition at line 219 of file Tool.h.

Constructor & Destructor Documentation

Isis::RubberBandTool::RubberBandTool

(

QWidget *

parent = NULL

)

This is the constructor.

It's private because this class is a singleton.

Parameters

parent

Definition at line 35 of file RubberBandTool.cpp.

References Isis::Tool::activate(), and repaint().

Member Function Documentation

void Isis::Tool::activate ( bool  on )

slotinherited

Activates the tool.

Parameters

on

Definition at line 130 of file Tool.cpp.

References Isis::Tool::addViewportConnections(), Isis::Tool::disableToolBar(), Isis::Tool::enableToolBar(), Isis::Tool::m_active, Isis::Tool::m_toolPadAction, and Isis::Tool::removeViewportConnections().

Referenced by Isis::Tool::addTo(), Isis::AdvancedTrackTool::AdvancedTrackTool(), disable(), enable(), Isis::AdvancedTrackTool::eventFilter(), Isis::FileTool::FileTool(), RubberBandTool(), Isis::TrackTool::TrackTool(), Isis::WindowTool::WindowTool(), and Isis::Workspace::Workspace().

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

inlineprotectedvirtualinherited

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 Isis::Tool::addViewportConnections().

void Isis::Tool::addTo ( ViewportMainWindow *  pViewPortMnWin )

inherited

Adds the tool to the application.

Parameters

pViewPortMnWin

Definition at line 77 of file Tool.cpp.

References Isis::ViewportMainWindow::activeToolBar(), Isis::Tool::addToActive(), Isis::Tool::addToPermanent(), Isis::ViewportMainWindow::getMenu(), Isis::Tool::menuName(), Isis::ViewportMainWindow::permanentToolBar(), Isis::ViewportMainWindow::toolPad(), and Isis::ViewportMainWindow::workspace().

Referenced by Isis::WindowTool::addTo(), Isis::SpecialPixelTool::addTo(), Isis::FileTool::addTo(), Isis::EditTool::addTo(), Isis::ViewportMainWindow::ViewportMainWindow(), and Isis::Workspace::Workspace().

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

inherited

Adds the tool to the toolpad.

Parameters

toolpad

Definition at line 97 of file Tool.cpp.

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

virtual void Isis::Tool::addTo ( QMenu *  menu )

inlinevirtualinherited

Parameters

menu

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

Definition at line 105 of file Tool.h.

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

virtualinherited

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 Isis::Tool::registerTool(), and Isis::Tool::setCubeViewport().

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

inherited

Parameters

toolbar

Definition at line 111 of file Tool.cpp.

References Isis::Tool::createToolBarWidget(), Isis::Tool::disableToolBar(), and Isis::Tool::m_toolBarWidget.

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

virtual void Isis::Tool::addToPermanent ( QToolBar *  toolbar )

inlinevirtualinherited

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 Isis::Tool::addTo(), and Isis::Workspace::Workspace().

void Isis::RubberBandTool::calcRectCorners ( QPoint  corner1, QPoint  corner2, QPoint &  corner3, QPoint &  corner4  )

private

Given two set corners, and the mouse location, this method will interpolate the last two corners.

Parameters

corner1	Known point
corner2	Known point
corner3	Guessed corner (point to interpolate to).
corner4	Unknown corner.

Definition at line 190 of file RubberBandTool.cpp.

Referenced by paintViewport(), and vertices().

void Isis::RubberBandTool::clear

(

)

clears the rubber band!

Definition at line 1155 of file RubberBandTool.cpp.

References repaint(), and reset().

virtual QWidget* Isis::Tool::createToolBarWidget ( QStackedWidget *  parent )

inlineprotectedvirtualinherited

Anytime a tool is created, you must add it to the tool bar.

Parameters

parent

Returns

QWidget*

Reimplemented in Isis::StretchTool, Isis::FindTool, Isis::StatisticsTool, Isis::FeatureNomenclatureTool, Isis::EditTool, Isis::ZoomTool, Isis::MeasureTool, Isis::StereoTool, Isis::SpatialPlotTool, Isis::SpectralPlotTool, Isis::AbstractPlotTool, Isis::BandTool, Isis::SunShadowTool, Isis::ScatterPlotTool, Isis::HistogramTool, and Isis::PanTool.

Definition at line 243 of file Tool.h.

Referenced by Isis::Tool::addToActive().

MdiCubeViewport* Isis::Tool::cubeViewport ( ) const

inlineprotectedinherited

Return the current cubeviewport.

Returns

CubeViewport*

Definition at line 211 of file Tool.h.

References Isis::Tool::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(), Isis::Tool::enableToolBar(), Isis::FileTool::exportView(), Isis::StatisticsTool::getStatistics(), Isis::FindTool::handleRecordClicked(), Isis::EditTool::LineToPoints(), Isis::TrackTool::locateCursor(), Isis::SunShadowTool::mouseButtonPress(), 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(), mouseMove(), Isis::SunShadowTool::paintViewport(), 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(), 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::BandTool::updateTool(), Isis::SunShadowTool::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

protectedinherited

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(), mouseButtonRelease(), 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::RubberBandTool::disable

(

)

This is called when something is not using me, so turn off events, reset & repaint to clear the clear.

Definition at line 322 of file RubberBandTool.cpp.

References Isis::Tool::activate(), repaint(), and reset().

Referenced by Isis::EditTool::enableRubberBandTool(), Isis::Tool::enableRubberBandTool(), and Isis::RubberBandComboBox::selectionChanged().

void Isis::RubberBandTool::enable	(	RubberBandMode	mode,
		bool	showIndicatorColors = false
	)

This is called when changing modes or turning on.

So, set the mode, reset, and activate our event handlers.

Parameters

mode
showIndicatorColors	Color the first side of figures differently

Definition at line 302 of file RubberBandTool.cpp.

References Isis::Tool::activate(), and reset().

Referenced by Isis::StereoTool::enableRubberBandTool(), Isis::ZoomTool::enableRubberBandTool(), Isis::EditTool::enableRubberBandTool(), Isis::StretchTool::enableRubberBandTool(), Isis::RubberBandComboBox::showAngle(), Isis::RubberBandComboBox::showCircle(), Isis::RubberBandComboBox::showEllipse(), Isis::RubberBandComboBox::showLine(), Isis::RubberBandComboBox::showPolygon(), Isis::RubberBandComboBox::showRectangle(), Isis::RubberBandComboBox::showRotatedRectangle(), and Isis::RubberBandComboBox::showSegmentedLine().

void Isis::RubberBandTool::enableRubberBandTool ( )

inlineprotectedvirtual

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

Enable the use of the rubberband tool.

Reimplemented from Isis::Tool.

Definition at line 107 of file RubberBandTool.h.

geos::geom::Geometry * Isis::RubberBandTool::geometry

(

)

Returns

geos::Geometry*

Definition at line 823 of file RubberBandTool.cpp.

References vertices().

Referenced by Isis::HistogramTool::refreshPlot(), and Isis::MeasureTool::updateDist().

bool Isis::RubberBandTool::isValid

(

)

This returns true if we can return complete & valid data.

Definition at line 1016 of file RubberBandTool.cpp.

Referenced by Isis::EditTool::rubberBandComplete().

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

inlinevirtualinherited

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 Isis::Tool::addTo(), and Isis::Workspace::Workspace().

Qt::MouseButton Isis::RubberBandTool::mouseButton

(

)

This method returns the mouse button modifier.

Returns

MouseButton Mouse button modifier on last release

Definition at line 1012 of file RubberBandTool.cpp.

Referenced by mouseMove().

void Isis::RubberBandTool::mouseButtonPress ( QPoint  p, Qt::MouseButton  s  )

protectedslot

If the click is not the left mouse button, this does nothing.

This will set mouseDown as true. When the calculations are complete, p_mouseDown is set to true.

For drag-only, A press means starting a new rubber band so reset & record the point. This applies to CircleModes, Eliipsoids, LineModes and RectangleModes.

For Rotated RectangleModes, A mount press means we're starting over, setting the first point, or completing. For the first two, simply reset and record the point. For the latter, figure out the corners and store those points.

For polygons, A press means record the current point. Reset first if we're not currently drawing.

Parameters

p
s

Definition at line 386 of file RubberBandTool.cpp.

References reset().

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

protectedslot

If this is not the left mouse button, this does nothing.

This will set mouseDown as false. When the calculations are complete, p_doubleClicking is set to false. The double click event occurs with `the press event so it's safe to set that flag here.

The implementation differs, based on the mode, as follows:

For angles, This signifies a click. We're always setting one of the three vertexes, but if there is an already complete vertex go ahead and reset first to start a new angle.

For circles, Since this is a drag-only rubber band, a release signifies a complete. Figure out the corner, based on the mouse location, and push it onto the back of the vertex list and emit a complete.

For EllipseModes, Since this is a drag-only rubber band, a release signifies a complete. We know the corner, it's the mouse loc, push it onto the back of the vertex list and emit a complete.

For lines, Since this is a drag-only rubber band, a release signifies a complete. We know the end point, push it onto the back of the vertex list and emit a complete.

For rectangles, Since this is a drag-only rubber band, a release signifies a complete. We know the opposite corner, figure out the others and push them onto the back of the vertex list and emit a complete.

For rotated rectangles, If we're finishing dragging the first side, store the end point.

For polygons, Do nothing, this is taken care of on press.

Parameters

p	Current mouse Location
s	Which mouse button was released

Definition at line 475 of file RubberBandTool.cpp.

References Isis::Tool::cubeViewport(), Isis::Tool::cubeViewportList(), Isis::MdiCubeViewport::isLinked(), reset(), snapMouse(), and vertices().

void Isis::RubberBandTool::mouseDoubleClick ( QPoint  p )

protectedslot

This triggers on a second mouse press.

Only polygons care about this, and it signifies an end of shape. So, if we're in polygon mode, stop tracking the mouse and emit a complete.

Parameters

p

Definition at line 343 of file RubberBandTool.cpp.

References repaint().

void Isis::RubberBandTool::mouseMove ( QPoint  p, Qt::MouseButton  mouseButton  )

protectedslot

If tracking is not enabled, this does nothing.

This will first update the mouse location for painting purposes.

Most of the implementation is a matter of emitting measureChanges: For angles, if the first two vertices are specified a measureChange will be emitted. For circles, if the center of the circle is known a measureChange will be emitted. For EllipseModes, if the center of the EllipseMode is known a measureChange will be emitted. For lines, if the first point of the line is known a measureChange will be emitted. For rectangles, if the starting point is known a measureChange will be emitted. For rotated rectangles, if the first side is specified a measureChange will be emitted.

However, there is one exception: For polygons, if the mouse button is pressed the mouse location is recorded as a valid vertex.

Parameters

p	Current mouse Location

Definition at line 589 of file RubberBandTool.cpp.

References Isis::Tool::cubeViewport(), Isis::Tool::cubeViewportList(), Isis::MdiCubeViewport::isLinked(), mouseButton(), and snapMouse().

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

protectedvirtualslotinherited

Parameters

p

Definition at line 351 of file Tool.cpp.

Referenced by Isis::Tool::addViewportConnections(), and Isis::Tool::removeViewportConnections().

void Isis::RubberBandTool::paintRectangle ( QPoint  upperLeft, QPoint  lowerRight, QPainter *  painter  )

private

Given opposite corners, the other two are interpolated and the rectangle is drawn.

Parameters

upperLeft	Corner opposite of lowerRight
lowerRight	Corner opposite of upperLeft
painter

Definition at line 271 of file RubberBandTool.cpp.

Referenced by paintViewport().

void Isis::RubberBandTool::paintRectangle ( QPoint  upperLeft, QPoint  upperRight, QPoint  lowerLeft, QPoint  lowerRight, QPainter *  painter  )

private

This draws a box around the 4 points using the painter.

Parameters

upperLeft	Initial corner
upperRight	Corner connected to upperLeft, lowerRight
lowerLeft	Corner connected to lowerRight, upperLeft
lowerRight	Corner connected to lowerLeft, upperRight
painter

Definition at line 287 of file RubberBandTool.cpp.

void Isis::RubberBandTool::paintVerticesConnected ( QPainter *  painter )

private

This paints connecting lines to p_vertices.

If tracking, a line is also drawn to the mouse location.

Parameters

painter

Definition at line 248 of file RubberBandTool.cpp.

Referenced by paintViewport().

void Isis::RubberBandTool::paintViewport ( MdiCubeViewport *  vp, QPainter *  painter  )

virtual

This is the main paint method for the rubber bands.

For angles and lines, simply connect the known vertices.vertices[0].x() For polygons, paint the vertices & close if completed the shape. For circles, figure out the circle's square and draw the circle inside of it. For EllipseModes, figure out the EllipseMode's rectangle and draw the circle inside of it. For rectangles, paint the rectangle either to the mouse or back to the start depending on if the shape is complete. For rotated rectangles, if we can interpolate extra sides draw them and draw all known sides.

Parameters

vp
painter

Reimplemented from Isis::Tool.

Definition at line 73 of file RubberBandTool.cpp.

References calcRectCorners(), Isis::Tool::cubeViewport(), Isis::MdiCubeViewport::isLinked(), paintRectangle(), paintVerticesConnected(), and vertices().

QRect Isis::RubberBandTool::rectangle

(

)

This method returns a rectangle from the vertices set by the RubberBandTool.

It calculates the upper left and bottom right points for the rectangle and properly initializes a QRect object with these vertices. If the RubberBandTool is in the incorrect mode, or the rectangle is not valid it will return an error message.

Returns

QRect The QRect the user selected on the viewport in pixels

Definition at line 966 of file RubberBandTool.cpp.

References vertices().

Referenced by Isis::ZoomTool::rubberBandComplete(), Isis::EditTool::rubberBandComplete(), and Isis::StretchTool::rubberBandComplete().

void Isis::Tool::registerTool ( MdiCubeViewport *  viewport )

protectedslotinherited

Registers the tool to the viewport.

Parameters

viewport

Definition at line 326 of file Tool.cpp.

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

Referenced by Isis::Tool::addTo().

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

inlineprotectedvirtualinherited

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 Isis::Tool::removeViewportConnections().

void Isis::RubberBandTool::repaint ( )

private

This method will call the viewport's repaint if there is a current cube viewport.

Definition at line 812 of file RubberBandTool.cpp.

References Isis::Tool::cubeViewport().

Referenced by clear(), disable(), mouseDoubleClick(), reset(), RubberBandTool(), and setDrawActiveViewportOnly().

void Isis::RubberBandTool::reset ( )

private

This initializes the class except for the current mode, which is set on enable.

Definition at line 752 of file RubberBandTool.cpp.

References repaint().

Referenced by clear(), disable(), enable(), mouseButtonPress(), and mouseButtonRelease().

virtual void Isis::Tool::screenPixelsChanged ( )

inlineprotectedvirtualslotinherited

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

Definition at line 162 of file Tool.h.

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

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

slotinherited

Sets the current viewport to the given cvp.

Parameters

cvp

Definition at line 159 of file Tool.cpp.

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

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

void Isis::RubberBandTool::setDrawActiveViewportOnly

(

bool

activeOnly = false

)

This called to set whether rubber band is drawn on active viewport only rather than all linked viewports.

Definition at line 333 of file RubberBandTool.cpp.

References repaint().

Referenced by Isis::HistogramTool::enableRubberBandTool(), Isis::SpectralPlotTool::enableRubberBandTool(), Isis::SpatialPlotTool::enableRubberBandTool(), Isis::StereoTool::enableRubberBandTool(), Isis::MeasureTool::enableRubberBandTool(), Isis::ZoomTool::enableRubberBandTool(), Isis::EditTool::enableRubberBandTool(), and Isis::StretchTool::enableRubberBandTool().

QPoint Isis::RubberBandTool::snapMouse ( QPoint  p )

private

moves the mouse's location p to the nearest axis

Parameters

p	The mouse's current location

Returns

The snapped point

Definition at line 554 of file RubberBandTool.cpp.

Referenced by mouseButtonRelease(), and mouseMove().

QString Isis::Tool::toolIconDir ( ) const

inlineinherited

returns the path to the icon directory.

Returns

QString

Definition at line 127 of file Tool.h.

References Isis::Tool::m_toolIconDir.

Referenced by Isis::AdvancedTrackTool::AdvancedTrackTool(), Isis::BlinkTool::BlinkTool(), Isis::StereoTool::createMenus(), Isis::PanTool::createToolBarWidget(), Isis::BandTool::createToolBarWidget(), Isis::StereoTool::createToolBarWidget(), Isis::ZoomTool::createToolBarWidget(), Isis::EditTool::createToolBarWidget(), Isis::FindTool::createToolBarWidget(), Isis::StretchTool::createToolBarWidget(), Isis::FileTool::FileTool(), Isis::FindTool::FindTool(), Isis::HistogramTool::HistogramTool(), Isis::SpecialPixelTool::SpecialPixelTool(), Isis::RubberBandComboBox::toolIconDir(), Isis::PanTool::toolPadAction(), Isis::HistogramTool::toolPadAction(), Isis::ScatterPlotTool::toolPadAction(), Isis::BandTool::toolPadAction(), Isis::SunShadowTool::toolPadAction(), Isis::SpectralPlotTool::toolPadAction(), Isis::SpatialPlotTool::toolPadAction(), Isis::StereoTool::toolPadAction(), Isis::MeasureTool::toolPadAction(), Isis::ZoomTool::toolPadAction(), Isis::EditTool::toolPadAction(), Isis::FeatureNomenclatureTool::toolPadAction(), Isis::StatisticsTool::toolPadAction(), Isis::FindTool::toolPadAction(), Isis::StretchTool::toolPadAction(), Isis::MatchTool::toolPadAction(), Isis::QnetTool::toolPadAction(), Isis::WindowTool::WindowTool(), and Isis::ZoomTool::ZoomTool().

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

inlineprotectedvirtualinherited

Anytime a tool is created, you must setup a tool pad action with it.

Parameters

toolpad

Returns

QAction*

Reimplemented in Isis::QnetTool, Isis::MatchTool, Isis::StretchTool, Isis::FindTool, Isis::StatisticsTool, Isis::FeatureNomenclatureTool, Isis::EditTool, Isis::ZoomTool, Isis::MeasureTool, Isis::SpatialPlotTool, Isis::StereoTool, Isis::SpectralPlotTool, Isis::BandTool, Isis::SunShadowTool, Isis::ScatterPlotTool, Isis::HistogramTool, and Isis::PanTool.

Definition at line 231 of file Tool.h.

Referenced by Isis::Tool::addTo().

void Isis::Tool::updateTool ( )

virtualslotinherited

Updates the tool.

Reimplemented in Isis::StretchTool, Isis::FindTool, Isis::FeatureNomenclatureTool, Isis::EditTool, Isis::FileTool, Isis::ZoomTool, Isis::MeasureTool, Isis::SpatialPlotTool, Isis::SpectralPlotTool, Isis::AbstractPlotTool, Isis::BandTool, Isis::SunShadowTool, Isis::SpecialPixelTool, Isis::BlinkTool, Isis::HistogramTool, and Isis::WindowTool.

Definition at line 317 of file Tool.cpp.

Referenced by Isis::Tool::enableToolBar(), and Isis::Tool::setCubeViewport().

QList< QPoint > Isis::RubberBandTool::vertices

(

)

This method returns the vertices.

The return value is mode-specific, and the return will be consistent whether in a measureChange or bandingComplete slot.

The return values are always in pixels.

The return values are as follows: For angles, the return will always be of size 3. The elements at 0 and 2 are the edges of the angle, while the element at 1 is the vertex of the angle.

For circles, the return will always be of size 2. The element at 0 is the center of the circle, and the element at 1 is offset by the radius in both directions.

For EllipseModes, the return will always be of size 2. The element at 0 is the center of the circle, and the element at 1 is offset by the radius in both directions.

For lines, the return will always be of size 2. The elements are the start and end points.

For rectangles, the return will always be of size 4. The elements will be the corners, in either a clockwise or counter-clockwise direction.

For rotated rectangles, the same applies.

For polygons, the return will be a list of vertices in the order that the user drew them.

**It is NOT valid to call this unless you're in a measureChange or bandingComplete slot.

Returns

QList<QPoint>

Definition at line 672 of file RubberBandTool.cpp.

References calcRectCorners().

Referenced by geometry(), Isis::SpatialPlotTool::getSpatialStatistics(), Isis::SpectralPlotTool::getSpectralStatistics(), mouseButtonRelease(), paintViewport(), rectangle(), Isis::HistogramTool::refreshPlot(), Isis::SpatialPlotTool::refreshPlot(), Isis::SpectralPlotTool::refreshPlot(), Isis::ZoomTool::rubberBandComplete(), and Isis::MeasureTool::updateDist().

---

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

• src/qisis/objs/RubberBandTool/RubberBandTool.h
• src/qisis/objs/RubberBandTool/RubberBandTool.cpp