Isis::CubeViewport Class Reference

Widget to display Isis cubes for qt apps. More...

#include <CubeViewport.h>

Inherits QAbstractScrollArea.

Inherited by Isis::IndependentCubeViewport, and Isis::MdiCubeViewport.

List of all members.

Classes
class	BandInfo
Public Slots
QSize	sizeHint () const
	Make viewports show up as 512 by 512.
void	setScale (double scale)
	Change the scale of the cube to the given parameter value.
void	setScale (double scale, double sample, double line)
	Change the scale of the cube after moving samp/line to the center.
void	setScale (double scale, int x, int y)
	Change the scale of the cube after moving x,y to the center.
void	center (int x, int y)
	Bring the cube pixel under viewport x/y to the center.
void	center (double sample, double line)
	Bring the cube sample/line the center.
virtual void	viewRGB (int redBand, int greenBand, int blueBand)
	View cube as color.
virtual void	viewGray (int band)
	View cube as gray.
void	stretchGray (const QString &string)
	Apply stretch pairs to gray band.
void	stretchRed (const QString &string)
	Apply stretch pairs to red bands.
void	stretchGreen (const QString &string)
	Apply stretch pairs to green bands.
void	stretchBlue (const QString &string)
	Apply stretch pairs to blue bands.
void	stretchGray (const Stretch &stretch)
	Sets the stretch for gray mode.
void	stretchRed (const Stretch &stretch)
	Sets the stretch for red in rgb mode.
void	stretchGreen (const Stretch &stretch)
	Sets the stretch for green in rgb mode.
void	stretchBlue (const Stretch &stretch)
	Sets the stretch for blue in rgb mode.
void	stretchKnownGlobal ()
	List<Tool *> p This stretches to the global stretch.
void	cubeChanged (bool changed)
	This method is called when the cube has changed or changes have been finalized.
void	showEvent (QShowEvent *)
	This method is called to initially show the viewport.
void	scrollBy (int dx, int dy)
	Move the scrollbars by dx/dy screen pixels.
void	changeCursor (QCursor cursor)
	Allows users to change the cursor type on the viewport.
void	onProgressTimer ()
	This updates the progress bar visually.
void	enableProgress ()
	This restarts the progress bar.
Signals
void	viewportUpdated ()
	Emitted when viewport updated.
void	viewportClosed (CubeViewport *)
	Emitted when viewport is closed.
void	mouseEnter ()
	Emitted when the mouse enters the viewport.
void	mouseMove (QPoint)
	Emitted when the mouse moves.
void	mouseMove (QPoint, Qt::MouseButton)
	Emitted when the mouse moves.
void	mouseLeave ()
	Emitted when the mouse leaves the viewport.
void	mouseButtonPress (QPoint, Qt::MouseButton)
	Emitted when mouse button pressed.
void	mouseButtonRelease (QPoint, Qt::MouseButton)
	Emitted when mouse button released.
void	mouseDoubleClick (QPoint)
	Emitted when double click happens.
void	windowTitleChanged ()
	Emitted when window title changes.
void	scaleChanged ()
	Emitted when zoom factor changed just before the repaint event.
void	saveChanges (CubeViewport *)
	Emitted when changes should be saved.
void	discardChanges (CubeViewport *)
	Emitted when changes should be discarded.
void	screenPixelsChanged ()
	Emitted when cube pixels that should be on the screen change.
void	progressChanged (int)
	Emitted with current progress (0 to 100) when working.
void	doneWithData (int, const Isis::Brick *)
	Emitted when a brick is no longer needed, should only be sent to cube data thread.
Public Member Functions
	CubeViewport (Cube *cube, CubeDataThread *cdt=0, QWidget *parent=0)
	Construct a cube viewport.
virtual	~CubeViewport ()
	Destructor.
void	setCube (Cube *cube)
	This method sets the viewports cube.
int	cubeSamples () const
	Return the number of samples in the cube.
int	cubeLines () const
	Return the number of lines in the cube.
int	cubeBands () const
	Return the number of bands in the cube.
bool	isColor () const
	Is the viewport shown in 3-band color.
bool	isGray () const
	Is the viewport shown in gray / b&w.
int	grayBand () const
	Return the gray band currently viewed.
int	redBand () const
	Return the red band currently viewed.
int	greenBand () const
	Return the green band currently viewed.
int	blueBand () const
	Return the blue band currently viewed.
double	scale () const
	Return the scale.
bool	cubeShown () const
	Return if the cube is visible.
void	cubeContentsChanged (QRect rect)
	Cube changed, repaint given area.
double	fitScale () const
	Determine the scale that causes the full cube to fit in the viewport.
double	fitScaleWidth () const
	Determine the scale of cube in the width to fit in the viewport.
double	fitScaleHeight () const
	Determine the scale of cube in heighth to fit in the viewport.
void	viewportToCube (int x, int y, double &sample, double &line) const
	Convert a viewport x/y to a cube sample/line (may be outside the cube).
void	cubeToViewport (double sample, double line, int &x, int &y) const
	Convert a cube sample/line to a viewport x/y (may be outside the viewport).
void	contentsToCube (int x, int y, double &sample, double &line) const
	Convert a contents x/y to a cube sample/line (may be outside the cube).
void	cubeToContents (double sample, double line, int &x, int &y) const
	Convert a cube sample/line to a contents x/y (should not be outside).
double	redPixel (int sample, int line)
	Return the red pixel value at a sample/line.
double	greenPixel (int sample, int line)
	Return the green pixel value at a sample/line.
double	bluePixel (int sample, int line)
	Return the blue pixel value at a sample/line.
double	grayPixel (int sample, int line)
	Return the gray pixel value at a sample/line.
Stretch	grayStretch () const
	Return the gray band stretch.
Stretch	redStretch () const
	Return the red band stretch.
Stretch	greenStretch () const
	Return the green band stretch.
Stretch	blueStretch () const
	Return the blue band stretch.
Cube *	cube () const
	Return the cube associated with viewport.
Projection *	projection () const
	Return the projection associated with cube (NULL implies none).
Camera *	camera () const
	Return the camera associated with the cube (NULL implies none).
UniversalGroundMap *	universalGroundMap () const
	Return the universal ground map associated with the cube (NULL implies none).
void	moveCursor (int x, int y)
	Move the cursor by x,y if possible.
bool	cursorInside () const
	Is cursor inside viewport.
QPoint	cursorPosition () const
	Return the cursor position in the viewport.
void	setCursorPosition (int x, int y)
	Set the cursor position to x/y in the viewport.
void	setCaption ()
	Change the caption on the viewport title bar.
void	setBackground (QColor color)
	Sets the background color.
QPixmap	pixmap ()
	Returns the pixmap.
ViewportBuffer *	grayBuffer ()
	Returns the gray viewport buffer (Will be NULL if in RGB mode.
ViewportBuffer *	redBuffer ()
	Returns the red viewport buffer (Will be NULL if in Gray mode.
ViewportBuffer *	greenBuffer ()
	Returns the green viewport buffer (Will be NULL if in Gray mode.
ViewportBuffer *	blueBuffer ()
	Returns the blue viewport buffer (Will be NULL if in Gray mode.
void	bufferUpdated (QRect rect)
	This method is called by ViewportBuffer upon successful completion of all operations and gives the appropriate rect to be repainted.
virtual void	restretch (ViewportBuffer *buffer)=0
	This is called by internal viewport buffers when a stretch action should be performed.
void	paintPixmap ()
	Paint the whole pixmap.
void	forgetStretches ()
	Resets all remembered stretches.
void	setAllBandStretches (Stretch stretch)
	Sets a stretch for all bands.
CubeDataThread *	cubeDataThread ()
int	cubeID ()
void	getAllWhatsThisInfo (Pvl &pWhatsThisPvl)
	Get All WhatsThis info - viewport, cube, area in PVL format.
void	getBandFilterName (PvlKeyword &pFilterNameKey)
	Get Band Filter name from the Isis cube label.
void	getCubeArea (double &pdStartSample, double &pdEndSample, double &pdStartLine, double &pdEndLine)
	Get Cube area corresponding to the viewport's dimension.
bool	confirmClose ()
	This method should be called during a close event that would cause this viewport to close.
Protected Slots
virtual void	cubeDataChanged (int cubeId, const Isis::Brick *)
	This method updates the internal viewport buffer based on changes in cube DN values.
Protected Member Functions
void	scrollContentsBy (int dx, int dy)
	Scroll the viewport contents by dx/dy screen pixels.
virtual void	resizeEvent (QResizeEvent *e)
	The viewport is being resized.
virtual bool	eventFilter (QObject *o, QEvent *e)
	Event filter to watch for mouse events on viewport.
virtual void	keyPressEvent (QKeyEvent *e)
	Process arrow keystrokes on cube.
virtual void	paintEvent (QPaintEvent *e)
	Repaint the viewport.
Protected Attributes
QPixmap	p_pixmap
	The qpixmap.
QVector< Stretch * > *	p_knownStretches
	Stretches for each previously stretched band.
QVector< Stretch * > *	p_globalStretches
	Global stretches for each stretched band.

---

Detailed Description

Widget to display Isis cubes for qt apps.

Author:

????-??-?? Jeff Anderson

---

Constructor & Destructor Documentation

Isis::CubeViewport::CubeViewport	(	Cube *	cube,
		CubeDataThread *	cubeData = 0,
		QWidget *	parent = 0
	)

Construct a cube viewport.

Parameters:

	cube
	parent

References _FILEINFO_, Isis::CubeDataThread::AddChangeListener(), Isis::CubeDataThread::AddCube(), Isis::Cube::bandCount(), Isis::UniversalGroundMap::Camera(), cubeDataChanged(), doneWithData(), Isis::Cube::fileName(), Isis::CubeDataThread::FindCubeId(), Isis::Camera::HasProjection(), Isis::Cube::isOpen(), Isis::Cube::lineCount(), onProgressTimer(), p_globalStretches, p_knownStretches, Isis::Cube::pixelType(), Isis::IException::Programmer, Isis::UniversalGroundMap::Projection(), Isis::Cube::projection(), Isis::Cube::sampleCount(), and setCaption().

Isis::CubeViewport::~CubeViewport

(

)

[virtual]

Destructor.

References p_globalStretches, p_knownStretches, Isis::CubeDataThread::RemoveChangeListener(), and stretch.

---

Member Function Documentation

int Isis::CubeViewport::blueBand

(

)

const [inline]

Return the blue band currently viewed.

References Isis::CubeViewport::BandInfo::band.

Referenced by Isis::StretchTool::stretchBand(), stretchBlue(), stretchKnownGlobal(), and Isis::BandTool::updateTool().

ViewportBuffer* Isis::CubeViewport::blueBuffer

(

)

[inline]

Returns the blue viewport buffer (Will be NULL if in Gray mode.

)

Returns:

ViewportBuffer*

Referenced by Isis::MdiCubeViewport::restretch(), Isis::StretchTool::setCubeViewport(), Isis::StretchTool::stretchRequested(), Isis::StretchTool::updateAdvStretchDialogforAll(), and Isis::StretchTool::updateHistograms().

double Isis::CubeViewport::bluePixel	(	int	sample,
		int	line
	)

Return the blue pixel value at a sample/line.

Parameters:

	sample
	line

Returns:

double

References Isis::CubeViewport::BandInfo::band, Isis::Cube::read(), and Isis::Brick::SetBasePosition().

Stretch Isis::CubeViewport::blueStretch

(

)

const

Return the blue band stretch.

References Isis::CubeViewport::BandInfo::getStretch().

Referenced by Isis::StretchTool::setCubeViewport(), Isis::StretchTool::stretchBand(), Isis::StretchTool::stretchRequested(), Isis::StretchTool::updateAdvStretchDialogforAll(), and Isis::AdvancedStretchDialog::updateStretch().

void Isis::CubeViewport::bufferUpdated

(

QRect

rect

)

This method is called by ViewportBuffer upon successful completion of all operations and gives the appropriate rect to be repainted.

This is intended to update the screen once all data is done and ready to be displayed.

Parameters:

rect

Area to update screen

References paintPixmap(), and Isis::ViewportBuffer::working().

Camera* Isis::CubeViewport::camera

(

)

const [inline]

Return the camera associated with the cube (NULL implies none).

Referenced by Isis::MeasureTool::rubberBandComplete(), and Isis::FindTool::updateTool().

void Isis::CubeViewport::center	(	double	sample,
		double	line
	)			[slot]

Bring the cube sample/line the center.

Parameters:

	sample
	line

References cubeToContents(), Isis::ViewportBuffer::pan(), screenPixelsChanged(), x, and y.

void Isis::CubeViewport::center	(	int	x,
		int	y
	)			[slot]

Bring the cube pixel under viewport x/y to the center.

Parameters:

	x
	y

References line, sample, and viewportToCube().

Referenced by Isis::PanTool::mouseButtonRelease(), and setScale().

void Isis::CubeViewport::changeCursor

(

QCursor

cursor

)

[slot]

Allows users to change the cursor type on the viewport.

Parameters:

cursor

bool Isis::CubeViewport::confirmClose

(

)

This method should be called during a close event that would cause this viewport to close.

If changes have been made to this viewport it opens an information dialog that asks the user if they want to save, discard changes, or cancel.

Returns:

True if closing is OK, false if it needs to be cancelled.

References cube(), discardChanges(), and saveChanges().

void Isis::CubeViewport::contentsToCube	(	int	x,
		int	y,
		double &	sample,
		double &	line
	)			const

Convert a contents x/y to a cube sample/line (may be outside the cube).

Parameters:

	x
	y
	sample
	line

Referenced by setScale(), and viewportToCube().

Cube* Isis::CubeViewport::cube

(

)

const [inline]

Return the cube associated with viewport.

Referenced by confirmClose(), Isis::MatchTool::createPoint(), cubeContentsChanged(), cubeDataChanged(), Isis::SunShadowTool::mouseButtonPress(), Isis::MatchTool::mouseButtonRelease(), Isis::EditTool::mouseButtonRelease(), Isis::CubePlotCurve::paint(), Isis::StereoTool::paintViewport(), Isis::HistogramTool::refreshPlot(), Isis::AbstractPlotTool::repaintViewports(), Isis::StereoTool::rubberBandComplete(), Isis::EditTool::rubberBandComplete(), Isis::FileTool::save(), Isis::FileTool::saveAsCubeByOption(), Isis::ScatterPlotConfigDialog::ScatterPlotConfigDialog(), Isis::StretchTool::stretchBand(), Isis::ChipViewport::stretchFromCubeViewport(), Isis::SunShadowTool::updateTool(), Isis::SpectralPlotTool::updateTool(), Isis::BandTool::updateTool(), Isis::ScatterPlotConfigDialog::xAxisCubeViewport(), and Isis::ScatterPlotConfigDialog::yAxisCubeViewport().

int Isis::CubeViewport::cubeBands

(

)

const

Return the number of bands in the cube.

References Isis::Cube::bandCount().

Referenced by Isis::IndependentCubeViewport::resetKnownGlobal().

void Isis::CubeViewport::cubeChanged

(

bool

changed

)

[slot]

This method is called when the cube has changed or changes have been finalized.

Parameters:

changed

void Isis::CubeViewport::cubeContentsChanged

(

QRect

cubeRect

)

Cube changed, repaint given area.

Parameters:

[in]

cubeRect

(QRect rect) Rectange containing portion of cube (sample/line) that changed.

References cube(), cubeToViewport(), ex, Isis::ViewportBuffer::fillBuffer(), Isis::Cube::lineCount(), and Isis::Cube::sampleCount().

void Isis::CubeViewport::cubeDataChanged	(	int	cubeId,
		const Isis::Brick *	data
	)			[protected, virtual, slot]

This method updates the internal viewport buffer based on changes in cube DN values.

Parameters:

	cubeId	Cube that the changed brick belongs to
	data	New data

Reimplemented in Isis::IndependentCubeViewport.

References cube(), cubeToViewport(), doneWithData(), ex, Isis::ViewportBuffer::fillBuffer(), Isis::Buffer::Line(), Isis::Cube::lineCount(), Isis::Buffer::LineDimension(), Isis::Buffer::Sample(), Isis::Cube::sampleCount(), Isis::Buffer::SampleDimension(), sl, and ss.

Referenced by CubeViewport().

CubeDataThread* Isis::CubeViewport::cubeDataThread

(

)

[inline]

Returns:

this CubeViewport's CubeDataThread

int Isis::CubeViewport::cubeID

(

)

[inline]

Returns:

the CubeViewport's cube id

Referenced by Isis::IndependentCubeViewport::cubeDataChanged().

int Isis::CubeViewport::cubeLines

(

)

const

Return the number of lines in the cube.

References Isis::Cube::lineCount().

Referenced by Isis::IndependentCubeViewport::cubeDataChanged(), fitScale(), fitScaleHeight(), getCubeArea(), Isis::ViewportBuffer::hasEntireCube(), Isis::EditTool::mouseButtonRelease(), Isis::EditTool::rubberBandComplete(), setScale(), and showEvent().

int Isis::CubeViewport::cubeSamples

(

)

const

Return the number of samples in the cube.

References Isis::Cube::sampleCount().

Referenced by Isis::IndependentCubeViewport::cubeDataChanged(), fitScale(), fitScaleWidth(), getCubeArea(), Isis::ViewportBuffer::hasEntireCube(), Isis::EditTool::mouseButtonRelease(), Isis::EditTool::rubberBandComplete(), setScale(), and showEvent().

bool Isis::CubeViewport::cubeShown

(

)

const [inline]

Return if the cube is visible.

void Isis::CubeViewport::cubeToContents	(	double	sample,
		double	line,
		int &	x,
		int &	y
	)			const

Convert a cube sample/line to a contents x/y (should not be outside).

Parameters:

	sample
	line
	x
	y

Referenced by center(), cubeToViewport(), and setScale().

void Isis::CubeViewport::cubeToViewport	(	double	sample,
		double	line,
		int &	x,
		int &	y
	)			const

Convert a cube sample/line to a viewport x/y (may be outside the viewport).

Parameters:

	sample
	line
	x
	y

References cubeToContents().

Referenced by cubeContentsChanged(), cubeDataChanged(), Isis::CubePlotCurve::paint(), Isis::SunShadowTool::paintViewport(), Isis::StereoTool::paintViewport(), Isis::FindTool::paintViewport(), and Isis::HistogramTool::refreshPlot().

bool Isis::CubeViewport::cursorInside

(

)

const

Is cursor inside viewport.

Returns:

bool

References g.

QPoint Isis::CubeViewport::cursorPosition

(

)

const

Return the cursor position in the viewport.

Returns:

QPoint

References g.

void Isis::CubeViewport::discardChanges

(

CubeViewport *

)

[signal]

Emitted when changes should be discarded.

Referenced by confirmClose().

void Isis::CubeViewport::doneWithData	(	int	,
		const Isis::Brick *
	)			[signal]

Emitted when a brick is no longer needed, should only be sent to cube data thread.

Referenced by cubeDataChanged(), and CubeViewport().

void Isis::CubeViewport::enableProgress

(

)

[slot]

This restarts the progress bar.

Does nothing if already loading.

References progressChanged().

bool Isis::CubeViewport::eventFilter	(	QObject *	o,
		QEvent *	e
	)			[protected, virtual]

Event filter to watch for mouse events on viewport.

Parameters:

	o
	e

Returns:

bool

Reimplemented in Isis::IndependentCubeViewport.

References mouseButtonPress(), mouseButtonRelease(), mouseDoubleClick(), mouseEnter(), mouseLeave(), and mouseMove().

double Isis::CubeViewport::fitScale

(

)

const

Determine the scale that causes the full cube to fit in the viewport.

Returns:

The scale

References cubeLines(), cubeSamples(), and scale().

Referenced by showEvent().

double Isis::CubeViewport::fitScaleHeight

(

)

const

Determine the scale of cube in heighth to fit in the viewport.

Returns:

The scale for height

References cubeLines(), and scale().

double Isis::CubeViewport::fitScaleWidth

(

)

const

Determine the scale of cube in the width to fit in the viewport.

Returns:

The scale for width

References cubeSamples(), and scale().

void Isis::CubeViewport::forgetStretches

(

)

Resets all remembered stretches.

References p_knownStretches, and stretch.

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

void Isis::CubeViewport::getAllWhatsThisInfo

(

Pvl &

pWhatsThisPvl

)

Get All WhatsThis info - viewport, cube, area in PVL format.

Parameters:

pWhatsThisPvl

- Pvl for all whatsthis info

Author:

Sharmila Prasad (4/5/2011)

Parameters:

pWhatsThisPvl

- Pvl for all whatsthis info

References Isis::Cube::bandCount(), Isis::Cube::fileName(), Isis::ViewportBuffer::getBand(), getBandFilterName(), getCubeArea(), Isis::Cube::lineCount(), Isis::Cube::physicalBand(), Isis::Cube::sampleCount(), Isis::PvlKeyword::Size(), sl, ss, and Isis::toString().

Referenced by Isis::FileTool::saveInfo().

void Isis::CubeViewport::getBandFilterName

(

PvlKeyword &

pFilterNameKey

)

Get Band Filter name from the Isis cube label.

Parameters:

pFilterNameKey

- FilterName keyword containing the corresponding keyword from the Isis Cube label

Author:

Sharmila Prasad (4/5/2011)

Parameters:

PvlKeyword&

pFilterNameKey - FilterName keyword containing the corresponding keyword from the Isis Cube label

References Isis::PvlObject::FindGroup(), Isis::PvlContainer::FindKeyword(), Isis::PvlObject::FindObject(), Isis::PvlObject::HasGroup(), Isis::PvlContainer::HasKeyword(), and Isis::Cube::label().

Referenced by getAllWhatsThisInfo().

void Isis::CubeViewport::getCubeArea	(	double &	pdStartSample,
		double &	pdEndSample,
		double &	pdStartLine,
		double &	pdEndLine
	)

Get Cube area corresponding to the viewport's dimension.

Parameters:

	pdStartSample	- Cube Start Sample
	pdEndSample	- Cube End Sample
	pdStartLine	- Cube Start Line
	pdEndLine	- Cube End Line

References cubeLines(), cubeSamples(), and viewportToCube().

Referenced by getAllWhatsThisInfo(), and Isis::FileTool::saveAsCubeByOption().

int Isis::CubeViewport::grayBand

(

)

const [inline]

Return the gray band currently viewed.

References Isis::CubeViewport::BandInfo::band.

Referenced by Isis::IndependentCubeViewport::cubeDataChanged(), Isis::EditTool::mouseButtonRelease(), Isis::SpatialPlotTool::refreshPlot(), Isis::HistogramTool::refreshPlot(), Isis::StretchTool::stretchBand(), stretchGray(), stretchKnownGlobal(), and Isis::BandTool::updateTool().

ViewportBuffer* Isis::CubeViewport::grayBuffer

(

)

[inline]

Returns the gray viewport buffer (Will be NULL if in RGB mode.

)

Returns:

ViewportBuffer*

Referenced by Isis::ScatterPlotWindow::paint(), Isis::IndependentCubeViewport::resetKnownGlobal(), Isis::MdiCubeViewport::restretch(), Isis::StretchTool::setCubeViewport(), Isis::IndependentCubeViewport::showEvent(), Isis::StretchTool::stretchRequested(), and Isis::StretchTool::updateHistograms().

double Isis::CubeViewport::grayPixel	(	int	sample,
		int	line
	)

Return the gray pixel value at a sample/line.

Parameters:

	sample
	line

Returns:

double

References Isis::CubeViewport::BandInfo::band, Isis::Cube::read(), and Isis::Brick::SetBasePosition().

Stretch Isis::CubeViewport::grayStretch

(

)

const

Return the gray band stretch.

References Isis::CubeViewport::BandInfo::getStretch().

Referenced by Isis::IndependentCubeViewport::cubeDataChanged(), Isis::IndependentCubeViewport::restretch(), Isis::StretchTool::setCubeViewport(), Isis::StretchTool::stretchBand(), Isis::StretchTool::stretchRequested(), and Isis::AdvancedStretchDialog::updateStretch().

int Isis::CubeViewport::greenBand

(

)

const [inline]

Return the green band currently viewed.

References Isis::CubeViewport::BandInfo::band.

Referenced by Isis::StretchTool::stretchBand(), stretchGreen(), stretchKnownGlobal(), and Isis::BandTool::updateTool().

ViewportBuffer* Isis::CubeViewport::greenBuffer

(

)

[inline]

Returns the green viewport buffer (Will be NULL if in Gray mode.

)

Returns:

ViewportBuffer*

Referenced by Isis::MdiCubeViewport::restretch(), Isis::StretchTool::setCubeViewport(), Isis::StretchTool::stretchRequested(), Isis::StretchTool::updateAdvStretchDialogforAll(), and Isis::StretchTool::updateHistograms().

double Isis::CubeViewport::greenPixel	(	int	sample,
		int	line
	)

Return the green pixel value at a sample/line.

Parameters:

	sample
	line

Returns:

double

References Isis::CubeViewport::BandInfo::band, Isis::Cube::read(), and Isis::Brick::SetBasePosition().

Stretch Isis::CubeViewport::greenStretch

(

)

const

Return the green band stretch.

References Isis::CubeViewport::BandInfo::getStretch().

Referenced by Isis::StretchTool::setCubeViewport(), Isis::StretchTool::stretchBand(), Isis::StretchTool::stretchRequested(), Isis::StretchTool::updateAdvStretchDialogforAll(), and Isis::AdvancedStretchDialog::updateStretch().

bool Isis::CubeViewport::isColor

(

)

const [inline]

Is the viewport shown in 3-band color.

Referenced by Isis::EditTool::mouseButtonRelease(), and Isis::EditTool::rubberBandComplete().

bool Isis::CubeViewport::isGray

(

)

const [inline]

Is the viewport shown in gray / b&w.

Referenced by Isis::SpatialPlotTool::refreshPlot(), Isis::StretchTool::setCubeViewport(), stretchKnownGlobal(), Isis::StretchTool::updateAdvStretchDialogforAll(), Isis::StretchTool::updateHistograms(), Isis::StretchTool::updateTool(), and Isis::BandTool::updateTool().

void Isis::CubeViewport::keyPressEvent

(

QKeyEvent *

e

)

[protected, virtual]

Process arrow keystrokes on cube.

Parameters:

e

References moveCursor(), scale(), and setScale().

void Isis::CubeViewport::mouseButtonPress	(	QPoint	,
		Qt::MouseButton
	)			[signal]

Emitted when mouse button pressed.

Referenced by eventFilter().

void Isis::CubeViewport::mouseButtonRelease	(	QPoint	,
		Qt::MouseButton
	)			[signal]

Emitted when mouse button released.

Referenced by eventFilter().

void Isis::CubeViewport::mouseDoubleClick

(

QPoint

)

[signal]

Emitted when double click happens.

Referenced by eventFilter().

void Isis::CubeViewport::mouseEnter

(

)

[signal]

Emitted when the mouse enters the viewport.

Referenced by Isis::IndependentCubeViewport::eventFilter(), and eventFilter().

void Isis::CubeViewport::mouseLeave

(

)

[signal]

Emitted when the mouse leaves the viewport.

Referenced by Isis::IndependentCubeViewport::eventFilter(), and eventFilter().

void Isis::CubeViewport::mouseMove	(	QPoint	,
		Qt::MouseButton
	)			[signal]

Emitted when the mouse moves.

void Isis::CubeViewport::mouseMove

(

QPoint

)

[signal]

Emitted when the mouse moves.

Referenced by eventFilter().

void Isis::CubeViewport::moveCursor	(	int	x,
		int	y
	)

Move the cursor by x,y if possible.

Parameters:

	x
	y

References g.

Referenced by keyPressEvent().

void Isis::CubeViewport::onProgressTimer

(

)

[slot]

This updates the progress bar visually.

Conceptually it emits the progressChanged signal with the current progress.

References Isis::ViewportBuffer::currentProgress(), progressChanged(), screenPixelsChanged(), and Isis::ViewportBuffer::working().

Referenced by CubeViewport().

void Isis::CubeViewport::paintEvent

(

QPaintEvent *

e

)

[protected, virtual]

Repaint the viewport.

Parameters:

e

[in] (QPaintEvent *) event

Reimplemented in Isis::IndependentCubeViewport, and Isis::MdiCubeViewport.

void Isis::CubeViewport::paintPixmap

(

)

Paint the whole pixmap.

Referenced by bufferUpdated(), resizeEvent(), scrollContentsBy(), setScale(), showEvent(), stretchBlue(), stretchGray(), stretchGreen(), and stretchRed().

QPixmap Isis::CubeViewport::pixmap

(

)

[inline]

Returns the pixmap.

Returns:

QPixmap

References p_pixmap.

Referenced by Isis::BlinkTool::eventFilter().

void Isis::CubeViewport::progressChanged

(

int

)

[signal]

Emitted with current progress (0 to 100) when working.

Referenced by enableProgress(), and onProgressTimer().

Projection* Isis::CubeViewport::projection

(

)

const [inline]

Return the projection associated with cube (NULL implies none).

Referenced by Isis::MeasureTool::rubberBandComplete(), and Isis::FindTool::updateTool().

int Isis::CubeViewport::redBand

(

)

const [inline]

Return the red band currently viewed.

References Isis::CubeViewport::BandInfo::band.

Referenced by Isis::SpatialPlotTool::refreshPlot(), Isis::StretchTool::stretchBand(), stretchKnownGlobal(), stretchRed(), and Isis::BandTool::updateTool().

ViewportBuffer* Isis::CubeViewport::redBuffer

(

)

[inline]

Returns the red viewport buffer (Will be NULL if in Gray mode.

)

Returns:

ViewportBuffer*

Referenced by Isis::MdiCubeViewport::restretch(), Isis::StretchTool::setCubeViewport(), Isis::StretchTool::stretchRequested(), Isis::StretchTool::updateAdvStretchDialogforAll(), and Isis::StretchTool::updateHistograms().

double Isis::CubeViewport::redPixel	(	int	sample,
		int	line
	)

Return the red pixel value at a sample/line.

Parameters:

	sample
	line

Returns:

double

References Isis::CubeViewport::BandInfo::band, Isis::Cube::read(), and Isis::Brick::SetBasePosition().

Stretch Isis::CubeViewport::redStretch

(

)

const

Return the red band stretch.

References Isis::CubeViewport::BandInfo::getStretch().

Referenced by Isis::StretchTool::setCubeViewport(), Isis::StretchTool::stretchBand(), Isis::StretchTool::stretchRequested(), Isis::StretchTool::updateAdvStretchDialogforAll(), and Isis::AdvancedStretchDialog::updateStretch().

void Isis::CubeViewport::resizeEvent

(

QResizeEvent *

e

)

[protected, virtual]

The viewport is being resized.

Parameters:

e

References p_pixmap, paintPixmap(), Isis::ViewportBuffer::resizedViewport(), screenPixelsChanged(), and size.

virtual void Isis::CubeViewport::restretch

(

ViewportBuffer *

buffer

)

[pure virtual]

This is called by internal viewport buffers when a stretch action should be performed.

The buffer passes itself as the argument.

Parameters:

buffer

Implemented in Isis::IndependentCubeViewport, and Isis::MdiCubeViewport.

void Isis::CubeViewport::saveChanges

(

CubeViewport *

)

[signal]

Emitted when changes should be saved.

Referenced by confirmClose().

double Isis::CubeViewport::scale

(

)

const [inline]

Return the scale.

Referenced by fitScale(), fitScaleHeight(), fitScaleWidth(), keyPressEvent(), Isis::ViewportBuffer::pan(), Isis::ViewportBuffer::resizedViewport(), Isis::ZoomTool::rubberBandComplete(), Isis::FileTool::saveAsCubeByOption(), and Isis::ZoomTool::updateTool().

void Isis::CubeViewport::scaleChanged

(

)

[signal]

Emitted when zoom factor changed just before the repaint event.

Referenced by setScale().

void Isis::CubeViewport::screenPixelsChanged

(

)

[signal]

Emitted when cube pixels that should be on the screen change.

Referenced by center(), onProgressTimer(), resizeEvent(), scrollContentsBy(), and setScale().

void Isis::CubeViewport::scrollBy	(	int	dx,
		int	dy
	)			[slot]

Move the scrollbars by dx/dy screen pixels.

Parameters:

	dx
	dy

References maximum, scrollContentsBy(), x, and y.

void Isis::CubeViewport::scrollContentsBy	(	int	dx,
		int	dy
	)			[protected]

Scroll the viewport contents by dx/dy screen pixels.

Parameters:

	dx
	dy

References Isis::ViewportBuffer::bufferXYRect(), paintPixmap(), Isis::ViewportBuffer::pan(), screenPixelsChanged(), and Isis::ViewportBuffer::working().

Referenced by scrollBy().

void Isis::CubeViewport::setAllBandStretches

(

Stretch

stretch

)

Sets a stretch for all bands.

Parameters:

stretch

References p_knownStretches.

void Isis::CubeViewport::setBackground

(

QColor

color

)

[inline]

Sets the background color.

Parameters:

color

void Isis::CubeViewport::setCaption

(

)

Change the caption on the viewport title bar.

References Isis::CubeViewport::BandInfo::band, Isis::Cube::fileName(), str, and windowTitleChanged().

Referenced by CubeViewport(), setCube(), setScale(), viewGray(), and viewRGB().

void Isis::CubeViewport::setCube

(

Cube *

cube

)

This method sets the viewports cube.

Parameters:

cube

References setCaption().

void Isis::CubeViewport::setCursorPosition	(	int	x,
		int	y
	)

Set the cursor position to x/y in the viewport.

Parameters:

	x
	y

References g.

void Isis::CubeViewport::setScale	(	double	scale,
		int	x,
		int	y
	)			[slot]

Change the scale of the cube after moving x,y to the center.

Parameters:

	scale
	x
	y

References line, setScale(), and viewportToCube().

void Isis::CubeViewport::setScale	(	double	scale,
		double	sample,
		double	line
	)			[slot]

Change the scale of the cube after moving samp/line to the center.

Parameters:

	scale
	sample
	line

References center(), Isis::ViewportBuffer::enable(), Isis::ViewportBuffer::enabled(), paintPixmap(), screenPixelsChanged(), and setScale().

void Isis::CubeViewport::setScale

(

double

scale

)

[slot]

Change the scale of the cube to the given parameter value.

This method will reset the scale value if the value passed in is too large or too small.

Parameters:

scale

Value by which to scale the image.

References contentsToCube(), cubeLines(), cubeSamples(), cubeToContents(), line, min(), paintPixmap(), scaleChanged(), Isis::ViewportBuffer::scaleChanged(), screenPixelsChanged(), setCaption(), x, and y.

Referenced by keyPressEvent(), setScale(), and showEvent().

void Isis::CubeViewport::showEvent

(

QShowEvent *

event

)

[slot]

This method is called to initially show the viewport.

It will set the scale to show the entire cube and enable the gray buffer.

Reimplemented in Isis::IndependentCubeViewport.

References Isis::ViewportBuffer::addStretchAction(), cubeLines(), cubeSamples(), Isis::ViewportBuffer::enable(), Isis::ViewportBuffer::enabled(), fitScale(), paintPixmap(), and setScale().

QSize Isis::CubeViewport::sizeHint

(

)

const [slot]

Make viewports show up as 512 by 512.

Returns:

QSize

void Isis::CubeViewport::stretchBlue

(

const Stretch &

stretch

)

[slot]

Sets the stretch for blue in rgb mode.

Parameters:

stretch

References blueBand(), Isis::CubeViewport::BandInfo::getStretch(), p_globalStretches, paintPixmap(), Isis::Stretch::Pairs(), and Isis::CubeViewport::BandInfo::setStretch().

void Isis::CubeViewport::stretchBlue

(

const QString &

string

)

[slot]

Apply stretch pairs to blue bands.

Parameters:

stretch

References Isis::Stretch::Parse(), and stretch.

Referenced by stretchKnownGlobal(), and Isis::StretchTool::stretchRequested().

void Isis::CubeViewport::stretchGray

(

const Stretch &

stretch

)

[slot]

Sets the stretch for gray mode.

Parameters:

stretch

References Isis::CubeViewport::BandInfo::getStretch(), grayBand(), p_globalStretches, paintPixmap(), Isis::Stretch::Pairs(), and Isis::CubeViewport::BandInfo::setStretch().

void Isis::CubeViewport::stretchGray

(

const QString &

string

)

[slot]

Apply stretch pairs to gray band.

Parameters:

string

References Isis::Stretch::Parse(), and stretch.

Referenced by Isis::IndependentCubeViewport::cubeDataChanged(), Isis::IndependentCubeViewport::restretch(), stretchKnownGlobal(), Isis::StretchTool::stretchRequested(), and viewGray().

void Isis::CubeViewport::stretchGreen

(

const Stretch &

stretch

)

[slot]

Sets the stretch for green in rgb mode.

Parameters:

stretch

References Isis::CubeViewport::BandInfo::getStretch(), greenBand(), p_globalStretches, paintPixmap(), Isis::Stretch::Pairs(), and Isis::CubeViewport::BandInfo::setStretch().

void Isis::CubeViewport::stretchGreen

(

const QString &

string

)

[slot]

Apply stretch pairs to green bands.

Parameters:

stretch

References Isis::Stretch::Parse(), and stretch.

Referenced by stretchKnownGlobal(), and Isis::StretchTool::stretchRequested().

void Isis::CubeViewport::stretchKnownGlobal

(

)

[slot]

List<Tool *> p This stretches to the global stretch.

References blueBand(), grayBand(), greenBand(), isGray(), p_globalStretches, redBand(), stretchBlue(), stretchGray(), stretchGreen(), and stretchRed().

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

void Isis::CubeViewport::stretchRed

(

const Stretch &

stretch

)

[slot]

Sets the stretch for red in rgb mode.

Parameters:

stretch

References Isis::CubeViewport::BandInfo::getStretch(), p_globalStretches, paintPixmap(), Isis::Stretch::Pairs(), redBand(), and Isis::CubeViewport::BandInfo::setStretch().

void Isis::CubeViewport::stretchRed

(

const QString &

string

)

[slot]

Apply stretch pairs to red bands.

Parameters:

stretch

References Isis::Stretch::Parse(), and stretch.

Referenced by stretchKnownGlobal(), and Isis::StretchTool::stretchRequested().

UniversalGroundMap* Isis::CubeViewport::universalGroundMap

(

)

const [inline]

Return the universal ground map associated with the cube (NULL implies none).

Referenced by Isis::FindTool::mouseButtonRelease(), Isis::FindTool::paintViewport(), Isis::SpatialPlotTool::updateTool(), and Isis::FindTool::updateTool().

void Isis::CubeViewport::viewGray

(

int

band

)

[virtual, slot]

View cube as gray.

Parameters:

band

Reimplemented in Isis::MdiCubeViewport.

References Isis::ViewportBuffer::addStretchAction(), Isis::CubeViewport::BandInfo::band, Isis::ViewportBuffer::getBand(), Isis::CubeViewport::BandInfo::getStretch(), p_knownStretches, Isis::Camera::SetBand(), Isis::ViewportBuffer::setBand(), setCaption(), and stretchGray().

void Isis::CubeViewport::viewportClosed

(

CubeViewport *

)

[signal]

Emitted when viewport is closed.

void Isis::CubeViewport::viewportToCube	(	int	x,
		int	y,
		double &	sample,
		double &	line
	)			const

Convert a viewport x/y to a cube sample/line (may be outside the cube).

Parameters:

	x
	y
	sample
	line

References contentsToCube().

Referenced by center(), getCubeArea(), Isis::SunShadowTool::mouseButtonPress(), Isis::PanTool::mouseButtonRelease(), Isis::MatchTool::mouseButtonRelease(), Isis::FindTool::mouseButtonRelease(), Isis::EditTool::mouseButtonRelease(), Isis::SunShadowTool::mouseMove(), Isis::ScatterPlotWindow::paint(), Isis::HistogramTool::refreshPlot(), Isis::StereoTool::rubberBandComplete(), Isis::EditTool::rubberBandComplete(), Isis::ScatterPlotWindow::setMousePosition(), setScale(), and Isis::HistogramItem::setVertices().

void Isis::CubeViewport::viewportUpdated

(

)

[signal]

Emitted when viewport updated.

Referenced by Isis::MdiCubeViewport::paintEvent().

void Isis::CubeViewport::viewRGB	(	int	rband,
		int	gband,
		int	bband
	)			[virtual, slot]

View cube as color.

Parameters:

	rband
	gband
	bband

Reimplemented in Isis::MdiCubeViewport.

References Isis::ViewportBuffer::addStretchAction(), Isis::CubeViewport::BandInfo::band, Isis::ViewportBuffer::getBand(), Isis::CubeViewport::BandInfo::getStretch(), p_knownStretches, Isis::Camera::SetBand(), Isis::ViewportBuffer::setBand(), setCaption(), and Isis::CubeViewport::BandInfo::setStretch().

void Isis::CubeViewport::windowTitleChanged

(

)

[signal]

Emitted when window title changes.

Referenced by setCaption().

---

Member Data Documentation

QVector< Stretch * >* Isis::CubeViewport::p_globalStretches [protected]

Global stretches for each stretched band.

Referenced by CubeViewport(), Isis::IndependentCubeViewport::resetKnownGlobal(), stretchBlue(), stretchGray(), stretchGreen(), stretchKnownGlobal(), stretchRed(), and ~CubeViewport().

QVector< Stretch * >* Isis::CubeViewport::p_knownStretches [protected]

Stretches for each previously stretched band.

Referenced by CubeViewport(), forgetStretches(), setAllBandStretches(), viewGray(), viewRGB(), and ~CubeViewport().

QPixmap Isis::CubeViewport::p_pixmap [protected]

The qpixmap.

Referenced by Isis::MdiCubeViewport::paintEvent(), Isis::IndependentCubeViewport::paintEvent(), pixmap(), and resizeEvent().

---

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

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