USGS

Isis 3.0 Object Programmers' Reference

Home

Isis::ExportDescription Class Reference
[High Level Cube I/O]

Describes how a series of cubes should be exported. More...

#include <ExportDescription.h>

Collaboration diagram for Isis::ExportDescription:
Collaboration graph
[legend]

List of all members.

Classes

class  ChannelDescription
 Describes how a cube as a single color channel to be exported. More...

Public Member Functions

 ExportDescription ()
 Construct the export description.
virtual ~ExportDescription ()
 Destruct the export description.
void setPixelType (PixelType type)
 Set the pixel type for the output image.
PixelType getPixelType () const
 Returns the pixel type.
double getOutputMinimum () const
 Returns the output minimum.
double getOutputMaximum () const
 Returns the output maximum.
double getOutputNull () const
 Returns the output value for Null pixels.
int addChannel (FileName filename, CubeAttributeInput &att)
 Add an export color channel for the given input cube and attributes (typically band number).
int addChannel (FileName filename, CubeAttributeInput &att, double min, double max)
 Add an export color channel for the given input cube, attributes (typically band number), and input DN range.
const ChannelDescriptiongetChannel (int i) const
 Return the channels description at the given index.
int channelCount () const
 Count of the number of channels in the description.

Private Attributes

PixelType m_type
 Pixel type to export the data to, defaults to None.
double m_outputMin
 Minimum DN in the output, defaults to 0.0.
double m_outputMax
 Maximum DN in the output, defaults to 255.0.
double m_outputNull
 DN value to output Null pixels to, defaults to 0.0.
QList< ChannelDescription * > * m_channels
 List of color channels to be exported into the output image.

Detailed Description

Describes how a series of cubes should be exported.

This container class encapsulates the parameters required to specify how an Isis cube should be exported to a standard image format. This encapsulation is useful to applications like "isis2std" for passing its user parameters down to processing classes such as ImageExporters without needing to create new method signatures that take a growing list of parameters. The ExportDescription contains top-level data about the export as a whole, such as bit type. It also contains a list of ChannelDescriptions, each describing the input cubes, attributes, and DN ranges for a channel of color information (gray, red, blue, green, or alpha).

Author:
2012-04-03 Travis Addair

For internal use only.

History:
2012-04-04 Travis Addair - Added documentation.

Definition at line 54 of file ExportDescription.h.


Constructor & Destructor Documentation

Isis::ExportDescription::ExportDescription (  ) 

Construct the export description.

Definition at line 13 of file ExportDescription.cpp.

References m_channels, m_outputMax, m_outputMin, m_outputNull, and m_type.

Isis::ExportDescription::~ExportDescription (  )  [virtual]

Destruct the export description.

Also deletes the list of channels.

Definition at line 27 of file ExportDescription.cpp.

References m_channels.


Member Function Documentation

int Isis::ExportDescription::addChannel ( FileName  filename,
CubeAttributeInput att,
double  min,
double  max 
)

Add an export color channel for the given input cube, attributes (typically band number), and input DN range.

Parameters:
filename The name of the cube
att The cube attributes such as band number
min The minimum DN in the input mapped to the minimum of the output
max The maximum DN in the input mapped to the maximum of the output
Returns:
The index of the newly added channel

Definition at line 133 of file ExportDescription.cpp.

References m_channels, and Isis::ExportDescription::ChannelDescription::setInputRange().

int Isis::ExportDescription::addChannel ( FileName  filename,
CubeAttributeInput att 
)

Add an export color channel for the given input cube and attributes (typically band number).

Parameters:
filename The name of the cube
att The cube attributes such as band number
Returns:
The index of the newly added channel

Definition at line 114 of file ExportDescription.cpp.

References m_channels.

int Isis::ExportDescription::channelCount (  )  const

Count of the number of channels in the description.

Returns:
The channel count

Definition at line 162 of file ExportDescription.cpp.

References m_channels.

Referenced by Isis::ImageExporter::setInput().

const ExportDescription::ChannelDescription & Isis::ExportDescription::getChannel ( int  i  )  const

Return the channels description at the given index.

Parameters:
i Index of the desired channel
Returns:
Constant reference to the channel

Definition at line 151 of file ExportDescription.cpp.

Referenced by Isis::ImageExporter::addChannel().

double Isis::ExportDescription::getOutputMaximum (  )  const

Returns the output maximum.

Defaults to 255.0 if not set by the user.

Returns:
The output maximum

Definition at line 89 of file ExportDescription.cpp.

References m_outputMax.

Referenced by Isis::StreamExporter::setType().

double Isis::ExportDescription::getOutputMinimum (  )  const

Returns the output minimum.

Defaults to 0.0 if not set by the user.

Returns:
The output minimum

Definition at line 79 of file ExportDescription.cpp.

References m_outputMin.

Referenced by Isis::StreamExporter::setType().

double Isis::ExportDescription::getOutputNull (  )  const

Returns the output value for Null pixels.

Defaults to 0.0 if not set by the user.

Returns:
The output value for Nulls

Definition at line 100 of file ExportDescription.cpp.

References m_outputNull.

Referenced by Isis::StreamExporter::setType().

PixelType Isis::ExportDescription::getPixelType (  )  const

Returns the pixel type.

Defaults to None if not set by the user.

Returns:
The pixel type: {None, UnsignedByte, SignedWord, UnsignedWord}

Definition at line 69 of file ExportDescription.cpp.

References m_type.

Referenced by Isis::StreamExporter::setType().

void Isis::ExportDescription::setPixelType ( PixelType  type  ) 

Set the pixel type for the output image.

Automatically establishes valid output minimum, maximum, and null values based on the type.

Parameters:
type The pixel type: {UnsignedByte, SignedWord, UnsignedWord}

Definition at line 40 of file ExportDescription.cpp.

References _FILEINFO_, m_outputMax, m_outputMin, m_outputNull, m_type, Isis::IException::Programmer, and Isis::toString().


Member Data Documentation

List of color channels to be exported into the output image.

Definition at line 131 of file ExportDescription.h.

Referenced by addChannel(), channelCount(), ExportDescription(), and ~ExportDescription().

Maximum DN in the output, defaults to 255.0.

Definition at line 125 of file ExportDescription.h.

Referenced by ExportDescription(), getOutputMaximum(), and setPixelType().

Minimum DN in the output, defaults to 0.0.

Definition at line 122 of file ExportDescription.h.

Referenced by ExportDescription(), getOutputMinimum(), and setPixelType().

DN value to output Null pixels to, defaults to 0.0.

Definition at line 128 of file ExportDescription.h.

Referenced by ExportDescription(), getOutputNull(), and setPixelType().

Pixel type to export the data to, defaults to None.

Definition at line 119 of file ExportDescription.h.

Referenced by ExportDescription(), getPixelType(), and setPixelType().


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