Isis 3 Programmer Reference
Isis::Brick Class Reference

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

#include <Brick.h>

Inheritance diagram for Isis::Brick:
Inheritance graph
Collaboration diagram for Isis::Brick:
Collaboration graph

Public Member Functions

 Brick (const int nsamps, const int nlines, const int nbands, const Isis::PixelType type, bool reverse=false)
 Constructs a Brick object. More...
 
 Brick (const Isis::Cube &cube, const int &bufNumSamples, const int &bufNumLines, const int &bufNumBands, bool reverse=false)
 Constructs a Brick object. More...
 
 Brick (int maxSamples, int maxLines, int maxBands, int bufNumSamples, int bufNumLines, int bufNumBands, Isis::PixelType type, bool reverse=false)
 Constructs a Brick object of the specified buffer size and area size to map. More...
 
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 Resize (const int nsamps, const int nlines, const int nbands)
 Resizes the memory buffer to the specified number of samples, lines, and bands. More...
 
bool SetBrick (const int brick)
 This method is used to set the position of the brick. More...
 
int Bricks ()
 Returns the number of Bricks in the cube. More...
 
bool operator++ (int)
 Moves the shape buffer to the next position. More...
 
BufferManageroperator+= (int i)
 Moves the shape buffer by a certain amount. More...
 
bool begin ()
 Moves the shape buffer to the first position. More...
 
bool next ()
 Moves the shape buffer to the next position. More...
 
bool end () const
 Returns true if the shape buffer has accessed the end of the cube. More...
 
bool setpos (BigInt map)
 Sets the position of the shape in the cube. More...
 
void swap (BufferManager &other)
 Swaps the values of this BufferManager with that of another. 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

int MaxSamples () const
 Returns the number of samples in the cube. More...
 
int MaxLines () const
 Returns the number of lines in the cube. More...
 
int MaxBands () const
 Returns the number of bands in the cube. More...
 
BigInt MaxMaps () const
 Returns the maximum number of positions the shape buffer needs to cover the entire image (see setpos method for more info). More...
 
void SetIncrements (const int sinc, const int linc, const int binc)
 Sets how the shape is incremented through the cube. More...
 
void SetOffsets (const int soff, const int loff, const int boff)
 Sets the offset of the 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 three dimensional section of an image.

This class is a Buffer. The shape of the buffer is three dimensional in the line, sample, and band directions. 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.

Author
2005-01-18 Jeff Anderson
History:

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

2006-04-21 Jacob Danton - Modified Brick to extend BufferManager, added new constructor, and two methods, SetBrick and Bricks

2011-11-23 Jai Rideout - Added a new constructor that allows one to specify the shape buffer size as well as the size of the area to be mapped. This is useful for classes such as ProcessByBrick that need to specify an area to be traversed that is bigger than the cube itself.

2017-08-30 Summer Stapleton - Updated documentation. References #4807.

Todo:
2005-02-28 Jeff Anderson - add coded and implementation examples to class documentation

Definition at line 61 of file Brick.h.

Constructor & Destructor Documentation

◆ Brick() [1/3]

Isis::Brick::Brick ( const int  nsamps,
const int  nlines,
const int  nbands,
const Isis::PixelType  type,
bool  reverse = false 
)
inline

Constructs a Brick object.

Parameters
nsampsNumber of samples in shape buffer
nlinesNumber of lines in shape buffer
nbandsNumber of bands in shape buffer
typeType of pixel in raw buffer
reverseModifies the order of progression this buffer takes through the cube. By default, progresses samples first, then lines, then bands. If reverse = true, then the buffer progresses bands first, then lines, then samples.

Definition at line 76 of file Brick.h.

◆ Brick() [2/3]

Isis::Brick::Brick ( const Isis::Cube cube,
const int &  bufNumSamples,
const int &  bufNumLines,
const int &  bufNumBands,
bool  reverse = false 
)
inline

Constructs a Brick object.

Parameters
&cubeReference to the cube to calculate a Brick from
&bufNumSamplesReference to the number of samples in shape buffer
&bufNumLinesReference to the number of lines in shape buffer
&bufNumBandsReference to the number of bands in shape buffer
reverseModifies the order of progression this buffer takes through the cube. By default, progresses samples first, then lines, then bands. If reverse = true, then the buffer progresses bands first, then lines, then samples.

Definition at line 95 of file Brick.h.

◆ Brick() [3/3]

Isis::Brick::Brick ( int  maxSamples,
int  maxLines,
int  maxBands,
int  bufNumSamples,
int  bufNumLines,
int  bufNumBands,
Isis::PixelType  type,
bool  reverse = false 
)
inline

Constructs a Brick object of the specified buffer size and area size to map.

Parameters
maxSamplesMaximum number of samples to map
maxLinesMaximum number of lines to map
maxBandsMaximum number of bands to map
bufNumSamplesNumber of samples in shape buffer
bufNumLinesNumber of lines in shape buffer
bufNumBandsNumber of bands in shape buffer
typeType of pixel in raw buffer
reverseModifies the order of progression this buffer takes through the cube. By default, progresses samples first, then lines, then bands. If reverse = true, then the buffer progresses bands first, then lines, then samples.

Definition at line 120 of file Brick.h.

Member Function Documentation

◆ Allocate()

void Isis::Buffer::Allocate ( )
protectedinherited

Size or resize the memory buffer.

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

Definition at line 356 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 Resize().

◆ at()

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

◆ 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
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 178 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::SpectralDefinition2D::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().

◆ BandDimension()

◆ begin()

◆ Bricks()

◆ Copy()

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.
includeRawBufWhether 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

Definition at line 271 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().

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

Definition at line 301 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().

◆ DoubleBuffer()

◆ end()

bool Isis::BufferManager::end ( ) const
inlineinherited

◆ 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_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 213 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().

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

◆ LineDimension()

◆ MaxBands()

int Isis::BufferManager::MaxBands ( ) const
inlineprotectedinherited

Returns the number of bands in the cube.

Returns
int

Definition at line 168 of file BufferManager.h.

References Isis::BufferManager::p_maxBands.

Referenced by Isis::BandManager::SetBand().

◆ MaxLines()

int Isis::BufferManager::MaxLines ( ) const
inlineprotectedinherited

Returns the number of lines in the cube.

Returns
int

Definition at line 159 of file BufferManager.h.

References Isis::BufferManager::p_maxLines.

Referenced by Isis::LineManager::SetLine().

◆ MaxMaps()

BigInt Isis::BufferManager::MaxMaps ( ) const
inlineprotectedinherited

Returns the maximum number of positions the shape buffer needs to cover the entire image (see setpos method for more info).

Returns
int

Definition at line 178 of file BufferManager.h.

References Isis::BufferManager::p_nmaps.

Referenced by Bricks(), and Isis::TileManager::Tiles().

◆ MaxSamples()

int Isis::BufferManager::MaxSamples ( ) const
inlineprotectedinherited

Returns the number of samples in the cube.

Returns
int

Definition at line 150 of file BufferManager.h.

References Isis::BufferManager::p_maxSamps.

Referenced by Isis::SampleManager::SetSample().

◆ next()

bool Isis::BufferManager::next ( )
inlineinherited

Moves the shape buffer to the next position.

Returns true if the next position is valid.

Returns
bool

Definition at line 122 of file BufferManager.h.

References Isis::BufferManager::p_currentMap, and Isis::BufferManager::setpos().

Referenced by Isis::Cube::copy(), Isis::BufferManager::operator++(), Isis::ProcessByBoxcar::StartProcess(), and Isis::ProcessExport::StartProcess().

◆ operator++()

bool Isis::BufferManager::operator++ ( int  )
inlineinherited

Moves the shape buffer to the next position.

Returns true if the next position is valid.

Returns
bool

Definition at line 89 of file BufferManager.h.

References Isis::BufferManager::next().

◆ operator+=()

BufferManager& Isis::BufferManager::operator+= ( int  i)
inlineinherited

Moves the shape buffer by a certain amount.

Returns a pointer to the BufferManager it was called on.

Parameters
iHow far to shift the shape buffer
Returns
BufferManager

Definition at line 102 of file BufferManager.h.

References Isis::BufferManager::p_currentMap, and Isis::BufferManager::setpos().

◆ operator[]() [1/2]

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 134 of file Buffer.h.

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
indexIndex position in buffer. No out of bounds index is checked
Returns
double

Definition at line 145 of file Buffer.h.

References Isis::Buffer::p_buf.

◆ PixelType()

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

Returns the raw buffer pixel type.

Returns
Isis::PixelType

Definition at line 176 of file Buffer.h.

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
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 193 of file Buffer.cpp.

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

Definition at line 167 of file Buffer.h.

References Isis::Buffer::p_rawbuf.

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

◆ Resize()

void Isis::Brick::Resize ( const int  nsamps,
const int  nlines,
const int  nbands 
)

Resizes the memory buffer to the specified number of samples, lines, and bands.

Parameters
nsampsNumber of samples
nlinesNumber of lines
nbandsNumber of bands

Definition at line 36 of file Brick.cpp.

References Isis::Buffer::Allocate(), Isis::Buffer::p_buf, Isis::Buffer::p_nbands, Isis::Buffer::p_nlines, Isis::Buffer::p_npixels, Isis::Buffer::p_nsamps, and 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
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 143 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::SpectralDefinition2D::operator()(), Isis::CubeDataThread::OverlapIndex(), Isis::Buffer::Position(), Isis::CubeIoHandler::read(), Isis::EditTool::redoEdit(), Isis::CubeIoHandler::synchronousWrite(), Isis::EditTool::undoEdit(), and Isis::EditTool::writeToCube().

◆ SampleDimension()

◆ SetBaseBand()

void Isis::Brick::SetBaseBand ( const int  start_band)
inline

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

Parameters
start_bandStarting band to set

Definition at line 164 of file Brick.h.

References Isis::Buffer::SetBaseBand().

Referenced by Isis::ProcessByBrick::ProcessCubesFunctor< T >::operator()().

◆ SetBaseLine()

void Isis::Brick::SetBaseLine ( const int  start_line)
inline

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

Parameters
start_lineStarting line to set

Definition at line 155 of file Brick.h.

References Isis::Buffer::SetBaseLine().

◆ SetBasePosition()

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

◆ SetBaseSample()

void Isis::Brick::SetBaseSample ( const int  start_samp)
inline

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

Parameters
start_sampStarting sample to set

Definition at line 146 of file Brick.h.

References Isis::Buffer::SetBaseSample().

◆ SetBrick()

bool Isis::Brick::SetBrick ( const int  brick)

This method is used to set the position of the brick.

Sets the current brick as requested.

Parameters
brickBrick number to move to.
Returns
bool Is the brick at the end of the cube?
Parameters
brickThe brick number within a cube. This number starts with the upper left corner of the cube and proceedes across the samples then down the lines and lastly through the bands. The first brick starts at (1,1,1). The last brick contains the point (cubeSamples,cubeLines,cubeBands).
Returns
bool
Exceptions
Isis::iException::Programmer- invalid argument value

Definition at line 59 of file Brick.cpp.

References _FILEINFO_, Isis::IException::Programmer, and Isis::BufferManager::setpos().

◆ SetIncrements()

void Isis::BufferManager::SetIncrements ( const int  sinc,
const int  linc,
const int  binc 
)
protectedinherited

Sets how the shape is incremented through the cube.

By default (if this method is not invoked) shapes are moved sequentially through the cube with no overlap. For example, assume a 3 sample by 3 line tile buffer. It would first move across the image from left-to-right starting at sample 1, line 1, and band 1. Upon an increment it would be positioned at sample 4, line 1, and band 1. Each successive increment would cause the sample position to increase by 3 until it exceeds the number of samples in the cube. At that point the shape buffer would be positioned at sample 1, line 4, and band 1 (effectively moving to the next row of tiles). The shape would then continue moving across the cube until it reaches the edge again. Then the next row of tiles would be accessed until the shape reached the bottom of the cube. This default management can be overridden using this method. For example, by setting the increments to (6,3,1) we effectively skip every other tile. By setting them to (6,6,1) we skip every other tile and every other row of tiles. By setting them to (1,1,1) we essentially have NSxNLxNB positions in the cube and the 3x3 tile is managed such that the top left corner of the tile is moved over by 1 sample until it reaches the end of the line then down 1 line and so on until the end of the cube is reached.

Parameters
sincSample increment
lincLine increment
bincBand increment

Definition at line 156 of file BufferManager.cpp.

References Isis::BufferManager::p_binc, Isis::BufferManager::p_boff, Isis::BufferManager::p_currentBand, Isis::BufferManager::p_currentLine, Isis::BufferManager::p_currentMap, Isis::BufferManager::p_currentSample, Isis::BufferManager::p_linc, Isis::BufferManager::p_loff, Isis::BufferManager::p_maxBands, Isis::BufferManager::p_maxLines, Isis::BufferManager::p_maxSamps, Isis::BufferManager::p_nmaps, Isis::BufferManager::p_sinc, and Isis::BufferManager::p_soff.

Referenced by Isis::BoxcarManager::BoxcarManager(), and Isis::BufferManager::BufferManager().

◆ SetOffsets()

void Isis::BufferManager::SetOffsets ( const int  soff,
const int  loff,
const int  boff 
)
protectedinherited

Sets the offset of the buffer.

By default (if this method is not invoked) the offsets are (0,0,0). Offsets are applied when computing the top-left corner of the shape buffer. When used in conjunction with the SetIncrements method, this allows for centering shape buffers around a pixel when passing in negative offsets. For example,with a 3x3x1 shape and offsets of (-1,-1,0) and increments of (1,1,1) would cause the manager to walk a 3x3 buffer through the entire image. Setting the manager position the beginning causes the 3x3 window to be positioned such that sample 1, line 1 of the cube would be at the center of the window and increment would cause sample 2, line 1 to be at the center of the window. Successive increments will move the window in the sample direction until the end of line is reached at which time the buffer would be centered on sample 1, line 2.

Parameters
soffSample offset
loffLine offset
boffBand offset

Definition at line 195 of file BufferManager.cpp.

References Isis::BufferManager::p_boff, Isis::BufferManager::p_loff, and Isis::BufferManager::p_soff.

Referenced by Isis::BoxcarManager::BoxcarManager().

◆ setpos()

bool Isis::BufferManager::setpos ( BigInt  map)
inherited

Sets the position of the shape in the cube.

This shape fits into the cube a specific number of times.

When p_reverse is left false: (default) For example, a line shape on a 100 sample, 200 line, and 2 band cube would have 200*2 or 400 different positions as there are 400 total lines in the cube. Performing setpos(0) would position the shape at sample 1, line 1, and band 1. While setpos(200) would position the shape at sample 1, line 1, and band 2. Finally, setpos(399) would position the shape at sample 1, line 400, and band 2. Setpos returns true if it was sucessfully in setting the position, and false if the shape is at the end of the cube (beyond index 399 in the case of our example).

When p_reverse is set to true: Following the above cube with 100 samples, 200 lines, and 2 bands, performing the setpos(0) would still position the shape at sample 1, line 1, and band 1. However, setpos(1) would position the shape at sample 1, line 1, band 2, while setpos(200) would position the spame at sample 1, line 100, band 1. Setpos returns true of it was sucessfully in setting the position, and false if the shape is at the end of the cube(beyond final index).

Parameters
mapShape buffer position value
Returns
bool True or False depending on whether the shape is at the end of the cube or not.
Exceptions
Isis::iException::Programmer- Invalid value for map argument

Definition at line 235 of file BufferManager.cpp.

References _FILEINFO_, Isis::BufferManager::end(), Isis::BufferManager::p_binc, Isis::BufferManager::p_boff, Isis::BufferManager::p_currentBand, Isis::BufferManager::p_currentLine, Isis::BufferManager::p_currentMap, Isis::BufferManager::p_currentSample, Isis::BufferManager::p_linc, Isis::BufferManager::p_loff, Isis::BufferManager::p_maxBands, Isis::BufferManager::p_maxLines, Isis::BufferManager::p_maxSamps, Isis::BufferManager::p_reverse, Isis::BufferManager::p_sinc, Isis::BufferManager::p_soff, Isis::IException::Programmer, and Isis::Buffer::SetBasePosition().

Referenced by Isis::BufferManager::begin(), Isis::BufferManager::next(), Isis::ProcessByBrick::ProcessCubeInPlaceFunctor< T >::operator()(), Isis::ProcessByBrick::ProcessCubeFunctor< T >::operator()(), Isis::ProcessByBrick::ProcessCubesFunctor< T >::operator()(), Isis::BufferManager::operator+=(), Isis::BandManager::SetBand(), SetBrick(), Isis::LineManager::SetLine(), Isis::SampleManager::SetSample(), and Isis::TileManager::SetTile().

◆ size()

◆ swap()

Member Data Documentation

◆ p_band

int Isis::Buffer::p_band
protectedinherited

Starting band to read/write.

Definition at line 220 of file Buffer.h.

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.

Definition at line 224 of file Buffer.h.

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

◆ p_line

int Isis::Buffer::p_line
protectedinherited

Starting line to read/write.

Definition at line 217 of file Buffer.h.

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.

Definition at line 221 of file Buffer.h.

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

◆ p_nlines

int Isis::Buffer::p_nlines
protectedinherited

◆ p_npixels

int Isis::Buffer::p_npixels
protectedinherited

◆ p_nsamps

int Isis::Buffer::p_nsamps
protectedinherited

◆ p_pixelType

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

The pixel type of the raw buffer.

Definition at line 227 of file Buffer.h.

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.

Definition at line 228 of file Buffer.h.

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

◆ p_sample

int Isis::Buffer::p_sample
protectedinherited

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