USGS

Isis 3.0 Object Programmers' Reference

Home

Isis::Portal Class Reference

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

#include <Portal.h>

Inheritance diagram for Isis::Portal:
Inheritance graph
Collaboration diagram for Isis::Portal:
Collaboration graph

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.
 
 ~Portal ()
 Destroys the Portal object.
 
void SetPosition (const double sample, const double line, const int band)
 Sets the line and sample position of the buffer.
 
void SetHotSpot (const double sample=-0.5, const double line=-0.5)
 Sets the line and sample offsets for the buffer.
 
int SampleDimension () const
 Returns the number of samples in the shape buffer.
 
int LineDimension () const
 Returns the number of lines in the shape buffer.
 
int BandDimension () const
 Returns the number of bands in the shape buffer.
 
int size () const
 Returns the total number of pixels in the shape buffer.
 
int Sample (const int index=0) const
 Returns the sample position associated with a shape buffer index.
 
int Line (const int index=0) const
 Returns the line position associated with a shape buffer index.
 
int Band (const int index=0) const
 Returns the band position associated with a shape buffer index.
 
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.
 
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.
 
double at (const int index) const
 Returns the value in the shape buffer at the given index.
 
double & operator[] (const int index)
 Returns the value in the shape buffer at given index.
 
const double & operator[] (const int index) const
 Returns the value in the shape buffer at given index.
 
double * DoubleBuffer () const
 Returns the value of the shape buffer.
 
void Copy (const Buffer &in, bool includeRawBuf=true)
 Allows copying of the buffer contents to another Buffer.
 
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.
 
void * RawBuffer () const
 Returns a void pointer to the raw buffer.
 
Isis::PixelType PixelType () const
 Returns the raw buffer pixel type.
 

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.
 
void SetBaseSample (const int start_samp)
 This method is used to set the base sample position of the shape buffer.
 
void SetBaseLine (const int start_line)
 This method is used to set the base line position of the shape buffer.
 
void SetBaseBand (const int start_band)
 This method is used to set the base band position of the shape buffer.
 
void Allocate ()
 Size or resize the memory buffer.
 

Protected Attributes

int p_sample
 Starting sample to read/write.
 
int p_nsamps
 Number of samples to read/write.
 
int p_line
 Starting line to read/write.
 
int p_nlines
 Number of lines to read/write.
 
int p_band
 Starting band to read/write.
 
int p_nbands
 Number of bands to read/write.
 
int p_npixels
 Number of pixels (nsamps * nlines * nbands)
 
double * p_buf
 
 Shape buffer allocated to the size of npixels for

handling reads/writes

 
const Isis::PixelType p_pixelType
 The pixel type of the raw buffer.
 
void * p_rawbuf
 The raw dm read from the disk.
 

Private Attributes

double p_hotSample
 
  The sample position within the buffer which is

the point of interest.

 
double p_hotLine
 
    The line position within the buffer which is the

point of interest.

 

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
History:

2003-05-16 Stuart Sides - Modified schema from astrogeology... isis.astrogeology...

2005-02-28 Elizabeth Ribelin - Modified file to support Doxygen documentation

Definition at line 52 of file Portal.h.

Constructor & Destructor Documentation

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
bufSampsThe number of samples in the portal.
bufLinesThe number of lines in the portal.
typeType of pixel in raw buffer
hotSampThe 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
hotLineThe 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

Definition at line 88 of file Portal.h.

References p_hotLine, and p_hotSample.

Isis::Portal::~Portal ( )
inline

Destroys the Portal object.

Definition at line 96 of file Portal.h.

Member Function Documentation

void Isis::Buffer::Allocate ( )
protectedinherited

Size or resize the memory buffer.

Exceptions
Isis::iException::System- Memory allocation failed

Definition at line 341 of file Buffer.cpp.

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

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

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

Parameters
indexIndex position in buffer. Out of bounds index is trapped.
Returns
double Buffer value at index
Exceptions
Isis::iException::Programmer- Array Subscript not in range

Definition at line 238 of file Buffer.cpp.

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::StatisticsTool::getStatistics(), Isis::CubeDataThreadTester::ReadBrick(), and Isis::CubeDataThreadTester::ReadWriteBrick().

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
indexShape buffer index to map to a band position. Defaults to 0.
Returns
int The absolute band number based on the buffer index.

Definition at line 172 of file Buffer.cpp.

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

Referenced by Isis::CubeIoHandler::bufferLessThan(), Isis::Buffer::CopyOverlapFrom(), Isis::CubeIoHandler::findIntersection(), Isis::ImageImporter::operator()(), Isis::Average::operator()(), Isis::ProcessByBrick::ProcessCubesFunctor< T >::operator()(), Isis::CubeDataThread::OverlapIndex(), Isis::Buffer::Position(), Isis::CubeIoHandler::read(), Isis::ProcessRubberSheet::StartProcess(), Isis::CubeIoHandler::synchronousWrite(), Isis::CubeIoHandler::writeIntoDouble(), and Isis::CubeIoHandler::writeIntoRaw().

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

Allows copying of the buffer contents to another Buffer.

Parameters
inThe Buffer to be copied.
Exceptions
Isis::iException::Programmer- Input and Output buffers are not the same size

Definition at line 259 of file Buffer.cpp.

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(), and Isis::FileTool::copy().

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
inThe Buffer to be copied.
Returns
The operation was successful (the buffers overlapped)

Definition at line 288 of file Buffer.cpp.

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

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_sampSample position.
i_lineLine position.
i_bandBand position.
Returns
int Index at the specified sample, line and band.
Exceptions
Isis::iException::Programmer- Array Subscript not in range

Definition at line 205 of file Buffer.cpp.

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(), Isis::ViewportBuffer::fillBuffer(), Isis::CubeIoHandler::writeIntoDouble(), and Isis::CubeIoHandler::writeIntoRaw().

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
indexShape buffer index to map to a line position. Defaults to 0
Returns
int The absolute line number based on the buffer index

Definition at line 156 of file Buffer.cpp.

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

Referenced by Isis::CubeIoHandler::bufferLessThan(), Isis::Buffer::CopyOverlapFrom(), Isis::CubeViewport::cubeDataChanged(), Isis::ViewportBuffer::DataReady(), Isis::ViewportBuffer::fillBuffer(), Isis::CubeIoHandler::findIntersection(), Isis::ImageImporter::operator()(), Isis::Nearest::operator()(), Isis::Average::operator()(), Isis::CubeDataThread::OverlapIndex(), Isis::Buffer::Position(), Isis::CubeIoHandler::read(), Isis::EditTool::redoEdit(), Isis::CubeIoHandler::synchronousWrite(), Isis::EditTool::undoEdit(), Isis::StreamExporter::writeGrayscale(), Isis::QtExporter::writeGrayscale(), Isis::StreamExporter::writeRgb(), Isis::QtExporter::writeRgb(), Isis::StreamExporter::writeRgba(), Isis::QtExporter::writeRgba(), and Isis::EditTool::writeToCube().

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

Returns the value in the shape buffer at given index.

Parameters
indexIndex position in buffer. No out of bounds index is checked
Returns
double&

Definition at line 133 of file Buffer.h.

References Isis::Buffer::p_buf.

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

Returns the value in the shape buffer at given index.

Parameters
indexIndex position in buffer. No out of bounds index is checked
Returns
double

Definition at line 144 of file Buffer.h.

References Isis::Buffer::p_buf.

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

Returns the raw buffer pixel type.

Returns
Isis::PixelType

Definition at line 175 of file Buffer.h.

References Isis::Buffer::p_pixelType.

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

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
indexShape buffer index to map to a band position.
i_sampSample position in shape buffer at index.
i_lineLine position in shape buffer at index
i_bandBand position in shape buffer at index.

Definition at line 186 of file Buffer.cpp.

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

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

Definition at line 166 of file Buffer.h.

References Isis::Buffer::p_rawbuf.

Referenced by Isis::CubeIoHandler::writeIntoDouble().

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
indexShape buffer index to map to a sample position. Defaults to 0.
Returns
int The absolute sample number based on the buffer index.

Definition at line 139 of file Buffer.cpp.

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

Referenced by Isis::CubeIoHandler::bufferLessThan(), Isis::Buffer::CopyOverlapFrom(), Isis::CubeViewport::cubeDataChanged(), Isis::ViewportBuffer::DataReady(), Isis::ViewportBuffer::fillBuffer(), Isis::CubeIoHandler::findIntersection(), Isis::CubeDataThread::OverlapIndex(), Isis::Buffer::Position(), Isis::CubeIoHandler::read(), Isis::EditTool::redoEdit(), Isis::CubeIoHandler::synchronousWrite(), Isis::EditTool::undoEdit(), and Isis::EditTool::writeToCube().

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_bandStarting band to set

Definition at line 208 of file Buffer.h.

References Isis::Buffer::p_band.

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

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_lineStarting line to set

Definition at line 198 of file Buffer.h.

References Isis::Buffer::p_line.

Referenced by Isis::Brick::SetBaseLine(), and Isis::Buffer::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_sampleStarting sample to set.
start_lineStarting line to set.
start_bandStarting band to set.

Definition at line 118 of file Buffer.cpp.

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

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

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_sampStarting sample to set

Definition at line 188 of file Buffer.h.

References Isis::Buffer::p_sample.

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

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
sampleThe 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
lineThe 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

Definition at line 128 of file Portal.h.

References p_hotLine, and p_hotSample.

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
sampleThe sample position of the buffer.
lineThe line position of the buffer.
bandThe band position of the buffer.

Definition at line 109 of file Portal.h.

References p_hotLine, p_hotSample, and Isis::Buffer::SetBasePosition().

Referenced by Isis::ProcessMosaic::BandComparison(), Isis::ProcessMosaic::BandPriorityWithNoTracking(), Isis::QnetTool::demRadius(), Isis::InterestOperator::InterestByMeasure(), Isis::DemShape::localRadius(), Isis::ProcessMosaic::ResetCountBands(), Isis::ProcessMosaic::ResetOriginBand(), Isis::FileTool::saveAs_FullResolution(), Isis::ProcessMosaic::StartProcess(), and Isis::AdvancedTrackTool::TrackMosaicOrigin().

Member Data Documentation

int Isis::Buffer::p_band
protectedinherited

Starting band to read/write.

Definition at line 219 of file Buffer.h.

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

double* Isis::Buffer::p_buf
protectedinherited

 Shape buffer allocated to the size of npixels for

handling reads/writes

Definition at line 223 of file Buffer.h.

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

double Isis::Portal::p_hotLine
private

    The line position within the buffer which is the

point of interest.

This position is zero based and has no default.

Definition at line 58 of file Portal.h.

Referenced by Portal(), SetHotSpot(), and SetPosition().

double Isis::Portal::p_hotSample
private

  The sample position within the buffer which is

the point of interest.

This position is zero based and has no default.

Definition at line 55 of file Portal.h.

Referenced by Portal(), SetHotSpot(), and SetPosition().

int Isis::Buffer::p_line
protectedinherited

Starting line to read/write.

Definition at line 216 of file Buffer.h.

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

int Isis::Buffer::p_nbands
protectedinherited

Number of bands to read/write.

Definition at line 220 of file Buffer.h.

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

int Isis::Buffer::p_nlines
protectedinherited
int Isis::Buffer::p_npixels
protectedinherited
int Isis::Buffer::p_nsamps
protectedinherited
const Isis::PixelType Isis::Buffer::p_pixelType
protectedinherited

The pixel type of the raw buffer.

Definition at line 226 of file Buffer.h.

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

void* Isis::Buffer::p_rawbuf
protectedinherited

The raw dm read from the disk.

Definition at line 227 of file Buffer.h.

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

int Isis::Buffer::p_sample
protectedinherited

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