Reads and stores visible DN values. More...

#include <ViewportBuffer.h>

Inheritance diagram for Isis::ViewportBuffer:

Collaboration diagram for Isis::ViewportBuffer:

Public Slots
void	DataReady (void requester, int cubeId, const Isis::Brick brick)
	This method is called when requested bricks become available. More...

Signals
void	ReadCube (int cubeId, int startSample, int startLine, int endSample, int endLine, int band, void *caller)
	Ask the cube data thread for data. More...

void	DoneWithData (int, const Isis::Brick *)
	Tell cube data thread we're done with a brick. More...

Public Member Functions
	ViewportBuffer (CubeViewport viewport, CubeDataThread cubeData, int cubeId)
	ViewportBuffer constructor. More...

virtual	~ViewportBuffer ()
	Updates total buffer size on destruction. More...

const std::vector< double > &	getLine (int line)
	Retrieves a line from the buffer. More...

void	resizedViewport ()
	Call this when the viewport is resized (not zoomed). More...

void	pan (int deltaX, int deltaY)
	Call this when the viewport is panned. More...

void	scaleChanged ()
	Call this when zoomed, re-reads visible area. More...

void	fillBuffer (QRect rect)
	This method will convert the rect to sample/line positions and read from the cube into the buffer. More...

void	fillBuffer (QRect rect, const Brick *data)
	This method will convert the rect to sample/line positions and read from the cube into the buffer. More...

void	emptyBuffer (bool force=false)
	This is meant to clear up ram on non-active viewports. More...

QRect	bufferXYRect ()
	Returns a rect, in screen pixels, of the area this buffer covers. More...

void	setBand (int band)
	Sets the band to read from, the buffer will be re-read if the band changes. More...

int	getBand ()
	Return the band associated with this viewport buffer. More...

void	enable (bool enabled)
	This turns on or off reading from the cube. More...

void	addStretchAction ()
	When all current operations finish the cube viewport will be asked to do a stretch if you call this. More...

double	currentProgress ()
	Returns the viewport buffer's loading progress. More...

double	totalUnfilledArea ()
	This returns the amount of area in the queue that needs new cube data/will be filled by fill actions. More...

bool	enabled ()
	Returns whether the buffer is enabled (reading data) or not. More...

bool	working ()
	This tests if queued actions exist in the viewport buffer. More...

bool	hasEntireCube ()
	Method to see if the entire cube is in the buffer. More...

Detailed Description

Reads and stores visible DN values.

This class manages visible pixels in a CubeViewport. This class is responsible for reading from the Cube only what is necessary and gives fast access to visible DNs.

Author: 2009-03-26 Steven Lambright and Noah Hilt

Constructor & Destructor Documentation

◆ ViewportBuffer()

Isis::ViewportBuffer::ViewportBuffer	(	CubeViewport *	viewport,
		CubeDataThread *	cubeData,
		int	cubeId
	)

ViewportBuffer constructor.

Viewport and Cube can not be null. Band is not initialized

Parameters

viewport	viewport that will use the buffer
cubeData	cube to read from
cubeId	The identifier for the cube in the data thread

◆ ~ViewportBuffer()

Isis::ViewportBuffer::~ViewportBuffer ( )

virtual

Updates total buffer size on destruction.

Member Function Documentation

◆ addStretchAction()

void Isis::ViewportBuffer::addStretchAction ( )

When all current operations finish the cube viewport will be asked to do a stretch if you call this.

Existing requests will be removed.

Referenced by Isis::IndependentCubeViewport::resetKnownGlobal(), Isis::CubeViewport::showEvent(), Isis::CubeViewport::viewGray(), and Isis::CubeViewport::viewRGB().

◆ bufferXYRect()

QRect Isis::ViewportBuffer::bufferXYRect ( )

Returns a rect, in screen pixels, of the area this buffer covers.

Author: slambright (4/30/2010)

Returns: QRect

Referenced by Isis::StretchTool::histFromBuffer(), Isis::ScatterPlotWindow::paint(), Isis::CubeViewport::scrollContentsBy(), and Isis::StretchTool::statsFromBuffer().

◆ currentProgress()

double Isis::ViewportBuffer::currentProgress ( )

Returns the viewport buffer's loading progress.

Returns: 0 to 1 where 1 is 100%

Referenced by Isis::CubeViewport::onProgressTimer().

◆ DataReady

void Isis::ViewportBuffer::DataReady	(	void *	requester,
		int	cubeId,
		const Isis::Brick *	brick
	)

slot

This method is called when requested bricks become available.

This processes the new cube data and requests more if necessary.

Parameters

requester
cubeId
brick

◆ DoneWithData

void Isis::ViewportBuffer::DoneWithData	(	int	,
		const Isis::Brick *
	)

signal

Tell cube data thread we're done with a brick.

◆ emptyBuffer()

void Isis::ViewportBuffer::emptyBuffer ( bool force = false )

This is meant to clear up ram on non-active viewports.

cubeViewport is supposed to call this method on viewports buffers that are not related to the active viewport.

Parameters

force If true, memory will be freed regardless of current total buffer size (b/w -> rgb for example).

◆ enable()

void Isis::ViewportBuffer::enable ( bool enabled )

This turns on or off reading from the cube.

If enabled is true the buffer will be re-read.

Parameters

enabled

Referenced by Isis::CubeViewport::setScale(), and Isis::CubeViewport::showEvent().

◆ enabled()

bool Isis::ViewportBuffer::enabled ( )

inline

Returns whether the buffer is enabled (reading data) or not.

Returns: bool

Referenced by Isis::CubeViewport::setScale(), and Isis::CubeViewport::showEvent().

◆ fillBuffer() [1/2]

void Isis::ViewportBuffer::fillBuffer ( QRect rect )

This method will convert the rect to sample/line positions and read from the cube into the buffer.

The rect is in viewport pixels.

Parameters

rect

References _FILEINFO_.

Referenced by Isis::CubeViewport::cubeContentsChanged(), and Isis::CubeViewport::cubeDataChanged().

◆ fillBuffer() [2/2]

void Isis::ViewportBuffer::fillBuffer	(	QRect	rect,
		const Brick *	data
	)

This method will convert the rect to sample/line positions and read from the cube into the buffer.

The rect is in viewport pixels.

Parameters

rect
data

References _FILEINFO_, Isis::Buffer::at(), Isis::ViewportBufferFill::getLeftmostPixelPosition(), Isis::ViewportBufferFill::getRequestPosition(), Isis::ViewportBufferFill::getTopmostPixelPosition(), Isis::ViewportBufferFill::incReadPosition(), Isis::ViewportBufferFill::incRequestPosition(), Isis::Buffer::Index(), Isis::Buffer::Line(), Isis::Buffer::LineDimension(), Isis::Buffer::Sample(), Isis::Buffer::SampleDimension(), Isis::ViewportBufferFill::shouldRequestMore(), Isis::Buffer::size(), Isis::ViewportBufferFill::viewportToLine(), and Isis::ViewportBufferFill::viewportToSample().

◆ getBand()

int Isis::ViewportBuffer::getBand ( )

inline

Return the band associated with this viewport buffer.

Referenced by Isis::CubeViewport::getAllWhatsThisInfo(), Isis::CubeViewport::viewGray(), and Isis::CubeViewport::viewRGB().

◆ getLine()

const vector< double > & Isis::ViewportBuffer::getLine ( int line )

Retrieves a line from the buffer.

Line is relative to the top of the visible area of the cube in the viewport.

Parameters

line

Returns: const vector<double> &

References _FILEINFO_.

Referenced by Isis::StretchTool::histFromBuffer(), Isis::ScatterPlotWindow::paint(), and Isis::StretchTool::statsFromBuffer().

◆ hasEntireCube()

bool Isis::ViewportBuffer::hasEntireCube ( )

Method to see if the entire cube is in the buffer.

Returns: bool

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

◆ pan()

void Isis::ViewportBuffer::pan	(	int	deltaX,
		int	deltaY
	)

Call this when the viewport is panned.

DeltaX and deltaY are relative to the direction the buffer needs to shift.

Parameters

deltaX
deltaY

References Isis::ViewportBufferTransform::resizeFirst(), round, Isis::ViewportBufferTransform::setResize(), and Isis::ViewportBufferTransform::setTranslation().

Referenced by Isis::CubeViewport::center(), and Isis::CubeViewport::scrollContentsBy().

◆ ReadCube

void Isis::ViewportBuffer::ReadCube	(	int	cubeId,
		int	startSample,
		int	startLine,
		int	endSample,
		int	endLine,
		int	band,
		void *	caller
	)

signal

Ask the cube data thread for data.

Parameters

cubeId
startSample
startLine
endSample
endLine
band
caller

◆ resizedViewport()

void Isis::ViewportBuffer::resizedViewport ( )

Call this when the viewport is resized (not zoomed).

References Isis::ViewportBufferTransform::resizeFirst(), round, Isis::ViewportBufferTransform::setResize(), and Isis::ViewportBufferTransform::setTranslation().

Referenced by Isis::CubeViewport::resizeEvent().

◆ scaleChanged()

void Isis::ViewportBuffer::scaleChanged ( )

Call this when zoomed, re-reads visible area.

Exceptions

iException - "Unable to change scale"

References _FILEINFO_.

Referenced by Isis::CubeViewport::setScale().

◆ setBand()

void Isis::ViewportBuffer::setBand ( int band )

Sets the band to read from, the buffer will be re-read if the band changes.

Parameters

band

Referenced by Isis::CubeViewport::viewGray(), and Isis::CubeViewport::viewRGB().

◆ totalUnfilledArea()

double Isis::ViewportBuffer::totalUnfilledArea ( )

This returns the amount of area in the queue that needs new cube data/will be filled by fill actions.

Returns: double

References Isis::ViewportBufferAction::getActionType(), Isis::ViewportBufferFill::getReadPosition(), and Isis::ViewportBufferFill::getRect().

◆ working()

bool Isis::ViewportBuffer::working ( )

This tests if queued actions exist in the viewport buffer.

Returns: bool

Referenced by Isis::CubeViewport::bufferUpdated(), Isis::CubeViewport::onProgressTimer(), Isis::ScatterPlotWindow::paint(), Isis::CubeViewport::scrollContentsBy(), Isis::StretchTool::setCubeViewport(), Isis::StretchTool::statsFromBuffer(), Isis::StretchTool::updateAdvStretchDialogforAll(), and Isis::StretchTool::updateHistograms().

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

/usgs/pkgs/isis3.9.0_docs/ISIS3/isis/src/qisis/objs/CubeViewport/ViewportBuffer.h
/usgs/pkgs/isis3.9.0_docs/ISIS3/isis/src/qisis/objs/CubeViewport/ViewportBuffer.cpp

Public Slots

Signals

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ViewportBuffer()

◆ ~ViewportBuffer()

Member Function Documentation

◆ addStretchAction()

◆ bufferXYRect()

◆ currentProgress()

◆ DataReady

◆ DoneWithData

◆ emptyBuffer()

◆ enable()

◆ enabled()

◆ fillBuffer() [1/2]

◆ fillBuffer() [2/2]

◆ getBand()

◆ getLine()

◆ hasEntireCube()

◆ pan()

◆ ReadCube

◆ resizedViewport()

◆ scaleChanged()

◆ setBand()

◆ totalUnfilledArea()

◆ working()