Buffer for containing a two dimensional section of an image. More...

#include <Portal.h>

Inheritance diagram for Isis::Portal:

Collaboration diagram for Isis::Portal:

Public Member Functions
	Portal (const int bufSamps, const int bufLines, const Isis::PixelType type, const double hotSamp=-0.5, const double hotLine=-0.5)
	Constructs a Portal object. More...

	~Portal ()
	Destroys the Portal object. More...

void	SetPosition (const double sample, const double line, const int band)
	Sets the line and sample position of the buffer. More...

void	SetHotSpot (const double sample=-0.5, const double line=-0.5)
	Sets the line and sample offsets for the buffer. More...

int	SampleDimension () const
	Returns the number of samples in the shape buffer. More...

int	LineDimension () const
	Returns the number of lines in the shape buffer. More...

int	BandDimension () const
	Returns the number of bands in the shape buffer. More...

int	size () const
	Returns the total number of pixels in the shape buffer. More...

int	Sample (const int index=0) const
	Returns the sample position associated with a shape buffer index. More...

int	Line (const int index=0) const
	Returns the line position associated with a shape buffer index. More...

int	Band (const int index=0) const
	Returns the band position associated with a shape buffer index. More...

void	Position (const int index, int &i_samp, int &i_line, int &i_band) const
	Returns the sample, line, and band position associated with a shape buffer index. More...

int	Index (const int i_samp, const int i_line, const int i_band) const
	Given a sample, line, and band position, this returns the appropriate index in the shape buffer. More...

double	at (const int index) const
	Returns the value in the shape buffer at the given index. More...

double &	operator[] (const int index)
	Returns the value in the shape buffer at given index. More...

const double &	operator[] (const int index) const
	Returns the value in the shape buffer at given index. More...

double *	DoubleBuffer () const
	Returns the value of the shape buffer. More...

void	Copy (const Buffer &in, bool includeRawBuf=true)
	Allows copying of the buffer contents to another Buffer. More...

bool	CopyOverlapFrom (const Buffer &in)
	Allows copying of the buffer contents of a larger buffer to another same size or smaller Buffer, using their base positions to relate data. More...

void *	RawBuffer () const
	Returns a void pointer to the raw buffer. More...

Isis::PixelType	PixelType () const
	Returns the raw buffer pixel type. More...

Protected Member Functions
void	SetBasePosition (const int start_sample, const int start_line, const int start_band)
	This method is used to set the base position of the shape buffer. More...

void	SetBaseSample (const int start_samp)
	This method is used to set the base sample position of the shape buffer. More...

void	SetBaseLine (const int start_line)
	This method is used to set the base line position of the shape buffer. More...

void	SetBaseBand (const int start_band)
	This method is used to set the base band position of the shape buffer. More...

void	Allocate ()
	Size or resize the memory buffer. More...

Protected Attributes
int	p_sample
	Starting sample to read/write. More...

int	p_nsamps
	Number of samples to read/write. More...

int	p_line
	Starting line to read/write. More...

int	p_nlines
	Number of lines to read/write. More...

int	p_band
	Starting band to read/write. More...

int	p_nbands
	Number of bands to read/write. More...

int	p_npixels
	Number of pixels (nsamps * nlines * nbands) More...

double *	p_buf
	Shape buffer allocated to the size of npixels for handling reads/writes. More...

const Isis::PixelType	p_pixelType
	The pixel type of the raw buffer. More...

void *	p_rawbuf
	The raw dm read from the disk. More...

Detailed Description

Buffer for containing a two dimensional section of an image.

This class is a Buffer. The shape of the buffer is two dimensional in the line and sample directions only. The band dimension is always one. This class provides a random access window into a cube. The position can be set to any line, sample and band, including outside the image.

If you would like to see Portal being used in implementation, see the ProcessRubberSheet class

Author: 2002-10-09 Stuart Sides

Constructor & Destructor Documentation

◆ Portal()

Isis::Portal::Portal	(	const int	bufSamps,
		const int	bufLines,
		const Isis::PixelType	type,
		const double	hotSamp = `-0.5`,
		const double	hotLine = `-0.5`
	)

inline

Constructs a Portal object.

The hotspot defaults of (-0.5,-0.5) cause the nearest neighbor to the requested pixel to be returned in the top left corner of the portal buffer

Parameters

bufSamps	The number of samples in the portal.
bufLines	The number of lines in the portal.
type	Type of pixel in raw buffer
hotSamp	The point of interest within the buffer in the sample direction. When a buffer is being setup, the hotSamp will be subtracted from the point of interest to give a buffer of the requested size around the hot spot. This number is zero based. Defaults to 0.5
hotLine	The point of interest within the buffer in the line direction. When a buffer is being setup, the hotLine will be subtracted from the point of interest to give a buffer of the requested size around the hot spot. This number is zero based. Defaults to 0.5

◆ ~Portal()

Isis::Portal::~Portal ( )

inline

Destroys the Portal object.

Member Function Documentation

◆ Allocate()

void Isis::Buffer::Allocate ( )

protectedinherited

Size or resize the memory buffer.

Exceptions

Isis::iException::System - Memory allocation failed

References _FILEINFO_, Isis::Message::MemoryAllocationFailed(), Isis::Buffer::p_buf, Isis::Buffer::p_npixels, Isis::Buffer::p_pixelType, Isis::Buffer::p_rawbuf, Isis::SizeOf(), and Isis::IException::Unknown.

Referenced by Isis::Buffer::Buffer(), and Isis::Brick::Resize().

◆ at()

double Isis::Buffer::at ( const int index ) const

inherited

Returns the value in the shape buffer at the given index.

Parameters

index Index position in buffer. Out of bounds index is trapped.

Returns: double Buffer value at index

Exceptions

Isis::iException::Programmer - Array Subscript not in range

References _FILEINFO_, Isis::Message::ArraySubscriptNotInRange(), Isis::Buffer::p_buf, Isis::Buffer::p_npixels, and Isis::IException::Programmer.

Referenced by Isis::CubeDataThreadTester::BrickChanged(), Isis::ViewportBuffer::DataReady(), Isis::ViewportBuffer::fillBuffer(), Isis::CubeDataThreadTester::ReadBrick(), and Isis::CubeDataThreadTester::ReadWriteBrick().

◆ Band()

int Isis::Buffer::Band ( const int index = 0 ) const

inherited

Returns the band position associated with a shape buffer index.

The shape buffer is one dimensional. Let us assume a nsamps=2, nlines=3, and nbands=2. Therefore the total size of the shape buffer is 12 and valid index values are 0-11. Indexes 0-5 will return band 1 and 6-11 will return band 2.

Parameters

index Shape buffer index to map to a band position. Defaults to 0.

Returns: int The absolute band number based on the buffer index.

References Isis::Buffer::p_band, Isis::Buffer::p_nlines, and Isis::Buffer::p_nsamps.

Referenced by Isis::Buffer::CopyOverlapFrom(), Isis::IndependentCubeViewport::cubeDataChanged(), Isis::ImageImporter::operator()(), Isis::SpectralDefinition2D::operator()(), Isis::Average::operator()(), Isis::Equalization::ApplyFunctor::operator()(), Isis::Buffer::Position(), Isis::CubeIoHandler::read(), and Isis::ProcessRubberSheet::StartProcess().

◆ BandDimension()

int Isis::Buffer::BandDimension ( ) const

inlineinherited

Returns the number of bands in the shape buffer.

Returns: int

References Isis::Buffer::p_nbands.

Referenced by Isis::IndependentCubeViewport::cubeDataChanged(), Isis::CubeIoHandler::read(), Isis::RegionalCachingAlgorithm::recommendChunksToFree(), and Isis::Hillshade::shadedValue().

◆ Copy()

void Isis::Buffer::Copy	(	const Buffer &	in,
		bool	includeRawBuf = `true`
	)

inherited

Allows copying of the buffer contents to another Buffer.

Parameters

in	The Buffer to be copied.
includeRawBuf	Whether to include raw dm read from disk

Exceptions

Isis::iException::Programmer	- Input and Output buffers are not the same size
Isis::iException::Programmer	- Input and Output buffers do not use the same pixel type

References _FILEINFO_, Isis::Buffer::p_buf, Isis::Buffer::p_npixels, Isis::Buffer::p_pixelType, Isis::Buffer::p_rawbuf, Isis::Buffer::PixelType(), Isis::IException::Programmer, Isis::Buffer::size(), and Isis::SizeOf().

Referenced by Isis::Buffer::Buffer().

◆ CopyOverlapFrom()

bool Isis::Buffer::CopyOverlapFrom ( const Buffer & in )

inherited

Allows copying of the buffer contents of a larger buffer to another same size or smaller Buffer, using their base positions to relate data.

This does not copy the raw buffer.

Parameters

in	The Buffer to be copied.

Returns: The operation was successful (the buffers overlapped)

References Isis::Buffer::Band(), Isis::Buffer::Index(), Isis::Buffer::Line(), Isis::Buffer::p_band, Isis::Buffer::p_line, Isis::Buffer::p_nbands, Isis::Buffer::p_nlines, Isis::Buffer::p_npixels, Isis::Buffer::p_nsamps, Isis::Buffer::p_sample, Isis::Buffer::Sample(), and Isis::Buffer::size().

◆ DoubleBuffer()

double* Isis::Buffer::DoubleBuffer ( ) const

inlineinherited

Returns the value of the shape buffer.

Returns: double* The shape buffer

References Isis::Buffer::p_buf.

Referenced by Isis::Process::CalculateStatistics(), Isis::IndependentCubeViewport::cubeDataChanged(), Isis::Cube::histogram(), Isis::DemShape::localRadius(), Isis::HistogramTool::refreshPlot(), Isis::ProcessByQuickFilter::StartProcess(), and Isis::Cube::statistics().

◆ Index()

int Isis::Buffer::Index	(	const int	i_samp,
		const int	i_line,
		const int	i_band
	)		const

inherited

Given a sample, line, and band position, this returns the appropriate index in the shape buffer.

Parameters

i_samp	Sample position.
i_line	Line position.
i_band	Band position.

Returns: int Index at the specified sample, line and band.

Exceptions

Isis::iException::Programmer - Array Subscript not in range

References _FILEINFO_, Isis::Message::ArraySubscriptNotInRange(), Isis::Buffer::p_band, Isis::Buffer::p_line, Isis::Buffer::p_nbands, Isis::Buffer::p_nlines, Isis::Buffer::p_nsamps, Isis::Buffer::p_sample, and Isis::IException::Programmer.

Referenced by Isis::Buffer::CopyOverlapFrom(), and Isis::ViewportBuffer::fillBuffer().

◆ Line()

int Isis::Buffer::Line ( const int index = 0 ) const

inherited

Returns the line position associated with a shape buffer index.

The shape buffer is one dimensional. Let us assume a nsamps=2, nlines=3, and nbands=2. Therefore the total size of the shape buffer is 12 and valid index values are 0-11. Line(0), Line(1), Line(6) and Line(7), will return a 1, Line(2), Line(3), Line(8) and Line(9) will return a 2, and Line(4), Line(5), Line(10), and Line(11) will return a 3.

Parameters

index Shape buffer index to map to a line position. Defaults to 0

Returns: int The absolute line number based on the buffer index

References Isis::Buffer::p_line, Isis::Buffer::p_nlines, and Isis::Buffer::p_nsamps.

Referenced by Isis::Buffer::CopyOverlapFrom(), Isis::IndependentCubeViewport::cubeDataChanged(), Isis::CubeViewport::cubeDataChanged(), Isis::ViewportBuffer::DataReady(), Isis::ViewportBuffer::fillBuffer(), Isis::ImageImporter::operator()(), Isis::Nearest::operator()(), Isis::Average::operator()(), Isis::Equalization::CalculateFunctor::operator()(), Isis::Buffer::Position(), Isis::CubeIoHandler::read(), Isis::StreamExporter::writeGrayscale(), Isis::QtExporter::writeGrayscale(), Isis::StreamExporter::writeRgb(), Isis::QtExporter::writeRgb(), Isis::StreamExporter::writeRgba(), and Isis::QtExporter::writeRgba().

◆ LineDimension()

int Isis::Buffer::LineDimension ( ) const

inlineinherited

Returns the number of lines in the shape buffer.

Returns: int

References Isis::Buffer::p_nlines.

Referenced by Isis::IndependentCubeViewport::cubeDataChanged(), Isis::CubeViewport::cubeDataChanged(), Isis::ViewportBuffer::fillBuffer(), Isis::Equalization::CalculateFunctor::operator()(), Isis::CubeIoHandler::read(), Isis::RegionalCachingAlgorithm::recommendChunksToFree(), and Isis::Hillshade::shadedValue().

◆ operator[]() [1/2]

double& Isis::Buffer::operator[] ( const int index )

inlineinherited

Returns the value in the shape buffer at given index.

Parameters

index Index position in buffer. No out of bounds index is checked

Returns: double&

References Isis::Buffer::p_buf.

◆ operator[]() [2/2]

const double& Isis::Buffer::operator[] ( const int index ) const

inlineinherited

Returns the value in the shape buffer at given index.

Parameters

index Index position in buffer. No out of bounds index is checked

Returns: double

References Isis::Buffer::p_buf.

◆ PixelType()

Isis::PixelType Isis::Buffer::PixelType ( ) const

inlineinherited

Returns the raw buffer pixel type.

Returns: Isis::PixelType

References Isis::Buffer::p_pixelType.

Referenced by Isis::Buffer::Copy().

◆ Position()

void Isis::Buffer::Position	(	const int	index,
		int &	i_samp,
		int &	i_line,
		int &	i_band
	)		const

inherited

Returns the sample, line, and band position associated with a shape buffer index.

Performs the same function as the Sample, Line, and Band methods.

Parameters

index	Shape buffer index to map to a band position.
i_samp	Sample position in shape buffer at index.
i_line	Line position in shape buffer at index
i_band	Band position in shape buffer at index.

References Isis::Buffer::Band(), Isis::Buffer::Line(), and Isis::Buffer::Sample().

◆ RawBuffer()

void* Isis::Buffer::RawBuffer ( ) const

inlineinherited

Returns a void pointer to the raw buffer.

Cast this void pointer using information from the PixelType() method

Returns: void* Pointer to the raw buffer

References Isis::Buffer::p_rawbuf.

◆ Sample()

int Isis::Buffer::Sample ( const int index = 0 ) const

inherited

Returns the sample position associated with a shape buffer index.

The shape buffer is one dimensional. Let us assume a nsamps=2, nlines=3, and nbands=2. Therefore the total size of the shape buffer is 12 and valid index values are 0-11. Sample(0), Sample(2), Sample(4), etc will return a 1 while Sample(1), Sample(3), Sample(5), etc will return a 2.

Parameters

index Shape buffer index to map to a sample position. Defaults to 0.

Returns: int The absolute sample number based on the buffer index.

References Isis::Buffer::p_nsamps, and Isis::Buffer::p_sample.

Referenced by Isis::Buffer::CopyOverlapFrom(), Isis::IndependentCubeViewport::cubeDataChanged(), Isis::CubeViewport::cubeDataChanged(), Isis::ViewportBuffer::DataReady(), Isis::ViewportBuffer::fillBuffer(), Isis::SpectralDefinition2D::operator()(), Isis::Buffer::Position(), and Isis::CubeIoHandler::read().

◆ SampleDimension()

int Isis::Buffer::SampleDimension ( ) const

inlineinherited

Returns the number of samples in the shape buffer.

Returns: int

References Isis::Buffer::p_nsamps.

Referenced by Isis::IndependentCubeViewport::cubeDataChanged(), Isis::CubeViewport::cubeDataChanged(), Isis::ViewportBuffer::fillBuffer(), Isis::ImageImporter::operator()(), Isis::CubeIoHandler::read(), Isis::RegionalCachingAlgorithm::recommendChunksToFree(), Isis::Hillshade::shadedValue(), Isis::StreamExporter::writeGrayscale(), Isis::QtExporter::writeGrayscale(), Isis::StreamExporter::writeRgb(), Isis::QtExporter::writeRgb(), Isis::StreamExporter::writeRgba(), and Isis::QtExporter::writeRgba().

◆ SetBaseBand()

void Isis::Buffer::SetBaseBand ( const int start_band )

inlineprotectedinherited

This method is used to set the base band position of the shape buffer.

Parameters

start_band Starting band to set

References Isis::Buffer::p_band.

Referenced by Isis::Brick::SetBaseBand(), and Isis::Buffer::SetBasePosition().

◆ SetBaseLine()

void Isis::Buffer::SetBaseLine ( const int start_line )

inlineprotectedinherited

This method is used to set the base line position of the shape buffer.

Parameters

start_line Starting line to set

References Isis::Buffer::p_line.

Referenced by Isis::Brick::SetBaseLine(), and Isis::Buffer::SetBasePosition().

◆ SetBasePosition()

void Isis::Buffer::SetBasePosition	(	const int	start_sample,
		const int	start_line,
		const int	start_band
	)

protectedinherited

This method is used to set the base position of the shape buffer.

In general it is used by BufferManager objects to progress sequentially through a cube by line, tile, boxcar, etc.

Parameters

start_sample	Starting sample to set.
start_line	Starting line to set.
start_band	Starting band to set.

References Isis::Buffer::SetBaseBand(), Isis::Buffer::SetBaseLine(), and Isis::Buffer::SetBaseSample().

Referenced by Isis::Brick::SetBasePosition(), Isis::BufferManager::setpos(), and SetPosition().

◆ SetBaseSample()

void Isis::Buffer::SetBaseSample ( const int start_samp )

inlineprotectedinherited

This method is used to set the base sample position of the shape buffer.

Parameters

start_samp Starting sample to set

References Isis::Buffer::p_sample.

Referenced by Isis::Buffer::SetBasePosition(), and Isis::Brick::SetBaseSample().

◆ SetHotSpot()

void Isis::Portal::SetHotSpot	(	const double	sample = `-0.5`,
		const double	line = `-0.5`
	)

inline

Sets the line and sample offsets for the buffer.

The defaults of (-0.5,-0.5) cause the nearest neighbor to the requested pixel to be returned in the top left corner of the portal buffer

Parameters

sample	The sample offset for the buffer. A zero for this parameter will cause the buffer to be alligned with the hot spot at the left edge of the buffer. Defaults to 0.5
line	The line offset for the buffer. A zero for this parameter will cause the buffer to be alligned with the hot spot at the top edge of the buffer. Defaults to 0.5

◆ SetPosition()

void Isis::Portal::SetPosition	(	const double	sample,
		const double	line,
		const int	band
	)

inline

Sets the line and sample position of the buffer.

The hotspot location is subtracted from this position to set the upper left corner of the buffer.

Parameters

sample	The sample position of the buffer.
line	The line position of the buffer.
band	The band position of the buffer.

References Isis::Buffer::SetBasePosition().

Referenced by Isis::InterestOperator::InterestByMeasure(), Isis::DemShape::localRadius(), Isis::ProcessMosaic::StartProcess(), and Isis::ControlNetValidMeasure::ValidStandardOptions().

◆ size()

int Isis::Buffer::size ( ) const

inlineinherited

Returns the total number of pixels in the shape buffer.

Returns: int

References Isis::Buffer::p_npixels.

Referenced by Isis::HiEqualization::HiCalculateFunctor::addStats(), Isis::Equalization::CalculateFunctor::addStats(), Isis::CubeDataThreadTester::BrickChanged(), Isis::Process::CalculateStatistics(), Isis::Buffer::Copy(), Isis::Buffer::CopyOverlapFrom(), Isis::IndependentCubeViewport::cubeDataChanged(), Isis::ViewportBuffer::DataReady(), Isis::ViewportBuffer::fillBuffer(), Isis::Cube::histogram(), Isis::Average::operator()(), Isis::Equalization::ApplyFunctor::operator()(), Isis::Calculator::Push(), Isis::CubeIoHandler::read(), Isis::CubeDataThreadTester::ReadBrick(), Isis::CubeDataThreadTester::ReadWriteBrick(), Isis::Hillshade::shadedValue(), Isis::ProcessByBoxcar::StartProcess(), Isis::ProcessExport::StartProcess(), Isis::ProcessMosaic::StartProcess(), and Isis::Cube::statistics().

Member Data Documentation

◆ p_band

int Isis::Buffer::p_band

protectedinherited

Starting band to read/write.

Referenced by Isis::Buffer::Band(), Isis::Buffer::Buffer(), Isis::Buffer::CopyOverlapFrom(), Isis::Buffer::Index(), and Isis::Buffer::SetBaseBand().

◆ p_buf

double* Isis::Buffer::p_buf

protectedinherited

Shape buffer allocated to the size of npixels for handling reads/writes.

Referenced by Isis::Buffer::Allocate(), Isis::Buffer::at(), Isis::Buffer::Copy(), Isis::Buffer::DoubleBuffer(), Isis::Buffer::operator=(), Isis::Buffer::operator[](), Isis::Brick::Resize(), and Isis::Buffer::~Buffer().

◆ p_line

int Isis::Buffer::p_line

protectedinherited

Starting line to read/write.

Referenced by Isis::Buffer::Buffer(), Isis::Buffer::CopyOverlapFrom(), Isis::Buffer::Index(), Isis::Buffer::Line(), and Isis::Buffer::SetBaseLine().

◆ p_nbands

int Isis::Buffer::p_nbands

protectedinherited

Number of bands to read/write.

Referenced by Isis::Buffer::BandDimension(), Isis::Buffer::Buffer(), Isis::Buffer::CopyOverlapFrom(), Isis::Buffer::Index(), and Isis::Brick::Resize().

◆ p_nlines

int Isis::Buffer::p_nlines

protectedinherited

Number of lines to read/write.

Referenced by Isis::Buffer::Band(), Isis::Buffer::Buffer(), Isis::Buffer::CopyOverlapFrom(), Isis::Buffer::Index(), Isis::Buffer::Line(), Isis::Buffer::LineDimension(), and Isis::Brick::Resize().

◆ p_npixels

int Isis::Buffer::p_npixels

protectedinherited

Number of pixels (nsamps * nlines * nbands)

Referenced by Isis::Buffer::Allocate(), Isis::Buffer::at(), Isis::Buffer::Buffer(), Isis::Buffer::Copy(), Isis::Buffer::CopyOverlapFrom(), Isis::Buffer::operator=(), Isis::Brick::Resize(), and Isis::Buffer::size().

◆ p_nsamps

int Isis::Buffer::p_nsamps

protectedinherited

Number of samples to read/write.

Referenced by Isis::Buffer::Band(), Isis::Buffer::Buffer(), Isis::Buffer::CopyOverlapFrom(), Isis::Buffer::Index(), Isis::Buffer::Line(), Isis::Brick::Resize(), Isis::Buffer::Sample(), and Isis::Buffer::SampleDimension().

◆ p_pixelType

const Isis::PixelType Isis::Buffer::p_pixelType

protectedinherited

The pixel type of the raw buffer.

Referenced by Isis::Buffer::Allocate(), Isis::Buffer::Copy(), and Isis::Buffer::PixelType().

◆ p_rawbuf

void* Isis::Buffer::p_rawbuf

protectedinherited

The raw dm read from the disk.

Referenced by Isis::Buffer::Allocate(), Isis::Buffer::Copy(), Isis::Buffer::RawBuffer(), Isis::Brick::Resize(), and Isis::Buffer::~Buffer().

◆ p_sample

int Isis::Buffer::p_sample

protectedinherited

Starting sample to read/write.

Referenced by Isis::Buffer::Buffer(), Isis::Buffer::CopyOverlapFrom(), Isis::Buffer::Index(), Isis::Buffer::Sample(), and Isis::Buffer::SetBaseSample().

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

/usgs/pkgs/isis3.9.0_docs/ISIS3/isis/src/base/objs/Portal/Portal.h

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Portal()

◆ ~Portal()

Member Function Documentation

◆ Allocate()

◆ at()

◆ Band()

◆ BandDimension()

◆ Copy()

◆ CopyOverlapFrom()

◆ DoubleBuffer()

◆ Index()

◆ Line()

◆ LineDimension()

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ PixelType()

◆ Position()

◆ RawBuffer()

◆ Sample()

◆ SampleDimension()

◆ SetBaseBand()

◆ SetBaseLine()

◆ SetBasePosition()

◆ SetBaseSample()

◆ SetHotSpot()

◆ SetPosition()

◆ size()

Member Data Documentation

◆ p_band

◆ p_buf

◆ p_line

◆ p_nbands

◆ p_nlines

◆ p_npixels

◆ p_nsamps

◆ p_pixelType

◆ p_rawbuf

◆ p_sample