Java Doc for JPEGTileCodecDescriptor.java in  » 6.0-JDK-Modules » Java-Advanced-Imaging » javax » media » jai » tilecodec » Java Source Code / Java DocumentationJava Source Code and Java Documentation

This JPEG tile codec works well only on byte type images with 1, 3 or 4 bands.

While both the "tileDecoder" and "tileEncoder" registry modes for the "jpeg" tile codec scheme have the same set of parameters, the parameters for the "tileDecoder" mode are read-only and will be ignored if values are set for them in the TileCodecParameterList passed to the TileDecoder. The reason for this is that the parameter values needed to control the decoding process are included in the encoded stream, therefore parameter values specified externally are ignored. Once the decoding is completed, the parameter values in the TileCodecParameterList are updated to reflect the values specified in the encoded stream.

Resource List

Name	Value
Vendor	com.sun.media.jai
Description	A descriptor to describe the lossy "jpeg" codec scheme.
DocURL	http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/tilecodec/JPEGTileCodecDescriptor.html
Version	1.2
quality	A factor that relates to the desired tradeoff between image quality and the image data compression ratio. The range of this parameter is from 0.0 to 1.0. A setting of 1.0 produces the highest quality image at a lower compression rate. A setting of 0.0 produces the highest compression ratio, with a sacrifice to image quality. The default value is 0.75. In JPEG, compression, there are two ways to control the quantization quality: one is define quantization table for each image component; the other is define the quality. The later overrides the former. If neither the quality nor quantization tables are set, the default setting is used. When the quality is set, a group of quantization tables are generated by rescaling the default quantization tables. For more infomation, please refer to the links below.
qualitySet	A boolean used to indicate that the parameter quality is set or not.
horizontalSubsampling	The subsampling rate in the horizontal direction applied to each image component to reduce their resolution prior to encoding.
verticalSubsampling	The subsampling rate in the vertical direction applied to each image component to reduce their resolution prior to encoding.
quantizationTableMapping	In JPEG compression, several image components may share one quantization table. This is the mapping between the image component and the quantization tables.
quantizationTable0	A quantization table for JPEG codec is an array of 64 (8x8) expressed in zig-zag order (see the JPEG spec section K.1). Since this descriptor defines a JPEG scheme where the tile has at most 4 components, so at most 4 quantization tables will be used. This parameter is the first quantization table.
quantizationTable1	The second quantization table.
quantizationTable2	The third quantization table.
quantizationTable3	The fourth quantization table.
restartInterval	JPEG images use restart markers to define multiple strips or tiles. The restart markers are inserted periodically into the image data to delineate image segments known as restart intervals. To limit the effect of bitstream errors to a single restart interval, JAI provides methods to set the restart interval in JPEG Minimum Coded Units (MCUs). The default is zero (no restart interval markers).
writeImageInfo	A boolean instructs the encoder to write the image data to the output stream.
writeTableInfo	A boolean instructs the encoder to write the table data to the output stream.
writeJFIFHeader	The JPEG File Interchange Format (JFIF) is a minimal file format that enables JPEG bitstreams to be exchanged between a wide variety of platforms and applications. The parameter instructs the encoder to write the output stream in the JFIF format.

Parameter List

Name	Class Type	Default Value
quality	java.lang.Float	0.75
qualitySet	java.lang.Boolean	true
horizontalSubsampling	integer array	{1,1,1}
verticalSubsampling	integer array	{1,1,1}
quantizationTableMapping	integer array	{0,1,1}
quantizationTable0	integer array	The default Luminance table as defined in section K.1 of the JPEG specification.
quantizationTable1	integer array	The default Chrominance table as defined in section K.1 of the JPEG specification.
quantizationTable2	integer array	The default Chrominance table as defined in section K.1 of the JPEG specification.
quantizationTable3	integer array	The default Chrominance table as defined in section K.1 of the JPEG specification.
restartInterval	java.lang.Integer	0
writeImageInfo	java.lang.Boolean	true
writeTableInfo	java.lang.Boolean	true
writeJFIFHeader	java.lang.Boolean	false

If the supplied modeName is one of the valid mode names as ascertained from the getSupportedNames() method, this method returns a TileCodecParameterList that contains values that are compatible for the supplied mode name.
Parameters:
  modeName - The registry mode to return a valid parameter list for.
Parameters:
  otherParamList - The parameter list for which a compatible parameter list for the complementary modeName isto be found.
throws:
  IllegalArgumentException - if modeName is null.
throws:
  IllegalArgumentException - if modeName is notone of the modes valid for this descriptor, i.e those returnedfrom the getSupportedNames() method.
throws:
  IllegalArgumentException - if otherParamList is null.

This method should be used when includesSampleModelInfo() returns false. If includesSampleModelInfo() returns true, the supplied SampleModel is ignored.

For the JPEG codec, includesSampleModelInfo() returns true, so the supplied SampleModel is ignored.
Parameters:
  modeName - The mode to return the default parameters for.
Parameters:
  sm - The SampleModel used to create the default decoding parameter list.
throws:
  IllegalArgumentException - if modeName is null.
throws:
  IllegalArgumentException - if modeName is notone of the modes valid for this descriptor, i.e those returnedfrom the getSupportedNames() method.