Isis 3.0
Back | Home
Isis::FileTool Class Reference

#include <FileTool.h>

Inherits Isis::Tool.

Inherited by Isis::QnetFileTool.

Public Slots

virtual void open ()
 This method allows the user to navigate and open a cube with a file dialog. More...
 
virtual void browse ()
 This method allows the user to navigate and browse cubes with a file dialog . More...
 
void print ()
 This method allows the user to print the current viewport. More...
 
virtual void save ()
 This method saves any changes made to the current cube, these changes are finalized! There is no undoing once a save has been made. More...
 
virtual void saveAs ()
 SaveAs Action - Displays the FileDialog with the filterlist (*.cub) to select the output cube. More...
 
virtual void saveInfo ()
 Saves the whatsthis info of the cubeviewport. More...
 
virtual void exportView ()
 This method allows the user to export the current view as an image file. More...
 
virtual bool closeAll ()
 Try to close all open cubes and save/discard if necessary. More...
 
virtual void exit ()
 Exit the program, this slot called when the exit is chosen from the File menu. More...
 
void enableSave (bool enable)
 This slot enables or disables save and save as. More...
 
void discard ()
 This slot emits a signal to discard all changes to the current viewport. More...
 
void saveAsCubeByOption (QString)
 Save as Isis Cube (FullImage, AsIs, FullRes) More...
 
void activate (bool)
 Activates the tool. More...
 
void setCubeViewport (MdiCubeViewport *cvp)
 Sets the current viewport to the given cvp. More...
 

Signals

void fileSelected (QString)
 This signal is called when a file is selected. More...
 
void saveChanges (CubeViewport *vp)
 This signal is called when changes should be saved. More...
 
void discardChanges (CubeViewport *vp)
 This signal is called when changes should be discarded. More...
 
void clearWarningSignal ()
 
void toolActivated ()
 
void viewportChanged ()
 

Public Member Functions

 FileTool (QWidget *parent)
 Constructs a FileTool object. More...
 
void addTo (QMenu *menu)
 Adds the file tool's actions to the menu. More...
 
void addTo (Workspace *ws)
 Connects the fileSelected signal to the workspace's addCubeViewport slot. More...
 
void addToPermanent (QToolBar *perm)
 Adds the file tool's actions to the permanent toolbar. More...
 
QPointer< QActionopenAction ()
 Returns the open action. More...
 
QPointer< QActionsaveAction ()
 Returns the save as action. More...
 
QString menuName () const
 Returns the menu name for the file tool. More...
 
void addTo (ViewportMainWindow *mw)
 Adds the tool to the application. More...
 
void addTo (ToolPad *toolpad)
 Adds the tool to the toolpad. More...
 
void addToActive (QToolBar *toolbar)
 
QString toolIconDir () const
 returns the path to the icon directory. More...
 
virtual void paintViewport (MdiCubeViewport *vp, QPainter *painter)
 
RubberBandToolrubberBandTool ()
 
void setList (ToolList *currentList)
 

Public Attributes

QStringList p_filterList
 Filter List. More...
 
QDir p_dir
 Directory. More...
 
QStringList p_fileList
 File list. More...
 

Protected Types

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

Protected Slots

virtual void rubberBandComplete ()
 
virtual void screenPixelsChanged ()
 This is called when actions change which pixels from the cube are displayed. More...
 
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. More...
 
virtual void updateMeasure ()
 
virtual void scaleChanged ()
 
virtual void stretchRequested (MdiCubeViewport *, int)
 
void registerTool (MdiCubeViewport *viewport)
 Registers the tool to the viewport. More...
 

Protected Member Functions

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

Detailed Description

Author
????-??-?? Unknown

Member Typedef Documentation

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

A list of cubeviewports.

Constructor & Destructor Documentation

Isis::FileTool::FileTool ( QWidget parent)

Member Function Documentation

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.

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

Adds the file tool's actions to the menu.

Parameters
menu

Reimplemented from Isis::Tool.

Reimplemented in Isis::QnetFileTool.

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

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

Connects the fileSelected signal to the workspace's addCubeViewport slot.

Parameters
ws

Reimplemented from Isis::Tool.

References Isis::Tool::addTo(), fileSelected(), and Isis::Workspace::mdiArea().

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

Adds the tool to the toolpad.

Parameters
toolpad

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

void Isis::Tool::addToActive ( QToolBar toolbar)
inherited
void Isis::FileTool::addToPermanent ( QToolBar perm)
virtual

Adds the file tool's actions to the permanent toolbar.

Parameters
perm

Reimplemented from Isis::Tool.

void Isis::FileTool::browse ( )
virtualslot

This method allows the user to navigate and browse cubes with a file dialog .

References fileSelected(), p_dir, and p_filterList.

Referenced by FileTool().

void Isis::Tool::clearWarningSignal ( )
signalinherited
bool Isis::FileTool::closeAll ( )
virtualslot

Try to close all open cubes and save/discard if necessary.

References Isis::Tool::cubeViewportList(), and Isis::Tool::setCubeViewport().

virtual QWidget* Isis::Tool::createToolBarWidget ( QStackedWidget *  parent)
inlineprotectedvirtualinherited
MdiCubeViewport* Isis::Tool::cubeViewport ( ) const
inlineprotectedinherited

Return the current cubeviewport.

Returns
CubeViewport*

Referenced by Isis::WindowTool::addConnections(), Isis::TrackTool::addConnections(), discard(), exportView(), Isis::SunShadowTool::mouseButtonPress(), Isis::PanTool::mouseButtonRelease(), Isis::IpceTool::mouseButtonRelease(), 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(), print(), Isis::HistogramTool::refreshPlot(), Isis::SpatialPlotTool::refreshPlot(), Isis::SpectralPlotTool::refreshPlot(), Isis::WindowTool::removeConnections(), Isis::TrackTool::removeConnections(), Isis::HistogramTool::rubberBandComplete(), Isis::MeasureTool::rubberBandComplete(), Isis::ZoomTool::rubberBandComplete(), Isis::StereoTool::rubberBandComplete(), Isis::EditTool::rubberBandComplete(), Isis::StretchTool::rubberBandComplete(), save(), saveAs(), saveAsCubeByOption(), saveInfo(), Isis::ScatterPlotTool::showNewScatterPlotConfig(), Isis::StretchTool::stretchGlobal(), Isis::StretchTool::stretchGlobalAllBands(), Isis::StretchTool::stretchRegional(), Isis::StretchTool::updateAdvStretchDialogforAll(), Isis::StretchTool::updateHistograms(), Isis::MeasureTool::updateMeasure(), Isis::WindowTool::updateTool(), Isis::BlinkTool::updateTool(), Isis::SpecialPixelTool::updateTool(), Isis::BandTool::updateTool(), Isis::SunShadowTool::updateTool(), Isis::AbstractPlotTool::updateTool(), Isis::ZoomTool::updateTool(), updateTool(), Isis::EditTool::updateTool(), Isis::FindTool::updateTool(), Isis::StretchTool::updateTool(), and Isis::AbstractPlotTool::viewportsToPlot().

void Isis::FileTool::discard ( )
slot

This slot emits a signal to discard all changes to the current viewport.

References Isis::Tool::cubeViewport(), and discardChanges().

Referenced by updateTool().

void Isis::FileTool::discardChanges ( CubeViewport vp)
signal

This signal is called when changes should be discarded.

Parameters
vp

Referenced by discard(), and updateTool().

void Isis::Tool::enableRubberBandTool ( )
protectedvirtualinherited

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.

References Isis::RubberBandTool::disable(), and Isis::Tool::rubberBandTool().

void Isis::FileTool::enableSave ( bool  enable)
slot

This slot enables or disables save and save as.

Parameters
enable
void Isis::FileTool::exit ( )
virtualslot

Exit the program, this slot called when the exit is chosen from the File menu.

Referenced by FileTool().

void Isis::FileTool::exportView ( )
virtualslot

This method allows the user to export the current view as an image file.

References Isis::Tool::cubeViewport().

Referenced by FileTool().

void Isis::FileTool::fileSelected ( QString  _t1)
signal

This signal is called when a file is selected.

Referenced by addTo(), browse(), Isis::QnetFileTool::loadImage(), open(), saveAs(), and saveAsCubeByOption().

QString Isis::FileTool::menuName ( ) const
inlinevirtual

Returns the menu name for the file tool.

Reimplemented from Isis::Tool.

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

References Isis::Tool::clearWarningSignal().

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

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.

References Isis::Tool::clearWarningSignal().

Referenced by Isis::StretchTool::mouseButtonRelease().

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

References Isis::Tool::clearWarningSignal().

virtual void Isis::Tool::mouseEnter ( )
inlineprotectedvirtualslotinherited
virtual void Isis::Tool::mouseLeave ( )
inlineprotectedvirtualslotinherited
void Isis::Tool::mouseMove ( QPoint  p)
protectedvirtualslotinherited
Parameters
p
virtual void Isis::Tool::mouseMove ( QPoint  p,
Qt::MouseButton   
)
inlineprotectedvirtualslotinherited
void Isis::FileTool::open ( )
virtualslot

This method allows the user to navigate and open a cube with a file dialog.

References fileSelected(), p_dir, and p_filterList.

Referenced by FileTool().

QPointer<QAction> Isis::FileTool::openAction ( )
inline

Returns the open action.

Referenced by Isis::QnetFileTool::QnetFileTool().

virtual void Isis::Tool::paintViewport ( MdiCubeViewport vp,
QPainter *  painter 
)
inlinevirtualinherited
void Isis::FileTool::print ( )
slot

This method allows the user to print the current viewport.

References Isis::Tool::cubeViewport().

Referenced by FileTool().

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

Registers the tool to the viewport.

Parameters
viewport

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

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.

virtual void Isis::Tool::rubberBandComplete ( )
inlineprotectedvirtualslotinherited
void Isis::FileTool::save ( )
virtualslot

This method saves any changes made to the current cube, these changes are finalized! There is no undoing once a save has been made.

References Isis::CubeViewport::cube(), Isis::Tool::cubeViewport(), Isis::Cube::reopen(), and saveChanges().

Referenced by FileTool(), saveAsCubeByOption(), and updateTool().

QPointer<QAction> Isis::FileTool::saveAction ( )
inline

Returns the save as action.

Referenced by Isis::QnetFileTool::QnetFileTool().

void Isis::FileTool::saveAs ( )
virtualslot

SaveAs Action - Displays the FileDialog with the filterlist (*.cub) to select the output cube.

This dialog additionally displays radio buttons for choices FullImage, ExportAsIs, ExportFullRes. These choices are located at the bottom of the dialog. FullImage - copies the entire image into the user specified output file ExportAsIs - copies the image as displayed in the qview app window ExportFullRes - copies the image as displayed in the qview app window but with full resolution

Author
Sharmila Prasad (4/8/2011)

References Isis::Tool::cubeViewport(), fileSelected(), p_dir, p_filterList, and saveAsCubeByOption().

Referenced by FileTool().

void Isis::FileTool::saveAsCubeByOption ( QString  psOutFile)
slot

Save as Isis Cube (FullImage, AsIs, FullRes)

Save input image as a cube into specified output file as FullImage or ExportAsIs or ExportFullRes option.

Author
Sharmila Prasad (4/8/2011)
Parameters
psOutFile- user specified output file

References Isis::Cube::bandCount(), Isis::Cube::close(), Isis::CubeViewport::cube(), Isis::Tool::cubeViewport(), Isis::SaveAsDialog::ExportAsIs, Isis::SaveAsDialog::ExportFullRes, Isis::Cube::fileName(), fileSelected(), Isis::SaveAsDialog::FullImage, Isis::Cube::lineCount(), Isis::Cube::open(), Isis::Cube::sampleCount(), and save().

Referenced by saveAs().

void Isis::FileTool::saveChanges ( CubeViewport vp)
signal

This signal is called when changes should be saved.

Parameters
vp

Referenced by save(), and updateTool().

void Isis::FileTool::saveInfo ( void  )
virtualslot

Saves the whatsthis info of the cubeviewport.

Saves the whatsthis info of the cubeviewport to user specified output file.

Author
Sharmila Prasad (4/6/2011)

References Isis::Tool::cubeViewport(), Isis::CubeViewport::getAllWhatsThisInfo(), and Isis::Pvl::write().

Referenced by FileTool().

virtual void Isis::Tool::scaleChanged ( )
inlineprotectedvirtualslotinherited

Reimplemented in Isis::RubberBandTool.

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

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

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 closeAll().

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

Referenced by Isis::ToolList::append().

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

Reimplemented in Isis::StretchTool.

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

virtual QAction* Isis::Tool::toolPadAction ( ToolPad toolpad)
inlineprotectedvirtualinherited
virtual void Isis::Tool::updateMeasure ( )
inlineprotectedvirtualslotinherited
void Isis::FileTool::updateTool ( )
protectedvirtual

Updates the tool.

This method is called when the tool is updated.

Reimplemented from Isis::Tool.

References Isis::Tool::cubeViewport(), discard(), discardChanges(), save(), and saveChanges().

Workspace * Isis::Tool::workspace ( )
protectedinherited

Member Data Documentation

QDir Isis::FileTool::p_dir

Directory.

Referenced by browse(), FileTool(), open(), and saveAs().

QStringList Isis::FileTool::p_fileList

File list.

QStringList Isis::FileTool::p_filterList

Filter List.

Referenced by browse(), open(), and saveAs().


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

U.S. Department of the Interior | U.S. Geological Survey
ISIS | Privacy & Disclaimers | Astrogeology Research Program
To contact us, please post comments and questions on the ISIS Support Center
File Modified: 07/12/2023 23:37:18