Package gov.nih.mipav.model.file

Class MetadataExtractor.HuffmanTablesDirectory.HuffmanTable

java.lang.Object

gov.nih.mipav.model.file.MetadataExtractor.HuffmanTablesDirectory.HuffmanTable

Enclosing class:

MetadataExtractor.HuffmanTablesDirectory

public class MetadataExtractor.HuffmanTablesDirectory.HuffmanTable
extends Object

An instance of this class holds a JPEG Huffman table.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	MetadataExtractor.HuffmanTablesDirectory.HuffmanTable.HuffmanTableClass

Field Summary

Fields

Modifier and Type	Field	Description
private final byte[]	_lengthBytes
private final int	_tableClass
private final int	_tableDestinationId
private final int	_tableLength
private final byte[]	_valueBytes

Constructor Summary

Constructors

Constructor	Description
HuffmanTable(int tableClass, int tableDestinationId, byte[] lengthBytes, byte[] valueBytes)

Method Summary

Modifier and Type	Method	Description
byte[]	getLengthBytes()
int	getTableClass()
int	getTableDestinationId()
int	getTableLength()
byte[]	getValueBytes()
boolean	isOptimized()	The opposite of isTypical().
boolean	isTypical()	Evaluates whether this table is a "typical" Huffman table.

Methods inherited from class java.lang.Object

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

Field Details

_tableLength

private final int _tableLength

_tableClass

private final int _tableClass

_tableDestinationId

private final int _tableDestinationId

_lengthBytes

private final byte[] _lengthBytes

_valueBytes

private final byte[] _valueBytes

Constructor Details

HuffmanTable

public HuffmanTable(int tableClass,
 int tableDestinationId,
 byte[] lengthBytes,
 byte[] valueBytes)

Method Details

getTableLength

public int getTableLength()

Returns:

The table length in bytes.

getTableClass

public int getTableClass()

Returns:

The MetadataExtractor.HuffmanTablesDirectory.HuffmanTable.HuffmanTableClass of this table.

getTableDestinationId

public int getTableDestinationId()

Returns:

the the destination identifier for this table.

getLengthBytes

public byte[] getLengthBytes()

Returns:

A byte array with the L values for this table.

getValueBytes

public byte[] getValueBytes()

Returns:

A byte array with the V values for this table.

isTypical

public boolean isTypical()

Evaluates whether this table is a "typical" Huffman table.

"Typical" has a special meaning in this context as the JPEG standard (ISO/IEC 10918 or ITU-T T.81) defines 4 Huffman tables that has been developed from the average statistics of a large set of images with 8-bit precision. Using these instead of calculating the optimal Huffman tables for a given image is faster, and is preferred by many hardware encoders and some hardware decoders.

Even though the JPEG standard doesn't define these as "standard tables" and requires a decoder to be able to read any valid Huffman tables, some are in reality limited decoding images using these "typical" tables. Standards like DCF (Design rule for Camera File system) and DLNA (Digital Living Network Alliance) actually requires any compliant JPEG to use only the "typical" Huffman tables.

This is also related to the term "optimized" JPEG. An "optimized" JPEG is a JPEG that doesn't use the "typical" Huffman tables.

Returns:

Whether or not this table is one of the predefined "typical" Huffman tables.

isOptimized

public boolean isOptimized()

The opposite of isTypical().

Returns:

Whether or not this table is "optimized" - which means that it isn't one of the "typical" Huffman tables.