jj2000.j2k.fileformat.reader

Class FileFormatReader

java.lang.Object

jj2000.j2k.fileformat.reader.FileFormatReader

All Implemented Interfaces:

FileFormatBoxes

public class FileFormatReader
extends Object
implements FileFormatBoxes

This class reads the file format wrapper that may or may not exist around a valid JPEG 2000 codestream. Since no information from the file format is used in the actual decoding, this class simply goes through the file and finds the first valid codestream.

See Also:

FileFormatWriter

Field Summary

Fields

Modifier and Type	Field and Description
private short[]	associations
private int	bitDepth
private byte[]	bitDepths Various bit depth
private short[]	channels Channel definitions
private Vector	codeStreamLength The lengths of the codestreams in the fileformat
private Vector	codeStreamPos The positions of the codestreams in the fileformat
private ColorModel	colorModel Create a IndexColorModel from the palette box if there is one
private int	colorSpaceType Color specification
private int	compressionType
private short[]	comps Component mapping
private byte[]	compSize
private short[]	cType
private int	height
private RandomAccessIO	in The random access from which the file format boxes are read
private int	intelProp
private byte[][]	lut The lut in the palette box
private byte[]	maps
private J2KMetadata	metadata The meta data
private int	numComp
private ICC_Profile	profile ICC profile
private byte[]	type
private int	unknownColor
private int	width Parameters in header box

Fields inherited from interface jj2000.j2k.fileformat.FileFormatBoxes

BITS_PER_COMPONENT_BOX, CAPTURE_RESOLUTION_BOX, CHANNEL_DEFINITION_BOX, COLOUR_SPECIFICATION_BOX, COMPONENT_MAPPING_BOX, CONTIGUOUS_CODESTREAM_BOX, CSB_APPROX, CSB_ENUM_GREY, CSB_ENUM_SRGB, CSB_ENUM_YCC, CSB_METH, CSB_PREC, DEFAULT_DISPLAY_RESOLUTION_BOX, FILE_TYPE_BOX, FT_BR, IMAGE_HEADER_BOX, IMB_C, IMB_IPR, IMB_UnkC, IMB_VERS, INTELLECTUAL_PROPERTY_BOX, JP2_HEADER_BOX, JP2_SIGNATURE_BOX, PALETTE_BOX, RESOLUTION_BOX, URL_BOX, UUID_BOX, UUID_INFO_BOX, UUID_LIST_BOX, XML_BOX

Constructor Summary

Constructors

Constructor and Description
FileFormatReader(RandomAccessIO in, J2KMetadata metadata) The constructor of the FileFormatReader

Method Summary

Methods

Modifier and Type	Method and Description
long[]	getCodeStreamPos() This method creates and returns an array of positions to contiguous codestreams in the file
ColorModel	getColorModel() Returns the color model created from the palette box.
int	getFirstCodeStreamLength() This method returns the length of the first contiguous codestreams in the file
int	getFirstCodeStreamPos() This method returns the position of the first contiguous codestreams in the file
void	readBitsPerComponentBox(int length) Read the bits per component.
void	readChannelDefinitionBox(int length) This method reads the Channel Definition box
void	readColourSpecificationBox(int length) Read the color specifications.
void	readComponentMappingBox(int length) Read the component mapping channel.
boolean	readContiguousCodeStreamBox(int length, long longLength) This method skips the Contiguous codestream box and adds position of contiguous codestream to a vector
void	readFileFormat() This method checks whether the given RandomAccessIO is a valid JP2 file and if so finds the first codestream in the file.
boolean	readFileTypeBox(int length, long longLength) This method reads the File Type box
boolean	readImageHeaderBox(int length) This method reads the Image Header box
void	readIntPropertyBox(int length) This method reads the contents of the Intellectual property box
boolean	readJP2HeaderBox(int length) This method reads the JP2Header box
void	readPaletteBox(int length) This method reads the content of the palette box
void	readResolutionBox(int type, int length) Read the resolution.
void	readURLBox(int length) This method reads the contents of the XML box
void	readUUIDBox(int length) This method reads the contents of the Intellectual property box
void	readUUIDListBox(int length) This method reads the contents of the UUID List box
void	readXMLBox(int length) This method reads the contents of the XML box

Methods inherited from class java.lang.Object

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

Field Detail

in

private RandomAccessIO in

The random access from which the file format boxes are read

codeStreamPos

private Vector codeStreamPos

The positions of the codestreams in the fileformat

codeStreamLength

private Vector codeStreamLength

The lengths of the codestreams in the fileformat

colorModel

private ColorModel colorModel

Create a IndexColorModel from the palette box if there is one

metadata

private J2KMetadata metadata

The meta data

width

private int width

Parameters in header box

height

private int height

numComp

private int numComp

bitDepth

private int bitDepth

compressionType

private int compressionType

unknownColor

private int unknownColor

intelProp

private int intelProp

bitDepths

private byte[] bitDepths

Various bit depth

lut

private byte[][] lut

The lut in the palette box

compSize

private byte[] compSize

comps

private short[] comps

Component mapping

type

private byte[] type

maps

private byte[] maps

channels

private short[] channels

Channel definitions

cType

private short[] cType

associations

private short[] associations

colorSpaceType

private int colorSpaceType

Color specification

profile

private ICC_Profile profile

ICC profile

Constructor Detail

FileFormatReader

public FileFormatReader(RandomAccessIO in,
                J2KMetadata metadata)

The constructor of the FileFormatReader

Parameters:

in - The RandomAccessIO from which to read the file format

Method Detail

readFileFormat

public void readFileFormat()
                    throws IOException,
                           EOFException

This method checks whether the given RandomAccessIO is a valid JP2 file and if so finds the first codestream in the file. Currently, the information in the codestream is not used

Throws:

IOException - If an I/O error ocurred.

EOFException - If end of file is reached

readFileTypeBox

public boolean readFileTypeBox(int length,
                      long longLength)
                        throws IOException,
                               EOFException

This method reads the File Type box

Returns:

false if the File Type box was not found or invalid else true

Throws:

IOException - If an I/O error ocurred.

EOFException - If the end of file was reached

readJP2HeaderBox

public boolean readJP2HeaderBox(int length)
                         throws IOException,
                                EOFException

This method reads the JP2Header box

Parameters:

length - The length of the JP2Header box

Returns:

false if the JP2Header box was not found or invalid else true

Throws:

IOException - If an I/O error ocurred.

EOFException - If the end of file was reached

readImageHeaderBox

public boolean readImageHeaderBox(int length)
                           throws IOException,
                                  EOFException

This method reads the Image Header box

Parameters:

length - The length of the JP2Header box

Returns:

false if the JP2Header box was not found or invalid else true

Throws:

IOException - If an I/O error ocurred.

EOFException - If the end of file was reached

readContiguousCodeStreamBox

public boolean readContiguousCodeStreamBox(int length,
                                  long longLength)
                                    throws IOException,
                                           EOFException

This method skips the Contiguous codestream box and adds position of contiguous codestream to a vector

Parameters:

length - The length of the JP2Header box

longLength - The length of the JP2Header box if greater than 1<<32

Returns:

false if the Contiguous codestream box was not found or invalid else true

Throws:

IOException - If an I/O error ocurred.

EOFException - If the end of file was reached

readIntPropertyBox

public void readIntPropertyBox(int length)
                        throws IOException

This method reads the contents of the Intellectual property box

Throws:

IOException

readXMLBox

public void readXMLBox(int length)
                throws IOException

This method reads the contents of the XML box

Throws:

IOException

readURLBox

public void readURLBox(int length)
                throws IOException

This method reads the contents of the XML box

Throws:

IOException

readUUIDBox

public void readUUIDBox(int length)
                 throws IOException

This method reads the contents of the Intellectual property box

Throws:

IOException

readUUIDListBox

public void readUUIDListBox(int length)
                     throws IOException

This method reads the contents of the UUID List box

Throws:

IOException

readPaletteBox

public void readPaletteBox(int length)
                    throws IOException

This method reads the content of the palette box

Throws:

IOException

readComponentMappingBox

public void readComponentMappingBox(int length)
                             throws IOException

Read the component mapping channel.

Throws:

IOException

readChannelDefinitionBox

public void readChannelDefinitionBox(int length)
                              throws IOException

This method reads the Channel Definition box

Throws:

IOException - If an I/O error ocurred.

readBitsPerComponentBox

public void readBitsPerComponentBox(int length)
                             throws IOException

Read the bits per component.

Throws:

IOException

readColourSpecificationBox

public void readColourSpecificationBox(int length)
                                throws IOException

Read the color specifications.

Throws:

IOException

readResolutionBox

public void readResolutionBox(int type,
                     int length)
                       throws IOException

Read the resolution.

Throws:

IOException

getCodeStreamPos

public long[] getCodeStreamPos()

This method creates and returns an array of positions to contiguous codestreams in the file

Returns:

The positions of the contiguous codestreams in the file

getFirstCodeStreamPos

public int getFirstCodeStreamPos()

This method returns the position of the first contiguous codestreams in the file

Returns:

The position of the first contiguous codestream in the file

getFirstCodeStreamLength

public int getFirstCodeStreamLength()

This method returns the length of the first contiguous codestreams in the file

Returns:

The length of the first contiguous codestream in the file

getColorModel

public ColorModel getColorModel()

Returns the color model created from the palette box.