Isis::EditTool Class Reference

Interactive image edit tool. More...

#include <EditTool.h>

Inheritance diagram for Isis::EditTool:

Collaboration diagram for Isis::EditTool:

Public Types
enum	EditShape {   Point , HorizLine , VertLine , StartEndLine ,   Rectangle }
	Enum for possible shapes. More...
enum	ReplacementValue {   UserDnComboValue , NullComboValue , HrsComboValue , LrsComboValue ,   HisComboValue , LisComboValue }
	Enum for DN values. More...

Public Slots
void	activate (bool)
	Activates the tool.
void	setCubeViewport (MdiCubeViewport *cvp)
	Sets the current viewport to the given cvp.

Signals
void	cubeChanged (bool)
	Emitted when cube changed.
void	save ()
	Emitted when cube should be saved.
void	saveAs ()
	Emitted when cube should be saved as another file.
void	clearWarningSignal ()
void	toolActivated ()
void	viewportChanged ()

Public Member Functions
	EditTool (QWidget *parent)
	Constructs and EditTool object.
void	addTo (Workspace *)
	Adds the given workspace to the cubeviewport list.
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 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.
virtual void	paintViewport (MdiCubeViewport *vp, QPainter *painter)
RubberBandTool *	rubberBandTool ()
void	setList (ToolList *currentList)

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

Protected Slots
void	mouseButtonRelease (QPoint p, Qt::MouseButton m)
	This is a slot called when any mouse button is released inside of a viewport.
virtual void	enableRubberBandTool ()
	This method sets up the RubberBandTool depending on which mode is enabled.
void	rubberBandComplete ()
	This method is called any time the RubberBandTool is complete.
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 ()

Protected Member Functions
QAction *	toolPadAction (ToolPad *pad)
	Adds the EditTool to the tool pad.
QWidget *	createToolBarWidget (QStackedWidget *active)
	Creates the toolbar containing the edit tool widgets.
void	updateTool ()
	This is a virtual function belonging to the Tool class which is called when the user selects a different viewport.
virtual void	mouseDoubleClick (QPoint p)
virtual void	mouseButtonPress (QPoint p, Qt::MouseButton s)
virtual void	updateMeasure ()
virtual void	scaleChanged ()
virtual void	stretchRequested (MdiCubeViewport *, int)
void	registerTool (MdiCubeViewport *viewport)
	Registers the tool to the viewport.
MdiCubeViewport *	cubeViewport () const
	Return the current cubeviewport.
CubeViewportList *	cubeViewportList () const
	Return the list of cubeviewports.
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 ()

Detailed Description

Interactive image edit tool.

This tool is part of the Qisis namespace and allows interactive editing of displayed images.

Author

2006-06-09 Tracie Sucharski

Member Typedef Documentation

CubeViewportList

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

protectedinherited

A list of cubeviewports.

Member Enumeration Documentation

EditShape

enum Isis::EditTool::EditShape

Enum for possible shapes.

Enumerator
Point	point
HorizLine	horizontal line
VertLine	vertical line
StartEndLine	start-end line
Rectangle	rectangle

ReplacementValue

enum Isis::EditTool::ReplacementValue

Enum for DN values.

Enumerator
UserDnComboValue	User Selected DN value.
NullComboValue	Null DN value.
HrsComboValue	High representation saturation DN value.
LrsComboValue	Low representation saturation DN value.
HisComboValue	High instrument saturation DN value.
LisComboValue	Low instrument satruation DN value.

Constructor & Destructor Documentation

EditTool()

Isis::EditTool::EditTool

(

QWidget *

parent

)

Constructs and EditTool object.

Parameters

parent

Parent widget

References Isis::Null.

Member Function Documentation

activate

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

slotinherited

Activates the tool.

Parameters

on

References Isis::Tool::clearWarningSignal(), and Isis::Tool::toolActivated().

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

addConnections()

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.

addTo() [1/4]

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

inlinevirtualinherited

Parameters

menu

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

addTo() [2/4]

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

inherited

Adds the tool to the toolpad.

Parameters

toolpad

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

addTo() [3/4]

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

inherited

Adds the tool to the application.

Parameters

pViewPortMnWin

References Isis::Tool::addTo(), Isis::Tool::addToActive(), Isis::Tool::addToPermanent(), and Isis::Tool::menuName().

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

addTo() [4/4]

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

virtual

Adds the given workspace to the cubeviewport list.

Parameters

ws

Reimplemented from Isis::Tool.

References Isis::Tool::addTo(), and Isis::Tool::workspace().

addToActive()

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

inherited

Parameters

toolbar

References Isis::Tool::createToolBarWidget(), and Isis::ToolList::toolBarStack().

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

addToPermanent()

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

inlinevirtualinherited

Parameters

toolbar

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

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

clearWarningSignal

void Isis::Tool::clearWarningSignal ( )

signalinherited

Referenced by Isis::Tool::activate(), Isis::Tool::mouseButtonPress(), Isis::Tool::mouseButtonRelease(), and Isis::Tool::mouseDoubleClick().

createToolBarWidget()

QWidget * Isis::EditTool::createToolBarWidget ( QStackedWidget * active )

protectedvirtual

Creates the toolbar containing the edit tool widgets.

Parameters

active

input The widget that will contain the edit tool specific widgets

History

2007-08-31 Tracie Sucharski - Changed signal on dn line edit from returnPressed to editingFinished.

Returns

QWidget*

Reimplemented from Isis::Tool.

References enableRubberBandTool(), HisComboValue, HrsComboValue, LisComboValue, LrsComboValue, NullComboValue, save(), saveAs(), Isis::Tool::toolIconDir(), and UserDnComboValue.

cubeChanged

void Isis::EditTool::cubeChanged ( bool )

signal

Emitted when cube changed.

cubeViewport()

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

inlineprotectedinherited

Return the current cubeviewport.

Returns

CubeViewport*

Referenced by Isis::TrackTool::addConnections(), Isis::WindowTool::addConnections(), Isis::StretchTool::deleteFromCube(), Isis::FileTool::discard(), Isis::FileTool::exportToList(), Isis::FileTool::exportView(), Isis::StretchTool::loadStretchFromCube(), Isis::SunShadowTool::mouseButtonPress(), mouseButtonRelease(), Isis::ControlNetTool::mouseButtonRelease(), Isis::FeatureNomenclatureTool::mouseButtonRelease(), Isis::FindTool::mouseButtonRelease(), Isis::MatchTool::mouseButtonRelease(), Isis::PanTool::mouseButtonRelease(), Isis::QnetTool::mouseButtonRelease(), Isis::RubberBandTool::mouseButtonRelease(), Isis::StretchTool::mouseButtonRelease(), Isis::AdvancedTrackTool::mouseLeave(), Isis::SunShadowTool::mouseMove(), Isis::TrackTool::mouseMove(), Isis::RubberBandTool::mouseMove(), Isis::ScatterPlotTool::mouseMove(), Isis::LatLonGridTool::paintViewport(), Isis::FindTool::paintViewport(), Isis::RubberBandTool::paintViewport(), Isis::SunShadowTool::paintViewport(), Isis::FileTool::print(), Isis::HistogramTool::refreshPlot(), Isis::SpatialPlotTool::refreshPlot(), Isis::SpectralPlotTool::refreshPlot(), Isis::TrackTool::removeConnections(), Isis::WindowTool::removeConnections(), rubberBandComplete(), Isis::HistogramTool::rubberBandComplete(), Isis::MeasureTool::rubberBandComplete(), Isis::StereoTool::rubberBandComplete(), Isis::StretchTool::rubberBandComplete(), Isis::ZoomTool::rubberBandComplete(), Isis::FileTool::save(), Isis::FileTool::saveAs(), Isis::FileTool::saveAsCubeByOption(), Isis::FileTool::saveInfo(), Isis::StretchTool::saveStretchToCube(), Isis::ScatterPlotTool::showNewScatterPlotConfig(), Isis::StretchTool::stretchGlobal(), Isis::StretchTool::stretchGlobalAllBands(), Isis::StretchTool::stretchRegional(), Isis::StretchTool::updateAdvStretchDialogforAll(), Isis::StretchTool::updateHistograms(), Isis::MeasureTool::updateMeasure(), Isis::AbstractPlotTool::updateTool(), Isis::BandTool::updateTool(), Isis::BlinkTool::updateTool(), updateTool(), Isis::FileTool::updateTool(), Isis::FindTool::updateTool(), Isis::LatLonGridTool::updateTool(), Isis::SpecialPixelTool::updateTool(), Isis::StretchTool::updateTool(), Isis::SunShadowTool::updateTool(), Isis::WindowTool::updateTool(), Isis::ZoomTool::updateTool(), and Isis::AbstractPlotTool::viewportsToPlot().

cubeViewportList()

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

protectedinherited

Return the list of cubeviewports.

Returns

CubeViewportList*

References Isis::Workspace::cubeViewportList().

Referenced by Isis::FileTool::closeAll(), Isis::MatchTool::createPoint(), Isis::BlinkTool::eventFilter(), Isis::PanTool::mouseButtonRelease(), Isis::RubberBandTool::mouseButtonRelease(), Isis::RubberBandTool::mouseMove(), Isis::AbstractPlotTool::repaintViewports(), Isis::ScatterPlotTool::repaintViewports(), Isis::AbstractPlotTool::repaintViewports(), Isis::ZoomTool::rubberBandComplete(), Isis::ControlNetTool::setControlNet(), Isis::FeatureNomenclatureTool::setFontColor(), Isis::FeatureNomenclatureTool::setFontSize(), Isis::FeatureNomenclatureTool::setShowApprovedOnly(), Isis::FeatureNomenclatureTool::setVectorType(), Isis::StretchTool::stretchGlobalAllViewports(), Isis::MeasureTool::updateMeasure(), Isis::BlinkTool::updateTool(), Isis::FindTool::updateTool(), Isis::WindowTool::updateTool(), and Isis::AbstractPlotTool::viewportsToPlot().

enableRubberBandTool

void Isis::EditTool::enableRubberBandTool ( )

protectedvirtualslot

This method sets up the RubberBandTool depending on which mode is enabled.

If a valid RubberBandTool mode is not enabled the RubberBandTool is disabled.

References Isis::RubberBandTool::disable(), Isis::RubberBandTool::enable(), Isis::RubberBandTool::LineMode, Isis::RubberBandTool::RectangleMode, Isis::Tool::rubberBandTool(), and Isis::RubberBandTool::setDrawActiveViewportOnly().

Referenced by createToolBarWidget().

menuName()

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::AdvancedTrackTool, Isis::BandTool, Isis::BlinkTool, Isis::FeatureNomenclatureTool, Isis::FileTool, Isis::FindTool, Isis::HelpTool, Isis::MeasureTool, Isis::PanTool, Isis::SpecialPixelTool, Isis::StretchTool, Isis::WindowTool, and Isis::ZoomTool.

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

mouseButtonPress()

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

protectedvirtualinherited

Parameters

p
s

References Isis::Tool::clearWarningSignal().

mouseButtonRelease

void Isis::EditTool::mouseButtonRelease ( QPoint p, Qt::MouseButton m )

protectedslot

This is a slot called when any mouse button is released inside of a viewport.

Parameters

p	input The point under the cursor
m	input Mouse button released (left,middle,right)

History

2007-03-02 Tracie Sucharski - Reopen cube read/write Workspace::addCubeViewport was opening cube read/write, changed to open read only so that the cube date was not changed unless EditTool is invoked.

2007-02-26 Tracie Sucharski - Remove test for off image editing. It is no longer needed since the bug in the Cube class is fixed.

2008-05-23 Noah Hilt - Removed the rectangle and start/end line functionality from the mouseButtonRelease and moved it to the rubberBandComplete method.

2017-08-11 Adam Goins - Added a "vp->cube()->open("r")" call to reopen the cube with "r" permissions if the attempted "rw" permission didn't succeed. Fixes segfault issue if editing is attempted on cube without "w" access. (ref # 2097)

References Isis::Tool::cubeViewport(), HorizLine, Point, UserDnComboValue, and VertLine.

mouseDoubleClick()

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

protectedvirtualinherited

Parameters

p

References Isis::Tool::clearWarningSignal().

mouseEnter

virtual void Isis::Tool::mouseEnter ( )

inlineprotectedvirtualslotinherited

mouseLeave

virtual void Isis::Tool::mouseLeave ( )

inlineprotectedvirtualslotinherited

mouseMove [1/2]

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

protectedvirtualslotinherited

Parameters

p

mouseMove [2/2]

virtual void Isis::Tool::mouseMove ( QPoint p, Qt::MouseButton  )

inlineprotectedvirtualslotinherited

paintViewport()

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

inlinevirtualinherited

Parameters

vp
painter

Reimplemented in Isis::ControlNetTool, Isis::QnetTool, Isis::StereoTool, Isis::LatLonGridTool, Isis::MatchTool, Isis::AbstractPlotTool, Isis::FeatureNomenclatureTool, Isis::FindTool, Isis::RubberBandTool, Isis::ScatterPlotTool, and Isis::SunShadowTool.

registerTool()

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

protectedinherited

Registers the tool to the viewport.

Parameters

viewport

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

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

removeConnections()

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.

rubberBandComplete

void Isis::EditTool::rubberBandComplete ( )

protectedslot

This method is called any time the RubberBandTool is complete.

It checks if the viewport is writable, checks which mode it is in, either line or rectangle, and if RubberBandTool is valid. It then writes the data from the RubberBandTool to the cube.

References Isis::Tool::cubeViewport(), Rectangle, Isis::RubberBandTool::rectangle(), Isis::Tool::rubberBandTool(), and StartEndLine.

rubberBandTool()

RubberBandTool * Isis::Tool::rubberBandTool ( )

inherited

References Isis::ToolList::rubberBandTool().

Referenced by Isis::MeasureTool::createToolBarWidget(), enableRubberBandTool(), Isis::HistogramTool::enableRubberBandTool(), Isis::MeasureTool::enableRubberBandTool(), Isis::SpatialPlotTool::enableRubberBandTool(), Isis::SpectralPlotTool::enableRubberBandTool(), Isis::StereoTool::enableRubberBandTool(), Isis::StretchTool::enableRubberBandTool(), Isis::Tool::enableRubberBandTool(), Isis::ZoomTool::enableRubberBandTool(), Isis::HistogramTool::refreshPlot(), Isis::SpatialPlotTool::refreshPlot(), Isis::SpectralPlotTool::refreshPlot(), Isis::RubberBandComboBox::RubberBandComboBox(), rubberBandComplete(), Isis::HistogramTool::rubberBandComplete(), Isis::MeasureTool::rubberBandComplete(), Isis::SpatialPlotTool::rubberBandComplete(), Isis::SpectralPlotTool::rubberBandComplete(), Isis::StereoTool::rubberBandComplete(), Isis::StretchTool::rubberBandComplete(), Isis::ZoomTool::rubberBandComplete(), and Isis::RubberBandComboBox::selectionChanged().

save

void Isis::EditTool::save ( )

signal

Emitted when cube should be saved.

Referenced by createToolBarWidget().

saveAs

void Isis::EditTool::saveAs ( )

signal

Emitted when cube should be saved as another file.

Referenced by createToolBarWidget().

scaleChanged()

virtual void Isis::Tool::scaleChanged ( )

inlineprotectedvirtualinherited

Reimplemented in Isis::RubberBandTool.

screenPixelsChanged

virtual void Isis::Tool::screenPixelsChanged ( )

inlineprotectedvirtualslotinherited

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

setCubeViewport

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

slotinherited

Sets the current viewport to the given cvp.

Parameters

cvp

References Isis::Tool::updateTool(), and Isis::Tool::viewportChanged().

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

setList()

void Isis::Tool::setList ( ToolList * currentList )

inherited

stretchRequested()

virtual void Isis::Tool::stretchRequested ( MdiCubeViewport * , int  )

inlineprotectedvirtualinherited

Reimplemented in Isis::StretchTool.

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

toolActivated

void Isis::Tool::toolActivated ( )

signalinherited

Referenced by Isis::Tool::activate(), Isis::FeatureNomenclatureTool::FeatureNomenclatureTool(), Isis::MatchTool::MatchTool(), and Isis::StereoTool::StereoTool().

toolIconDir()

QString Isis::Tool::toolIconDir ( ) const

inlineinherited

returns the path to the icon directory.

Returns

QString

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

toolPadAction()

QAction * Isis::EditTool::toolPadAction ( ToolPad * pad )

protectedvirtual

Adds the EditTool to the tool pad.

Parameters

pad	input The tool pad that EditTool is to be added to

Returns

QAction*

Reimplemented from Isis::Tool.

References Isis::Tool::toolIconDir().

updateMeasure()

virtual void Isis::Tool::updateMeasure ( )

inlineprotectedvirtualinherited

updateTool()

void Isis::EditTool::updateTool ( )

protectedvirtual

This is a virtual function belonging to the Tool class which is called when the user selects a different viewport.

This sets up the signal/slot for destruction of a viewport so the viewport is removed from the undoEdit hash.

Reimplemented from Isis::Tool.

References Isis::Tool::cubeViewport().

viewportChanged

void Isis::Tool::viewportChanged ( )

signalinherited

Referenced by Isis::Tool::setCubeViewport(), Isis::SpatialPlotTool::SpatialPlotTool(), Isis::SpectralPlotTool::SpectralPlotTool(), and Isis::SunShadowTool::SunShadowTool().

workspace()

Workspace * Isis::Tool::workspace ( )

protectedinherited

Referenced by addTo(), Isis::ControlNetTool::setControlNet(), and Isis::ScatterPlotTool::showNewScatterPlotConfig().

---

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

• /Users/chkim/repos/ISIS3/isis/src/qisis/objs/EditTool/EditTool.h
• /Users/chkim/repos/ISIS3/isis/src/qisis/objs/EditTool/EditTool.cpp