Isis 3 Programmer Reference
Isis::JP2Exporter Class Reference

Exports cubes into JPEG 2000 images. More...

#include <JP2Exporter.h>

Inheritance diagram for Isis::JP2Exporter:
Inheritance graph
Collaboration diagram for Isis::JP2Exporter:
Collaboration graph

Public Member Functions

 JP2Exporter ()
 Construct the JPEG 2000 exporter. More...
 
virtual ~JP2Exporter ()
 Destruct the exporter. More...
 
virtual void write (FileName outputName, int quality=100, QString compression="none")
 Initialize the encoder, open the output file for writing, then let the base ImageExporter handle the generic black-box writing routine. More...
 
virtual void setGrayscale (ExportDescription &desc)
 Generic initialization with the export description. More...
 
virtual void setRgb (ExportDescription &desc)
 Generic initialization with the export description. More...
 
virtual void setRgba (ExportDescription &desc)
 Generic initialization with the export description. More...
 
void operator() (vector< Buffer *> &in) const
 The method for writing a line of input image data (with potentially several bands representing color channels) to the output image. More...
 
int samples () const
 Number of samples (columns) in the output image. More...
 
int lines () const
 Number of lines (rows) in the output image. More...
 
int bands () const
 Number of bands (channels) in the output image. More...
 
double inputMinimum (int channel) const
 Returns the input minimum for the given channel. More...
 
double inputMaximum (int channel) const
 Returns the input maximum for the given channel. More...
 
void setOutputPixelRange (double outputPixelMinimum, double outputPixelMaximum)
 Set the DN floor and ceiling for the exported image. More...
 

Static Public Member Functions

static bool canWriteFormat (QString format)
 Returns true if the format is "jp2". More...
 
static ImageExporterfromFormat (QString format)
 A static (factory) method for constructing an ImageExporter instance from an output format. More...
 

Protected Types

typedef void(ImageExporter::* WriteChannels) (vector< Buffer *> &in) const
 Friendly alias for a method used to write a particular color channel. More...
 

Protected Member Functions

virtual void createBuffer ()
 Creates the buffer to store a chunk of streamed line data with one or more bands. More...
 
virtual void setBuffer (int s, int b, int dn) const
 Set the DN value at the given sample and band of the line buffer. More...
 
virtual void writeLine (int l) const
 Writes a line of buffered data to the output image on disk. More...
 
virtual void initialize (ExportDescription &desc)
 Generic initialization with the export description. More...
 
virtual void writeGrayscale (vector< Buffer *> &in) const
 Write a line of grayscale data to the output image. More...
 
virtual void writeRgb (vector< Buffer *> &in) const
 Write a line of RGB data to the output image. More...
 
virtual void writeRgba (vector< Buffer *> &in) const
 Write a line of RGBA data to the output image. More...
 
void setExtension (QString extension)
 Sets the extension for the output image and generates the extension for the world file from it. More...
 
void setExportDescription (ExportDescription &desc)
 Sets the description for the output image. More...
 
CubeinitializeProcess ()
 Sets up the export process with the parameters described within the given description. More...
 
QString extension () const
 Gets the extension for the output image. More...
 
ExportDescriptionexportDescription () const
 Gets the description for the output image. More...
 
ProcessExportprocess () const
 Get a reference to the process object, useful for subclasses to access and manipulate the process. More...
 
PixelType pixelType () const
 Returns the pixel type. More...
 
virtual int outputPixelValue (double dn) const
 Return the output clamped integer pixel value from the input double-precision DN. More...
 

Private Attributes

JP2Encoderm_encoder
 Object responsible for writing data to the output image. More...
 
char ** m_buffer
 Two dimensional array containing all color channels for a line. More...
 

Detailed Description

Exports cubes into JPEG 2000 images.

A streamed exporter for JPEG 2000 images. Can write an arbitrarily large set of single-band Isis cubes to an arbitrarily large JPEG 2000 image with the given pixel type.

Author
2012-04-03 Travis Addair
History:

2012-04-04 Travis Addair - Added documentation.

2013-06-05 Jeannie Backer - Removed "get" prefix from ImageExporter method calls. References #1380.

2015-02-12 Jeffrey Covington - Added compression parameter to write() method. Fixes #1745.

Definition at line 50 of file JP2Exporter.h.

Member Typedef Documentation

◆ WriteChannels

typedef void(ImageExporter::* Isis::ImageExporter::WriteChannels) (vector< Buffer * > &in) const
protectedinherited

Friendly alias for a method used to write a particular color channel.

Definition at line 114 of file ImageExporter.h.

Constructor & Destructor Documentation

◆ JP2Exporter()

Isis::JP2Exporter::JP2Exporter ( )

Construct the JPEG 2000 exporter.

Definition at line 16 of file JP2Exporter.cpp.

References m_buffer, m_encoder, and Isis::ImageExporter::setExtension().

◆ ~JP2Exporter()

Isis::JP2Exporter::~JP2Exporter ( )
virtual

Destruct the exporter.

Definition at line 27 of file JP2Exporter.cpp.

References m_buffer, and m_encoder.

Member Function Documentation

◆ bands()

int Isis::ImageExporter::bands ( ) const
inherited

Number of bands (channels) in the output image.

Returns
The depth of the output

Definition at line 132 of file ImageExporter.cpp.

Referenced by Isis::QtExporter::checkDataSize(), createBuffer(), Isis::TiffExporter::createBuffer(), Isis::TiffExporter::setBuffer(), write(), and Isis::TiffExporter::write().

◆ canWriteFormat()

bool Isis::JP2Exporter::canWriteFormat ( QString  format)
static

Returns true if the format is "jp2".

Parameters
formatLowercase format abbreviation
Returns
True if "jp2", false otherwise

Definition at line 120 of file JP2Exporter.cpp.

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

◆ createBuffer()

void Isis::JP2Exporter::createBuffer ( )
protectedvirtual

Creates the buffer to store a chunk of streamed line data with one or more bands.

Implements Isis::StreamExporter.

Definition at line 40 of file JP2Exporter.cpp.

References Isis::ImageExporter::bands(), m_buffer, Isis::ImageExporter::pixelType(), and Isis::ImageExporter::samples().

◆ exportDescription()

ExportDescription & Isis::ImageExporter::exportDescription ( ) const
protectedinherited

Gets the description for the output image.

Returns
The export description

Definition at line 220 of file ImageExporter.cpp.

◆ extension()

QString Isis::ImageExporter::extension ( ) const
protectedinherited

Gets the extension for the output image.

Returns
The extension for the output image

Definition at line 202 of file ImageExporter.cpp.

Referenced by write(), Isis::TiffExporter::write(), and Isis::QtExporter::write().

◆ fromFormat()

ImageExporter * Isis::ImageExporter::fromFormat ( QString  format)
staticinherited

A static (factory) method for constructing an ImageExporter instance from an output format.

The specific subclass of the returned instance is determined from the desired output image format provided. Each subclass has knowledge of whether or not it can write a particular format. Because the ability to export an image format is not mutually exclusive amongst exporters, the order of condieration here matters. For example, using a TIFF exporter takes precedence over a Qt exporter for TIFF images, because the former can process cubes greater than 2GB while the latter cannot. It is the caller's responsibility to delete the exporter instance when they are finished with it.

Parameters
formatThe format for the output image to be created
Returns
A pointer to the instantiated exporter owned by the caller

Definition at line 384 of file ImageExporter.cpp.

References _FILEINFO_, canWriteFormat(), Isis::TiffExporter::canWriteFormat(), Isis::QtExporter::canWriteFormat(), and Isis::IException::Programmer.

◆ initialize()

void Isis::StreamExporter::initialize ( ExportDescription desc)
protectedvirtualinherited

Generic initialization with the export description.

Set the input, set the pixel type, and create the buffer.

Parameters
descExport description containing necessary channel information

Implements Isis::ImageExporter.

Definition at line 68 of file StreamExporter.cpp.

References Isis::StreamExporter::createBuffer(), and Isis::ImageExporter::initialize().

Referenced by Isis::StreamExporter::setGrayscale(), Isis::StreamExporter::setRgb(), and Isis::StreamExporter::setRgba().

◆ initializeProcess()

Cube * Isis::ImageExporter::initializeProcess ( )
protectedinherited

Sets up the export process with the parameters described within the given description.

This method determines determines whether to write the data as grayscale, RGB, or RGBA. It then opens a cube for retrieving the input data and establishing the dimensions of the output image. Next, the ProcessExport format is set to BIL and the ProcessExport output pixel type, output valid data range, and output null are set based on the given export description. Last, the absolute output pixel range is set based on the given description (this is the smallest and largest allowed pixel values in the output, including "special" pixel values).

Returns
A cube pointer to the first channel created, owned by the process

Definition at line 240 of file ImageExporter.cpp.

References _FILEINFO_, Isis::ProcessExport::BIL, Isis::Cube::lineCount(), Isis::IException::Programmer, Isis::Cube::sampleCount(), Isis::ProcessExport::setFormat(), Isis::ProcessExport::SetOutputNull(), Isis::ProcessExport::SetOutputRange(), Isis::ProcessExport::SetOutputType(), Isis::ImageExporter::writeGrayscale(), Isis::ImageExporter::writeRgb(), and Isis::ImageExporter::writeRgba().

◆ inputMaximum()

double Isis::ImageExporter::inputMaximum ( int  channel) const
inherited

Returns the input maximum for the given channel.

Any value of max in the input cube will be mapped to the output max of the output channel.

Parameters
channelIndex of the channel within the process
Returns
The maximum DN in the input mapped to the maximum of the output

Definition at line 158 of file ImageExporter.cpp.

◆ inputMinimum()

double Isis::ImageExporter::inputMinimum ( int  channel) const
inherited

Returns the input minimum for the given channel.

Any value of min in the input cube will be mapped to the output min of the output channel.

Parameters
channelIndex of the channel within the process
Returns
The minimum DN in the input mapped to the minimum of the output

Definition at line 145 of file ImageExporter.cpp.

◆ lines()

int Isis::ImageExporter::lines ( ) const
inherited

Number of lines (rows) in the output image.

Returns
The height of the output

Definition at line 122 of file ImageExporter.cpp.

Referenced by Isis::QtExporter::checkDataSize(), Isis::QtExporter::setGrayscale(), Isis::QtExporter::setRgb(), Isis::QtExporter::setRgba(), write(), and Isis::TiffExporter::write().

◆ operator()()

void Isis::ImageExporter::operator() ( vector< Buffer *> &  in) const
inherited

The method for writing a line of input image data (with potentially several bands representing color channels) to the output image.

It is called for each line of data in the input images (provides a vector containing the same line from each single-band input image). Enables the exporter to be used as a functor in a custom ProcessExport routine, bypassing the black-box write() method entirely.

Parameters
inVector containing a line of input data from each input channel

Definition at line 78 of file ImageExporter.cpp.

◆ outputPixelValue()

int Isis::ImageExporter::outputPixelValue ( double  dn) const
protectedvirtualinherited

Return the output clamped integer pixel value from the input double-precision DN.

Parameters
dnThe input DN
Returns
The pixel value for the output

Definition at line 319 of file ImageExporter.cpp.

Referenced by Isis::StreamExporter::writeGrayscale(), Isis::QtExporter::writeGrayscale(), Isis::StreamExporter::writeRgb(), Isis::QtExporter::writeRgb(), Isis::StreamExporter::writeRgba(), and Isis::QtExporter::writeRgba().

◆ pixelType()

PixelType Isis::ImageExporter::pixelType ( ) const
protectedinherited

Returns the pixel type.

Defaults to None if not set by the user.

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

Definition at line 301 of file ImageExporter.cpp.

Referenced by createBuffer(), Isis::TiffExporter::createBuffer(), setBuffer(), Isis::TiffExporter::setBuffer(), write(), Isis::TiffExporter::write(), and writeLine().

◆ process()

ProcessExport & Isis::ImageExporter::process ( ) const
protectedinherited

Get a reference to the process object, useful for subclasses to access and manipulate the process.

Returns
A reference to the process object

Definition at line 291 of file ImageExporter.cpp.

◆ samples()

int Isis::ImageExporter::samples ( ) const
inherited

◆ setBuffer()

void Isis::JP2Exporter::setBuffer ( int  s,
int  b,
int  dn 
) const
protectedvirtual

Set the DN value at the given sample and band of the line buffer.

Parameters
sThe sample index into the buffer
bThe band index into the buffer
dnThe value to set at the given index

Implements Isis::StreamExporter.

Definition at line 79 of file JP2Exporter.cpp.

References _FILEINFO_, m_buffer, Isis::ImageExporter::pixelType(), Isis::IException::Programmer, and Isis::toString().

◆ setExportDescription()

void Isis::ImageExporter::setExportDescription ( ExportDescription desc)
protectedinherited

Sets the description for the output image.

Parameters
descThe export description

Definition at line 211 of file ImageExporter.cpp.

◆ setExtension()

void Isis::ImageExporter::setExtension ( QString  extension)
protectedinherited

Sets the extension for the output image and generates the extension for the world file from it.

Parameters
extensionThe extension for the output image

Definition at line 187 of file ImageExporter.cpp.

Referenced by JP2Exporter(), Isis::QtExporter::QtExporter(), and Isis::TiffExporter::TiffExporter().

◆ setGrayscale()

void Isis::StreamExporter::setGrayscale ( ExportDescription desc)
virtualinherited

Generic initialization with the export description.

Stream exporters do not do anything special to export a grayscale image beyond setting up the appropriate number of color channels.

Parameters
descExport description containing necessary channel information

Implements Isis::ImageExporter.

Definition at line 33 of file StreamExporter.cpp.

References Isis::StreamExporter::initialize().

◆ setOutputPixelRange()

void Isis::ImageExporter::setOutputPixelRange ( double  outputPixelMinimum,
double  outputPixelMaximum 
)
inherited

Set the DN floor and ceiling for the exported image.

All DNs less than the min will be set to the min in the exported image. Similarly, all DNs greater than the max will be set to the max in the exported image.

Note: These values may be "special". For example, if Null pixels are exported to 0.0 and the minimum valid pixels are exported to 2.0, then 0.0 should be passed in for the value of the min parameter.

Parameters
minThe absolute minimum output DN value.
maxThe absolute maximum output DN value.

Definition at line 175 of file ImageExporter.cpp.

◆ setRgb()

void Isis::StreamExporter::setRgb ( ExportDescription desc)
virtualinherited

Generic initialization with the export description.

Stream exporters do not do anything special to export an RGB image beyond setting up the appropriate number of color channels.

Parameters
descExport description containing necessary channel information

Implements Isis::ImageExporter.

Definition at line 45 of file StreamExporter.cpp.

References Isis::StreamExporter::initialize().

◆ setRgba()

void Isis::StreamExporter::setRgba ( ExportDescription desc)
virtualinherited

Generic initialization with the export description.

Stream exporters do not do anything special to export an RGBA image beyond setting up the appropriate number of color channels.

Parameters
descExport description containing necessary channel information

Implements Isis::ImageExporter.

Definition at line 57 of file StreamExporter.cpp.

References Isis::StreamExporter::initialize().

◆ write()

void Isis::JP2Exporter::write ( FileName  outputName,
int  quality = 100,
QString  compression = "none" 
)
virtual

Initialize the encoder, open the output file for writing, then let the base ImageExporter handle the generic black-box writing routine.

Parameters
outputNameThe filename of the output cube
qualityThe quality of the output, not used for JPEG 2000
compressionThe compression algorithm used. Not used for JPEG 2000

Reimplemented from Isis::ImageExporter.

Definition at line 58 of file JP2Exporter.cpp.

References Isis::FileName::addExtension(), Isis::ImageExporter::bands(), Isis::FileName::expanded(), Isis::ImageExporter::extension(), Isis::ImageExporter::lines(), m_encoder, Isis::JP2Encoder::OpenFile(), Isis::ImageExporter::pixelType(), Isis::ImageExporter::samples(), and Isis::ImageExporter::write().

◆ writeGrayscale()

void Isis::StreamExporter::writeGrayscale ( vector< Buffer *> &  in) const
protectedvirtualinherited

Write a line of grayscale data to the output image.

Parameters
inVector containing a single grayscale input line

Implements Isis::ImageExporter.

Definition at line 79 of file StreamExporter.cpp.

References Isis::Buffer::Line(), Isis::ImageExporter::outputPixelValue(), Isis::Buffer::SampleDimension(), Isis::StreamExporter::setBuffer(), and Isis::StreamExporter::writeLine().

◆ writeLine()

void Isis::JP2Exporter::writeLine ( int  l) const
protectedvirtual

Writes a line of buffered data to the output image on disk.

Parameters
lThe line of the output image, unused for JPEG 2000

Implements Isis::StreamExporter.

Definition at line 104 of file JP2Exporter.cpp.

References m_buffer, m_encoder, Isis::ImageExporter::pixelType(), and Isis::JP2Encoder::Write().

◆ writeRgb()

void Isis::StreamExporter::writeRgb ( vector< Buffer *> &  in) const
protectedvirtualinherited

Write a line of RGB data to the output image.

Parameters
inVector containing three input lines (red, green, blue)

Implements Isis::ImageExporter.

Definition at line 97 of file StreamExporter.cpp.

References Isis::Buffer::Line(), Isis::ImageExporter::outputPixelValue(), Isis::Buffer::SampleDimension(), Isis::StreamExporter::setBuffer(), and Isis::StreamExporter::writeLine().

◆ writeRgba()

void Isis::StreamExporter::writeRgba ( vector< Buffer *> &  in) const
protectedvirtualinherited

Write a line of RGBA data to the output image.

Parameters
inVector containing four input lines (red, green, blue, alpha)

Implements Isis::ImageExporter.

Definition at line 121 of file StreamExporter.cpp.

References Isis::Buffer::Line(), Isis::ImageExporter::outputPixelValue(), Isis::Buffer::SampleDimension(), Isis::StreamExporter::setBuffer(), and Isis::StreamExporter::writeLine().

Member Data Documentation

◆ m_buffer

char** Isis::JP2Exporter::m_buffer
private

Two dimensional array containing all color channels for a line.

Definition at line 71 of file JP2Exporter.h.

Referenced by createBuffer(), JP2Exporter(), setBuffer(), writeLine(), and ~JP2Exporter().

◆ m_encoder

JP2Encoder* Isis::JP2Exporter::m_encoder
private

Object responsible for writing data to the output image.

Definition at line 68 of file JP2Exporter.h.

Referenced by JP2Exporter(), write(), writeLine(), and ~JP2Exporter().


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