FileDocCategorySizeDatePackage
JPEGCodec.javaAPI DocJava SE 5 API5866Fri Aug 26 14:54:40 BST 2005com.sun.image.codec.jpeg

JPEGCodec

public class JPEGCodec extends Object
This class is a factory for implementations of the JPEG Image Decoder/Encoder.

Note that the classes in the com.sun.image.codec.jpeg package are not part of the core Java APIs. They are a part of Sun's JDK and JRE distributions. Although other licensees may choose to distribute these classes, developers cannot depend on their availability in non-Sun implementations. We expect that equivalent functionality will eventually be available in a core API or standard extension.

see
JPEGImageDecoder
see
JPEGImageEncoder

Fields Summary
Constructors Summary
private JPEGCodec()

 
Methods Summary
public static JPEGImageDecodercreateJPEGDecoder(java.io.InputStream src)
This creates an instance of a JPEGImageDecoder that can be used to decode JPEG Data streams.

		return new JPEGImageDecoderImpl(src);
	
public static JPEGImageDecodercreateJPEGDecoder(java.io.InputStream src, JPEGDecodeParam jdp)
This creates an instance of a JPEGImageDecoder that can be used to decode JPEG Data streams.

		return new JPEGImageDecoderImpl(src, jdp);
	
public static JPEGImageEncodercreateJPEGEncoder(java.io.OutputStream dest)
This creates an instance of a JPEGImageEncoder that can be used to encode image data as JPEG Data streams.

		return new JPEGImageEncoderImpl(dest);
	
public static JPEGImageEncodercreateJPEGEncoder(java.io.OutputStream dest, JPEGEncodeParam jep)
This creates an instance of a JPEGImageEncoder that can be used to encode image data as JPEG Data streams.

		return new JPEGImageEncoderImpl(dest, jep);
	
public static JPEGEncodeParamgetDefaultJPEGEncodeParam(java.awt.image.BufferedImage bi)
This is a factory method for creating JPEGEncodeParam objects. The returned object should do a credible job of encoding the given BufferedImage.

param
bi A BufferedImage that is similar to the BufferedImage(s) that will encoded using the returned JPEGEncodeParam object.

  	int colorID = JPEGParam.getDefaultColorId(bi.getColorModel());
  	return getDefaultJPEGEncodeParam(bi.getRaster(), colorID);
	
public static JPEGEncodeParamgetDefaultJPEGEncodeParam(java.awt.image.Raster ras, int colorID)
This is a factory method for creating JPEGEncodeParam objects. It is the users responsiblity to match the colorID with the data contained in the Raster. Failure to do so may lead to either poor compression or poor image quality. If you don't understand much about JPEG it is strongly recommended that you stick to the BufferedImage interface.

param
ras Raster that is similar to those to be encoded later.
param
colorID the COLOR_ID for the encoded data. This should match the data in the raster.

  	JPEGParam ret = new JPEGParam(colorID, ras.getNumBands());
  	ret.setWidth(ras.getWidth());
  	ret.setHeight(ras.getHeight());
	
  	return ret;
	
public static JPEGEncodeParamgetDefaultJPEGEncodeParam(int numBands, int colorID)
This is a factory method for creating JPEGEncodeParam objects. It is the users responsiblity to match the colorID with the given number of bands, which should match the data being encoded. Failure to do so may lead to poor compression and/or poor image quality. If you don't understand much about JPEG it is strongly recommended that you stick to the BufferedImage interface. This can also be used as a factory for a JPEGDecodeParam object. However this usage is extremely rare, as one needs to be decoding abbreviated JPEG streams where the JPEG tables are coming from some source other than a JPEG tables only stream.

param
numBands the number of bands that will be encoded (max of four).
param
colorID the COLOR_ID for the encoded data. This is used to set reasonable defaults in the parameter object. This must match the number of bands given.

  	return new JPEGParam(colorID, numBands);
	
public static JPEGEncodeParamgetDefaultJPEGEncodeParam(JPEGDecodeParam jdp)
This is a factory method for creating a JPEGEncodeParam from a JPEGDecodeParam. This will return a new JPEGEncodeParam object that is initialized from the JPEGDecodeParam object. All major pieces of information will be initialized from the DecodeParam (Markers, Tables, mappings).

param
jdp The JPEGDecodeParam object to copy.

	    return new JPEGParam(jdp);