Isis 3 Programmer Reference
Isis::QtImporter Class Reference

Imports a series of standard image formats with Qt facilities. More...

#include <QtImporter.h>

Inheritance diagram for Isis::QtImporter:
Inheritance graph
Collaboration diagram for Isis::QtImporter:
Collaboration graph

Public Member Functions

 QtImporter (FileName inputName)
 Construct the importer. More...
 
virtual ~QtImporter ()
 Destruct the importer. More...
 
virtual bool isGrayscale () const
 Tests to see if the input image is grayscale (no RGB/A). More...
 
virtual bool isRgb () const
 Tests to see if the input image is neither grayscale nor has an alpha channel, implying RGB (no alpha). More...
 
virtual bool isArgb () const
 Tests to see if the input image is has an alpha channel, implying RGBA. More...
 
void operator() (Buffer &out) const
 The method for processing the output cube in place, called for each line of the output image. More...
 
Cubeimport (FileName outputName)
 Import the image with default output attributes. More...
 
Cubeimport (FileName outputName, CubeAttributeOutput &att)
 Import the input image this instance was constructed with into the given output Isis cube with the given output attributes. More...
 
void setNullRange (double min, double max)
 Set the range of DN values within which a pixel from the input image will be set to Null in the output. More...
 
void setLrsRange (double min, double max)
 Set the range of DN values within which a pixel from the input image will be set to LRS in the output. More...
 
void setHrsRange (double min, double max)
 Set the range of DN values within which a pixel from the input image will be set to HRS in the output. More...
 
void setSamples (int s)
 Set the sample dimension (width) of the output image. More...
 
void setLines (int l)
 Set the line dimension (height) of the output image. More...
 
void setBands (int b)
 Set the band dimension (depth) of the output image. More...
 
int samples () const
 The sample dimension (width) of the output image. More...
 
int lines () const
 The line dimension (height) of the output image. More...
 
int bands () const
 The band dimension (depth) of the output image. More...
 
FileName filename () const
 The filename of the input image this instance was constructed with. More...
 
virtual PvlGroup convertProjection () const
 Pure virtual method for converting projection information in the file being imported to an ISIS Mapping group. More...
 

Static Public Member Functions

static ImageImporterfromFileName (FileName inputName)
 A static (factory) method for constructing an ImageImporter instance from an input filename. More...
 

Protected Types

typedef int(ImageImporter::* GetChannelMethod) (int pixel) const
 Friendly alias for a method used to get a particular color channel. More...
 

Protected Member Functions

virtual void updateRawBuffer (int line, int band) const
 Does nothing as Qt reads the entire input image into memory, and therefore does not need to be updated throughout the import process. More...
 
virtual int getPixel (int s, int l) const
 Returns a representation of a pixel for the input format that can then be broken down into specific gray or RGB/A components. More...
 
virtual int getGray (int pixel) const
 Retrieves the gray component of the given pixel. More...
 
virtual int getRed (int pixel) const
 Retrieves the red component of the given pixel. More...
 
virtual int getGreen (int pixel) const
 Retrieves the green component of the given pixel. More...
 
virtual int getBlue (int pixel) const
 Retrieves the blue component of the given pixel. More...
 
virtual int getAlpha (int pixel) const
 Retrieves the alpha component of the given pixel. More...
 
CubecreateOutput (FileName outputName, CubeAttributeOutput &att)
 Create the output cube from the given filename and attributes. More...
 
void setDefaultBands ()
 Set the number of bands to be created for the output cube based on the number of color channels in the input image. More...
 
double testSpecial (double pixel) const
 Tests a pixel against the Null, HRS, and LRS ranges defined by the importer's handler. More...
 
virtual GetChannelMethod getBandChannel (int band) const
 Retrieve the method responsible for fetching the color channel from the input image corresponding to the current band out of output being filled. More...
 
virtual int convertRgbToGray (int pixel) const
 Convert the current pixel, taken from an RGB/A image, and blend its RGB components into a single grayscale DN. More...
 

Private Attributes

QImage * m_qimage
 Structure holding all input image data in memory. More...
 
FileNamem_inputName
 The filename of the input image. More...
 
Cubem_outCube
 The owned handle on the output cube to be imported to. More...
 
int m_samples
 The number of samples to be written to the output. More...
 
int m_lines
 The number of lines to be written to the output. More...
 
int m_bands
 The number of bands to be written to the output. More...
 
double m_nullMin
 The lower bound of the range within which input DNs will be made Null. More...
 
double m_nullMax
 The upper bound of the range within which input DNs will be made Null. More...
 
double m_lrsMin
 The lower bound of the range within which input DNs will be made LRS. More...
 
double m_lrsMax
 The upper bound of the range within which input DNs will be made LRS. More...
 
double m_hrsMin
 The lower bound of the range within which input DNs will be made HRS. More...
 
double m_hrsMax
 The upper bound of the range within which input DNs will be made HRS. More...
 

Detailed Description

Imports a series of standard image formats with Qt facilities.

Takes a standard input image format and imports it into Isis in the cube format using Qt's QImage structure to handle reading the data into memory. See Qt's documentation on QImageReader for a complete list of supported formats:

http://qt-project.org/doc/qt-4.8/qimagereader.html#supportedImageFormats

While Qt can be used to import TIFF images into Isis, it is generally recommended to use the TiffImporter class instead, which uses LibTIFF version 4 to import big TIFFs. Qt, as of version 4.8, can only import images <2GB in size.

Author
2012-03-16 Travis Addair
History:
2012-03-28 Travis Addair - Added documentation.

Definition at line 39 of file QtImporter.h.

Member Typedef Documentation

◆ GetChannelMethod

typedef int(ImageImporter::* Isis::ImageImporter::GetChannelMethod) (int pixel) const
protectedinherited

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

Definition at line 97 of file ImageImporter.h.

Constructor & Destructor Documentation

◆ QtImporter()

Isis::QtImporter::QtImporter ( FileName  inputName)

Construct the importer.

Parameters
inputNameThe name of the input image

Definition at line 24 of file QtImporter.cpp.

References Isis::FileName::expanded(), m_qimage, Isis::ImageImporter::setDefaultBands(), Isis::ImageImporter::setLines(), Isis::ImageImporter::setSamples(), and Isis::IException::User.

◆ ~QtImporter()

Isis::QtImporter::~QtImporter ( )
virtual

Destruct the importer.

Definition at line 44 of file QtImporter.cpp.

References m_qimage.

Member Function Documentation

◆ bands()

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

The band dimension (depth) of the output image.

Returns
The band dimension

Definition at line 298 of file ImageImporter.cpp.

References Isis::ImageImporter::m_bands.

Referenced by Isis::ImageImporter::createOutput(), Isis::ImageImporter::getBandChannel(), Isis::ImageImporter::import(), and Isis::JP2Importer::JP2Importer().

◆ convertProjection()

PvlGroup Isis::ImageImporter::convertProjection ( ) const
virtualinherited

Pure virtual method for converting projection information in the file being imported to an ISIS Mapping group.

Returns
An ISIS Mapping group

Reimplemented in Isis::TiffImporter.

Definition at line 66 of file ImageImporter.cpp.

Referenced by Isis::ImageImporter::import().

◆ convertRgbToGray()

int Isis::ImageImporter::convertRgbToGray ( int  pixel) const
protectedvirtualinherited

Convert the current pixel, taken from an RGB/A image, and blend its RGB components into a single grayscale DN.

The three color components are weighted by the following formula:

gray = (red * 11 + green * 16 + blue * 5) / 32

This formula was taken from the Qt documentation on converting an RGB value to grayscale: http://qt-project.org/doc/qt-4.8/qcolor.html#qGray-2

Parameters
pixelThe pixel value to be broken up into RGB components and converted to grayscale
Returns
The grayscale DN value

Definition at line 399 of file ImageImporter.cpp.

References Isis::ImageImporter::getBlue(), Isis::ImageImporter::getGreen(), and Isis::ImageImporter::getRed().

Referenced by Isis::JP2Importer::getGray(), and Isis::TiffImporter::getGray().

◆ createOutput()

Cube * Isis::ImageImporter::createOutput ( FileName  outputName,
CubeAttributeOutput att 
)
protectedinherited

Create the output cube from the given filename and attributes.

Set its dimensions based on those encapsulated by the importer.

Parameters
outputNameThe filename of the output cube
attThe attributes for writing the output cube
Returns
The newly created cube handle devoid of any data

Definition at line 179 of file ImageImporter.cpp.

References Isis::ImageImporter::bands(), Isis::Cube::create(), Isis::FileName::expanded(), Isis::ImageImporter::lines(), Isis::ImageImporter::m_outCube, Isis::ImageImporter::samples(), and Isis::Cube::setDimensions().

Referenced by Isis::ImageImporter::import().

◆ filename()

FileName Isis::ImageImporter::filename ( ) const
inherited

The filename of the input image this instance was constructed with.

Returns
A copy of the input filename

Definition at line 308 of file ImageImporter.cpp.

References Isis::ImageImporter::m_inputName.

Referenced by Isis::JP2Importer::JP2Importer().

◆ fromFileName()

ImageImporter * Isis::ImageImporter::fromFileName ( FileName  inputName)
staticinherited

A static (factory) method for constructing an ImageImporter instance from an input filename.

The specific subclass of the returned instance is determined from the interpreted image format of the input image. Such tests are done by reading a minimal amount of the input data necessary to determine the format. It is the caller's responsibility to delete the importer instance when they are finished with it. Note that deleting the importer will also delete the cube handle returned by the import() method.

Parameters
inputNameThe filename of the input image to be imported
Returns
A pointer to the instantiated importer owned by the caller

Definition at line 420 of file ImageImporter.cpp.

References Isis::FileName::expanded(), and Isis::IException::Programmer.

◆ getAlpha()

int Isis::QtImporter::getAlpha ( int  pixel) const
protectedvirtual

Retrieves the alpha component of the given pixel.

Parameters
pixelRepresentation of a Qt pixel value
Returns
The alpha component

Implements Isis::ImageImporter.

Definition at line 162 of file QtImporter.cpp.

◆ getBandChannel()

ImageImporter::GetChannelMethod Isis::ImageImporter::getBandChannel ( int  band) const
protectedvirtualinherited

Retrieve the method responsible for fetching the color channel from the input image corresponding to the current band out of output being filled.

This will always be the getGray() method for single band output images. For RGB/A images, band 1 will be red, band 2 green, band 3 blue, and band 4 alpha.

Parameters
bandThe current band of the output image
Returns
The method that converts input pixels into the current band's color component

Definition at line 354 of file ImageImporter.cpp.

References Isis::ImageImporter::bands(), Isis::ImageImporter::getAlpha(), Isis::ImageImporter::getBlue(), Isis::ImageImporter::getGray(), Isis::ImageImporter::getGreen(), Isis::ImageImporter::getRed(), and Isis::IException::Programmer.

Referenced by Isis::ImageImporter::operator()().

◆ getBlue()

int Isis::QtImporter::getBlue ( int  pixel) const
protectedvirtual

Retrieves the blue component of the given pixel.

Parameters
pixelRepresentation of a Qt pixel value
Returns
The blue component

Implements Isis::ImageImporter.

Definition at line 150 of file QtImporter.cpp.

◆ getGray()

int Isis::QtImporter::getGray ( int  pixel) const
protectedvirtual

Retrieves the gray component of the given pixel.

Parameters
pixelRepresentation of a Qt pixel value
Returns
The gray component

Implements Isis::ImageImporter.

Definition at line 114 of file QtImporter.cpp.

◆ getGreen()

int Isis::QtImporter::getGreen ( int  pixel) const
protectedvirtual

Retrieves the green component of the given pixel.

Parameters
pixelRepresentation of a Qt pixel value
Returns
The green component

Implements Isis::ImageImporter.

Definition at line 138 of file QtImporter.cpp.

◆ getPixel()

int Isis::QtImporter::getPixel ( int  s,
int  l 
) const
protectedvirtual

Returns a representation of a pixel for the input format that can then be broken down into specific gray or RGB/A components.

Parameters
sThe sample of the desired pixel
lThe line of the desired pixel
Returns
The pixel at the given sample and line of the input with all channel info

Implements Isis::ImageImporter.

Definition at line 102 of file QtImporter.cpp.

References m_qimage.

◆ getRed()

int Isis::QtImporter::getRed ( int  pixel) const
protectedvirtual

Retrieves the red component of the given pixel.

Parameters
pixelRepresentation of a Qt pixel value
Returns
The red component

Implements Isis::ImageImporter.

Definition at line 126 of file QtImporter.cpp.

◆ import() [1/2]

Cube * Isis::ImageImporter::import ( FileName  outputName)
inherited

Import the image with default output attributes.

Parameters
outputNameThe filename of the output cube

Definition at line 108 of file ImageImporter.cpp.

◆ import() [2/2]

Cube * Isis::ImageImporter::import ( FileName  outputName,
CubeAttributeOutput att 
)
inherited

Import the input image this instance was constructed with into the given output Isis cube with the given output attributes.

This will do a black-box import using a ProcessByLine routine. The BandBin group will be updated in the output cube with the names of the color channels included. The output cube will be returned on completion of the import process so the caller can continue to modify the labels. The importer instance will retain ownership of this cube, such that the cube handle will be deallocated upon destruction of the importer.

Parameters
outputNameThe filename of the output cube
attThe attributes for writing the output cube
Returns
A handle on the newly imported Isis cube owned by the importer

Definition at line 129 of file ImageImporter.cpp.

References Isis::PvlObject::addGroup(), Isis::ImageImporter::bands(), Isis::ImageImporter::convertProjection(), Isis::ImageImporter::createOutput(), Isis::ProcessByBrick::EndProcess(), Isis::PvlObject::findObject(), Isis::PvlContainer::keywords(), Isis::Cube::label(), Isis::ProcessByLine::ProcessCubeInPlace(), Isis::IException::Programmer, Isis::ProcessByLine::SetInputCube(), Isis::ProcessByBrick::SetProcessingDirection(), and Isis::Process::WriteHistory().

◆ isArgb()

bool Isis::QtImporter::isArgb ( ) const
virtual

Tests to see if the input image is has an alpha channel, implying RGBA.

Returns
True if the image is RGBA, false otherwise

Implements Isis::ImageImporter.

Definition at line 76 of file QtImporter.cpp.

References m_qimage.

Referenced by isRgb().

◆ isGrayscale()

bool Isis::QtImporter::isGrayscale ( ) const
virtual

Tests to see if the input image is grayscale (no RGB/A).

Returns
True if the image is grayscale, false otherwise

Implements Isis::ImageImporter.

Definition at line 55 of file QtImporter.cpp.

References m_qimage.

Referenced by isRgb().

◆ isRgb()

bool Isis::QtImporter::isRgb ( ) const
virtual

Tests to see if the input image is neither grayscale nor has an alpha channel, implying RGB (no alpha).

Returns
True if the image is RGB, false otherwise

Implements Isis::ImageImporter.

Definition at line 66 of file QtImporter.cpp.

References isArgb(), and isGrayscale().

◆ lines()

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

The line dimension (height) of the output image.

Returns
The line dimension

Definition at line 288 of file ImageImporter.cpp.

References Isis::ImageImporter::m_lines.

Referenced by Isis::ImageImporter::createOutput(), Isis::TiffImporter::getPixel(), and Isis::TiffImporter::TiffImporter().

◆ operator()()

void Isis::ImageImporter::operator() ( Buffer out) const
inherited

The method for processing the output cube in place, called for each line of the output image.

Enables the importer to be used as a functor in a custom ProcessByLine routine, bypassing the black-box import() method entirely. Care should be taken, however, to observe the requirements placed on the structure of such a processing routine by this method. For example, the JP2Importer child requires that the processing proceed in the direction of bands before lines, because its input data is structured in a BIL (band interlaced by line) format.

Parameters
outA reference to a line of output data to be written to

Definition at line 84 of file ImageImporter.cpp.

References Isis::Buffer::Band(), Isis::ImageImporter::getBandChannel(), Isis::ImageImporter::getPixel(), Isis::Buffer::Line(), Isis::Buffer::SampleDimension(), Isis::ImageImporter::testSpecial(), and Isis::ImageImporter::updateRawBuffer().

◆ samples()

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

The sample dimension (width) of the output image.

Returns
The sample dimension

Definition at line 278 of file ImageImporter.cpp.

References Isis::ImageImporter::m_samples.

Referenced by Isis::ImageImporter::createOutput(), Isis::TiffImporter::getPixel(), Isis::JP2Importer::JP2Importer(), and Isis::TiffImporter::TiffImporter().

◆ setBands()

void Isis::ImageImporter::setBands ( int  b)
inherited

Set the band dimension (depth) of the output image.

Because this importer only works on Grayscale, RGB, and RGBA images, possible values are 1, 3, and 4 for the respective color modes.

Parameters
bThe new band dimension

Definition at line 263 of file ImageImporter.cpp.

References Isis::ImageImporter::m_bands, and Isis::IException::Programmer.

Referenced by Isis::JP2Importer::JP2Importer(), and Isis::ImageImporter::setDefaultBands().

◆ setDefaultBands()

void Isis::ImageImporter::setDefaultBands ( )
protectedinherited

Set the number of bands to be created for the output cube based on the number of color channels in the input image.

Definition at line 192 of file ImageImporter.cpp.

References Isis::ImageImporter::isArgb(), Isis::ImageImporter::isGrayscale(), and Isis::ImageImporter::setBands().

Referenced by QtImporter(), and Isis::TiffImporter::TiffImporter().

◆ setHrsRange()

void Isis::ImageImporter::setHrsRange ( double  min,
double  max 
)
inherited

Set the range of DN values within which a pixel from the input image will be set to HRS in the output.

Parameters
minAny DN less than this value will not be set to HRS.
maxAny DN greater than this value will not be set to HRS.

Definition at line 230 of file ImageImporter.cpp.

References Isis::ImageImporter::m_hrsMax, and Isis::ImageImporter::m_hrsMin.

◆ setLines()

void Isis::ImageImporter::setLines ( int  l)
inherited

Set the line dimension (height) of the output image.

Parameters
lThe new line dimension

Definition at line 251 of file ImageImporter.cpp.

References Isis::ImageImporter::m_lines.

Referenced by Isis::JP2Importer::JP2Importer(), QtImporter(), and Isis::TiffImporter::TiffImporter().

◆ setLrsRange()

void Isis::ImageImporter::setLrsRange ( double  min,
double  max 
)
inherited

Set the range of DN values within which a pixel from the input image will be set to LRS in the output.

Parameters
minAny DN less than this value will not be set to LRS.
maxAny DN greater than this value will not be set to LRS.

Definition at line 217 of file ImageImporter.cpp.

References Isis::ImageImporter::m_lrsMax, and Isis::ImageImporter::m_lrsMin.

◆ setNullRange()

void Isis::ImageImporter::setNullRange ( double  min,
double  max 
)
inherited

Set the range of DN values within which a pixel from the input image will be set to Null in the output.

Parameters
minAny DN less than this value will not be set to Null.
maxAny DN greater than this value will not be set to Null.

Definition at line 204 of file ImageImporter.cpp.

References Isis::ImageImporter::m_nullMax, and Isis::ImageImporter::m_nullMin.

◆ setSamples()

void Isis::ImageImporter::setSamples ( int  s)
inherited

Set the sample dimension (width) of the output image.

Parameters
sThe new sample dimension

Definition at line 241 of file ImageImporter.cpp.

References Isis::ImageImporter::m_samples.

Referenced by Isis::JP2Importer::JP2Importer(), QtImporter(), and Isis::TiffImporter::TiffImporter().

◆ testSpecial()

double Isis::ImageImporter::testSpecial ( double  pixel) const
protectedinherited

Tests a pixel against the Null, HRS, and LRS ranges defined by the importer's handler.

Any pixel value falling within one of these ranges will be converted into the given type of special pixel. In case of overlapping ranges, these tests will be performed in the order mentioned at the start of this description. By default, these ranges are set such that all incoming pixels will retain their original values.

Parameters
pixelThe DN value to be tested
Returns
The valid DN or special pixel if it fell within the special ranges

Definition at line 325 of file ImageImporter.cpp.

References Isis::ImageImporter::m_hrsMin, Isis::ImageImporter::m_lrsMin, and Isis::ImageImporter::m_nullMin.

Referenced by Isis::ImageImporter::operator()().

◆ updateRawBuffer()

void Isis::QtImporter::updateRawBuffer ( int  line,
int  band 
) const
protectedvirtual

Does nothing as Qt reads the entire input image into memory, and therefore does not need to be updated throughout the import process.

Parameters
lineCurrent line of the output buffer
bandCurrent band of the output buffer

Implements Isis::ImageImporter.

Definition at line 88 of file QtImporter.cpp.

Member Data Documentation

◆ m_bands

int Isis::ImageImporter::m_bands
privateinherited

The number of bands to be written to the output.

Definition at line 193 of file ImageImporter.h.

Referenced by Isis::ImageImporter::bands(), and Isis::ImageImporter::setBands().

◆ m_hrsMax

double Isis::ImageImporter::m_hrsMax
privateinherited

The upper bound of the range within which input DNs will be made HRS.

Definition at line 211 of file ImageImporter.h.

Referenced by Isis::ImageImporter::ImageImporter(), and Isis::ImageImporter::setHrsRange().

◆ m_hrsMin

double Isis::ImageImporter::m_hrsMin
privateinherited

The lower bound of the range within which input DNs will be made HRS.

Definition at line 208 of file ImageImporter.h.

Referenced by Isis::ImageImporter::ImageImporter(), Isis::ImageImporter::setHrsRange(), and Isis::ImageImporter::testSpecial().

◆ m_inputName

FileName* Isis::ImageImporter::m_inputName
privateinherited

The filename of the input image.

Definition at line 181 of file ImageImporter.h.

Referenced by Isis::ImageImporter::filename(), Isis::ImageImporter::ImageImporter(), and Isis::ImageImporter::~ImageImporter().

◆ m_lines

int Isis::ImageImporter::m_lines
privateinherited

The number of lines to be written to the output.

Definition at line 190 of file ImageImporter.h.

Referenced by Isis::ImageImporter::lines(), and Isis::ImageImporter::setLines().

◆ m_lrsMax

double Isis::ImageImporter::m_lrsMax
privateinherited

The upper bound of the range within which input DNs will be made LRS.

Definition at line 205 of file ImageImporter.h.

Referenced by Isis::ImageImporter::ImageImporter(), and Isis::ImageImporter::setLrsRange().

◆ m_lrsMin

double Isis::ImageImporter::m_lrsMin
privateinherited

The lower bound of the range within which input DNs will be made LRS.

Definition at line 202 of file ImageImporter.h.

Referenced by Isis::ImageImporter::ImageImporter(), Isis::ImageImporter::setLrsRange(), and Isis::ImageImporter::testSpecial().

◆ m_nullMax

double Isis::ImageImporter::m_nullMax
privateinherited

The upper bound of the range within which input DNs will be made Null.

Definition at line 199 of file ImageImporter.h.

Referenced by Isis::ImageImporter::ImageImporter(), and Isis::ImageImporter::setNullRange().

◆ m_nullMin

double Isis::ImageImporter::m_nullMin
privateinherited

The lower bound of the range within which input DNs will be made Null.

Definition at line 196 of file ImageImporter.h.

Referenced by Isis::ImageImporter::ImageImporter(), Isis::ImageImporter::setNullRange(), and Isis::ImageImporter::testSpecial().

◆ m_outCube

Cube* Isis::ImageImporter::m_outCube
privateinherited

The owned handle on the output cube to be imported to.

Definition at line 184 of file ImageImporter.h.

Referenced by Isis::ImageImporter::createOutput(), Isis::ImageImporter::ImageImporter(), and Isis::ImageImporter::~ImageImporter().

◆ m_qimage

QImage* Isis::QtImporter::m_qimage
private

Structure holding all input image data in memory.

Definition at line 60 of file QtImporter.h.

Referenced by getPixel(), isArgb(), isGrayscale(), QtImporter(), and ~QtImporter().

◆ m_samples

int Isis::ImageImporter::m_samples
privateinherited

The number of samples to be written to the output.

Definition at line 187 of file ImageImporter.h.

Referenced by Isis::ImageImporter::samples(), and Isis::ImageImporter::setSamples().


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