ucar.jpeg.jj2000.j2k.decoder

Class Grib2JpegDecoder

java.lang.Object

ucar.jpeg.jj2000.j2k.decoder.Grib2JpegDecoder

public class Grib2JpegDecoder
extends Object

This class is the main class of JJ2000's decoder. It instantiates all objects and performs the decoding operations. It then writes the image to an array for use in Grib2 getData routines

First the decoder should be initialized with a ParameterList object given through the constructor. The when the run() method is invoked and the decoder executes. The exit code of the class can be obtained with the getExitCode() method, after the constructor and after the run method. A non-zero value indicates that an error has ocurred.

The decoding chain corresponds to the following sequence of modules:

• BitstreamReaderAgent
• EntropyDecoder
• ROIDeScaler
• Dequantizer
• InverseWT
• ImgDataConverter
• EnumratedColorSpaceMapper, SyccColorSpaceMapper or ICCProfiler
• ComponentDemixer (if needed)
• ImgDataAdapter (if ComponentDemixer is needed)
• ImgWriter
• BlkImgDataSrcImageProducer

The 2 last modules cannot be used at the same time and corresponds respectively to the writing of decoded image into a file or the graphical display of this same image.

The behaviour of each module may be modified according to the current tile-component. All the specifications are kept in modules extending ModuleSpec and accessible through an instance of DecoderSpecs class.

Field Summary

Fields

Modifier and Type	Field and Description
int[]	data the decoded image data

Constructor Summary

Constructors

Constructor and Description
Grib2JpegDecoder(String[] argv) Instantiates a decoder object, width the 'argv' command line arguments.

Method Summary

Methods

Modifier and Type	Method and Description
void	decode(byte[] buf) Runs the decoder.
void	exit() Exit the decoding process according to the isChildProcess variable
static String[][]	getAllParameters() Returns all the parameters used in the decoding chain.
String[]	getCOMInfo() Return the information found in the COM marker segments encountered in the decoded codestream.
int	getExitCode() Returns the exit code of the class.
int[]	getGdata() Return the decoded image as byte array
int	getPackBytes() Return the packBytes ie number bytes / number 1,2 or 4
static String[][]	getParameterInfo() Returns the parameters that are used in this class.
boolean	hasSignedProblem()
void	setChildProcess(boolean b) Set isChildProcess variable.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

data

public int[] data

the decoded image data

Constructor Detail

Grib2JpegDecoder

public Grib2JpegDecoder(String[] argv)

Instantiates a decoder object, width the 'argv' command line arguments. It also initializes the default parameters. If the argument list is empty an IllegalArgumentException is thrown. If an error occurs while parsing the arguments error messages are written to stderr and the run exit code is set to non-zero, see getExitCode()

Throws:

IllegalArgumentException - If 'argv' is empty

See Also:

getExitCode()

Method Detail

getExitCode

public int getExitCode()

Returns the exit code of the class. This is only initialized after the constructor and when the run method returns.

Returns:

The exit code of the constructor and the run() method.

getParameterInfo

public static String[][] getParameterInfo()

Returns the parameters that are used in this class. It returns a 2D String array. Each of the 1D arrays is for a different option, and they have 3 elements. The first element is the option name, the second one is the synopsis and the third one is a long description of what the parameter is. The synopsis or description may be 'null', in which case it is assumed that there is no synopsis or description of the option, respectively.

Returns:

the options name, their synopsis and their explanation.

hasSignedProblem

public boolean hasSignedProblem()

decode

public void decode(byte[] buf)

Runs the decoder. After completion the exit code is set, a non-zero value indicates that an error ocurred.

See Also:

getExitCode()

getPackBytes

public int getPackBytes()

Return the packBytes ie number bytes / number 1,2 or 4

getGdata

public int[] getGdata()

Return the decoded image as byte array

getCOMInfo

public String[] getCOMInfo()

Return the information found in the COM marker segments encountered in the decoded codestream.

getAllParameters

public static String[][] getAllParameters()

Returns all the parameters used in the decoding chain. It calls parameter from each module and store them in one array (one row per parameter and 4 columns).

Returns:

All decoding parameters

See Also:

getParameterInfo()

exit

public void exit()

Exit the decoding process according to the isChildProcess variable

setChildProcess

public void setChildProcess(boolean b)

Set isChildProcess variable.

Parameters:

b - The boolean value