Isis::OriginalLabel Class Reference

Read and store original labels. More...

#include <OriginalLabel.h>

Inherits Isis::Blob.

Public Member Functions
	OriginalLabel ()
	Constructor for creating an original blob with a given name.
	OriginalLabel (const QString &file)
	Constructor for creating an original blob with a given name and file to read labels from.
	OriginalLabel (Pvl pvl)
	Constructor for creating an original blob with a given name and Pvl container.
	~OriginalLabel ()
Pvl	ReturnLabels ()
	Returns the labels in a Pvl object.
QString	Type () const
	Accessor method that returns a string containing the Blob type.
QString	Name () const
	Accessor method that returns a string containing the Blob name.
int	Size () const
	Accessor method that returns the number of bytes in the blob data.
PvlObject &	Label ()
	Accessor method that returns a PvlObject containing the Blob label.
void	Read (const QString &file)
	This method reads Pvl values from a specified file.
void	Read (const QString &file, const Pvl &pvlLabels)
	This method reads the given a file and labels.
virtual void	Read (const Pvl &pvl, std::istream &is)
	This method reads the Blob data from an open input file stream.
void	Write (const QString &file)
	Write the blob data out to a file.
void	Write (Pvl &pvl, std::fstream &stm, const QString &detachedFileName="")
	Write the blob data out to a Pvl object.

Protected Member Functions
void	WriteInit ()
	Prepare labels for writing to the output cube.
void	Find (const Pvl &pvl)
	This method searches the given Pvl for the Blob by the Blob's type and name.
virtual void	ReadInit ()
	This virtual method for classes that inherit Blob.
virtual void	ReadData (std::istream &is)
	Read binary data from an input stream into the Blob object.
virtual void	WriteData (std::fstream &os)
	Writes blob data to a stream.

Protected Attributes
PvlObject	p_blobPvl
	Pvl Blob object.
QString	p_blobName
	Name of the Blob object.
char *	p_buffer
	Buffer blob data is stored in.
BigInt	p_startByte
	Byte blob data starts at in buffer.
int	p_nbytes
	Size of blob data (in bytes)
QString	p_type
	Type of data stored in the buffer.
QString	p_detached
	Used for reading detached blobs.
QString	p_labelFile
	The file containing the labels.

Detailed Description

Read and store original labels.

This class provides a means to read and store the labels from the original source. The labels can be retreived in a Pvl object.

Author

2006-02-23 Robert Wallace and Brian Lipkowitz

Constructor & Destructor Documentation

Isis::OriginalLabel::OriginalLabel

(

)

Constructor for creating an original blob with a given name.

References Isis::Pvl::setTerminator().

Isis::OriginalLabel::OriginalLabel

(

const QString &

file

)

Constructor for creating an original blob with a given name and file to read labels from.

Parameters

file	File to read labels from

References Isis::Blob::Read().

Isis::OriginalLabel::OriginalLabel

(

Pvl

pvl

)

Constructor for creating an original blob with a given name and Pvl container.

Parameters

pvl	Pvl containing labels of the source

Isis::OriginalLabel::~OriginalLabel

(

)

Member Function Documentation

void Isis::Blob::Find ( const Pvl &  pvl )

protectedinherited

This method searches the given Pvl for the Blob by the Blob's type and name.

If found, the start byte, number of bytes are read from the Pvl. Also, if a keyword label pointer is found, the filename for the detached blob is stored and the pointer is removed from the blob pvl.

Parameters

pvl	The Pvl to be searched

References _FILEINFO_, Isis::PvlContainer::isNamed(), Isis::PvlObject::object(), Isis::PvlObject::objects(), and Isis::FileName::path().

PvlObject & Isis::Blob::Label ( )

inherited

Accessor method that returns a PvlObject containing the Blob label.

Returns

PvlObject The label of the blob.

Referenced by Isis::SpiceRotation::CacheLabel(), Isis::SpicePosition::LoadCache(), and Isis::SpiceRotation::LoadCache().

QString Isis::Blob::Name ( ) const

inherited

Accessor method that returns a string containing the Blob name.

Returns

string The name of the blob.

Referenced by Isis::Image::isFootprintable(), Isis::SpicePosition::LoadCache(), and Isis::Cube::write().

void Isis::Blob::Read ( const QString &  file )

inherited

This method reads Pvl values from a specified file.

Parameters

file	The filename to read from.

Exceptions

iException::Io	- Unable to open file
iException::Pvl	- Invalid label format

References _FILEINFO_, and Isis::Pvl::read().

Referenced by OriginalLabel(), Isis::Cube::read(), and Isis::Table::Table().

void Isis::Blob::Read ( const QString &  file, const Pvl &  pvlLabels  )

inherited

This method reads the given a file and labels.

Parameters

file	The filename to read from.
pvlLabels	A Pvl containing the label information.

Exceptions

iException::Io

- Unable to open file

References _FILEINFO_, and Isis::Message::FileOpen().

void Isis::Blob::Read ( const Pvl &  pvl, std::istream &  istm  )

virtualinherited

This method reads the Blob data from an open input file stream.

Parameters

pvl	A Pvl containing the label information.
istm	The input file stream containing the blob data to be read.

Exceptions

iException::Io

- Unable to open file

Reimplemented in Isis::History.

References _FILEINFO_, and Isis::Message::FileOpen().

void Isis::Blob::ReadData ( std::istream &  stream )

protectedvirtualinherited

Read binary data from an input stream into the Blob object.

Parameters

stream

The input stream to read from.

Exceptions

IException::Io

- Error reading data from stream

Reimplemented in Isis::ImagePolygon, and Isis::Table.

References _FILEINFO_.

void Isis::Blob::ReadInit ( )

protectedvirtualinherited

This virtual method for classes that inherit Blob.

It is not defined in the Blob class.

Reimplemented in Isis::Table.

Pvl Isis::OriginalLabel::ReturnLabels

(

)

Returns the labels in a Pvl object.

Returns

(Isis::Pvl) original labels

References Isis::Blob::p_buffer, and Isis::Blob::p_nbytes.

int Isis::Blob::Size ( ) const

inherited

Accessor method that returns the number of bytes in the blob data.

Returns

int Number of bytes in the blob data.

QString Isis::Blob::Type ( ) const

inherited

Accessor method that returns a string containing the Blob type.

Returns

string Type of blob.

Referenced by Isis::Image::isFootprintable(), and Isis::Cube::write().

void Isis::Blob::Write ( const QString &  file )

inherited

Write the blob data out to a file.

Parameters

file	The filename to write to.

Exceptions

IException::Io	- Unable to open file
IException::Io	- Error preparing to write data to file
IException::Io	- Error creating file

References _FILEINFO_, Isis::PvlObject::addObject(), Isis::PvlObject::findObject(), Isis::toString(), and Isis::Pvl::write().

Referenced by Isis::Cube::write().

void Isis::Blob::Write ( Pvl &  pvl, std::fstream &  stm, const QString &  detachedFileName = ""  )

inherited

Write the blob data out to a Pvl object.

Parameters

pvl	The pvl object to update
stm	stream to write data to
detachedFileName	If the stream is detached from the labels give the name of the file

References Isis::PvlObject::addObject(), Isis::PvlContainer::name(), Isis::PvlObject::object(), Isis::PvlObject::objects(), and Isis::toString().

void Isis::Blob::WriteData ( std::fstream &  stream )

protectedvirtualinherited

Writes blob data to a stream.

Parameters

stream

Output steam blob data will be written to

Exceptions

IException::Io

- Error writing data to stream

Reimplemented in Isis::ImagePolygon, and Isis::Table.

References _FILEINFO_.

void Isis::OriginalLabel::WriteInit ( )

protectedvirtual

Prepare labels for writing to the output cube.

Reimplemented from Isis::Blob.

References Isis::Blob::p_buffer, and Isis::Blob::p_nbytes.

Member Data Documentation

QString Isis::Blob::p_blobName

protectedinherited

Name of the Blob object.

Referenced by Isis::Blob::Blob(), Isis::Table::operator+=(), Isis::Blob::operator=(), Isis::Table::ReadData(), and Isis::ImagePolygon::ReadData().

PvlObject Isis::Blob::p_blobPvl

protectedinherited

Pvl Blob object.

Referenced by Isis::Blob::Blob(), Isis::Blob::operator=(), Isis::Table::ReadInit(), Isis::Table::Table(), and Isis::Table::WriteInit().

char* Isis::Blob::p_buffer

protectedinherited

Buffer blob data is stored in.

Referenced by Isis::Blob::Blob(), Isis::GisBlob::GisBlob(), Isis::Blob::operator=(), Isis::History::ReturnHist(), ReturnLabels(), Isis::GisBlob::setPolygon(), WriteInit(), and Isis::History::WriteInit().

QString Isis::Blob::p_detached

protectedinherited

Used for reading detached blobs.

Referenced by Isis::Blob::Blob(), and Isis::Blob::operator=().

QString Isis::Blob::p_labelFile

protectedinherited

The file containing the labels.

Referenced by Isis::Blob::Blob(), and Isis::Blob::operator=().

int Isis::Blob::p_nbytes

protectedinherited

Size of blob data (in bytes)

Referenced by Isis::Blob::Blob(), Isis::GisBlob::GisBlob(), Isis::Blob::operator=(), Isis::ImagePolygon::ReadData(), Isis::History::ReturnHist(), ReturnLabels(), Isis::GisBlob::setPolygon(), Isis::ImagePolygon::WriteData(), Isis::History::WriteInit(), WriteInit(), Isis::Table::WriteInit(), and Isis::ImagePolygon::WriteInit().

BigInt Isis::Blob::p_startByte

protectedinherited

Byte blob data starts at in buffer.

Referenced by Isis::Blob::Blob(), Isis::Blob::operator=(), Isis::Table::ReadData(), and Isis::ImagePolygon::ReadData().

QString Isis::Blob::p_type

protectedinherited

Type of data stored in the buffer.

Referenced by Isis::Blob::Blob(), Isis::Blob::operator=(), and Isis::ImagePolygon::ReadData().

---

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

• src/base/objs/OriginalLabel/OriginalLabel.h
• src/base/objs/OriginalLabel/OriginalLabel.cpp